Documentation

Accept shielded Zcash payments. Non-custodial. Set up in minutes.

Shopify

If you run a Shopify store, you can accept Zcash payments with CipherPay using a merchant-owned custom app. The app handles invoice creation, shows a payment button on the Thank You page, and updates order statuses when payment is confirmed.

NOTE

Estimated setup time: 15 minutes. You need a CipherPay account, Shopify admin access, and a free Shopify Partner account to create your private app.

How the app works

When a customer selects "Pay with Zcash (ZEC)" at checkout, the app:

1. Creates a CipherPay invoice via the API (with the order total in your store's currency)
2. Displays a "Pay with CipherPay" button on the Thank You page
3. The customer clicks the button and pays by scanning the QR code with their Zcash wallet
4. CipherPay sends a webhook back to the app
5. The app marks the Shopify order as paid automatically

Full setup walkthrough — install, configure, and test a payment in under 5 minutes.

1Create your private Shopify app

Create or log into a free Shopify Partner account, then open the Shopify Dev Dashboard and create a new app. This is a private custom app for your own store — you do not submit it to the Shopify App Store.

App URL — Use https://connect.cipherpay.app temporarily when creating the app. CipherPay will set the final app URL when the checkout block is deployed.
Redirect URL — Use https://connect.cipherpay.app/api/auth/callback.
Scopes — Use read_orders,write_orders.
Embedded app — Leave disabled.

Copy the app's Client ID and Client Secret. Then create a one-time App automation token in the same Dev Dashboard. CipherPay uses these to securely deploy the checkout block to your private app. The automation token is used once and is not stored.

2Deploy and install your private app

Go to CipherPay Dashboard → Settings → Integrations → Shopify. Paste your permanent store domain, Shopify Client ID, Client Secret, one-time App automation token, and CipherPay dashboard token.

CipherPay will create a dedicated restricted API key, configure the webhook URL, and deploy the checkout extension to your private Shopify app. The app version will contain the final App URL and Redirect URL automatically, so you do not need to manually edit the version URLs after deployment.

Next, choose Custom distribution in Shopify and enter your store's permanent .myshopify.com domain. Shopify will generate a private install link for your store.

Open the install link and approve the app. If Shopify shows both a store name and an internal generated domain, use the permanent domain Shopify uses in the install link. You'll be redirected to the CipherPay Shopify settings page.

3Confirm connector settings

After installation, you'll be redirected to the CipherPay Shopify settings page. If setup was completed from the CipherPay dashboard, your API key, webhook secret, and API URL should already be configured.

You only need to edit this page if you are troubleshooting or intentionally replacing the generated restricted API key.

4Add a manual payment method

In your Shopify admin, go to Settings → Payments → Manual payment methods and add a method called exactly:

Pay with Zcash (ZEC)

text

This is the payment option customers will see at checkout. You can add a description like "Pay securely with Zcash cryptocurrency via CipherPay."

5Add the payment button to the Thank You page

The CipherPay button needs to be placed on the checkout Thank You page:

1. Go to Settings → Checkout → Customize
2. In the page selector (top of the editor), switch to Thank you
3. In the left sidebar, click Add block under the Main section
4. Select CipherPay Checkout from the app blocks list
5. Click Save

Shopify Checkout settings — click Customize

Settings → Checkout → Customize

Select Thank you page in the checkout editor

Switch to the "Thank you" page in the dropdown

Click Add block → select CipherPay Checkout

6Test a payment

Add an item to your cart and proceed to checkout. Select "Pay with Zcash (ZEC)" as the payment method and complete the order. On the Thank You page, you'll see a "Pay with CipherPay" button.

Click the button to open the CipherPay payment page. Pay with your Zcash wallet. Once payment is confirmed, the Shopify order will be automatically marked as paid.

Troubleshooting

Payment button doesn't appear on the Thank You page — Make sure you added the CipherPay Checkout block in the checkout editor (Settings → Checkout → Customize → Thank you page) and clicked Save.

Order status doesn't update after payment — Open the CipherPay Shopify settings page and confirm the API key, webhook secret, and API URL are configured.

"Payment not ready" message — This usually means the app is still creating the invoice. Wait a few seconds and try again. If it persists, confirm the connector settings are configured.

Need help? — Contact us at contact@atmospherelabs.dev