Shopify custom app

Integration model

The Shopify integration uses the same custom-app/manual-payment pattern many crypto gateways use for Shopify stores. The merchant creates a private Shopify custom app, gives it the minimum Admin API order permissions, connects the token inside MakeCrypto, then adds a manual MakePay payment method named Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others.

MakePay watches matching Shopify orders, creates a hosted MakePay checkout link, writes the payment link into the order note, and can mark the Shopify order paid after MakePay confirms settlement.

For the best customer flow, install the MakePay Shopify app and add the MakePay block to both Shopify Thank You and Order Status pages. The block displays a Pay now button after the order is confirmed and sends the customer to hosted MakePay checkout.

Shopify custom app

In Shopify admin, create a custom app for the store and configure Admin API access. Required scopes:

• read_orders
• write_orders
• read_draft_orders
• write_draft_orders
• read_customers
• read_products
• write_products

Install the custom app, reveal the Admin API access token once, and keep the API secret available for webhook signature verification.

MakeCrypto connection

Open MakeCrypto, choose the company, then go to E-commerce > Shopify. Add a store with:

• Shopify store slug, which is the part before .myshopify.com, such as example for example.myshopify.com
• Admin API access token
• API secret
• manual payment method name

The credentials are encrypted at rest. MakePay stores only a token preview, webhook health, sync status, recent request logs, and order sync metadata. The public storefront URL is discovered from Shopify after a successful connection test when Shopify exposes it.

To find the store slug, open Shopify admin, go to Settings > Domains, and copy the part before .myshopify.com from the permanent Shopify-managed domain. Enter only the slug in MakePay; the .myshopify.com suffix is added for you.

To find the app credentials, open Settings > Apps and sales channels > Develop apps, create or open the custom app, configure the Admin API scopes, install the app, reveal the Admin API access token once, and copy the API secret key from the app credentials page.

Thank You Pay now block

After the store is connected, install the MakePay Shopify app from the installation link shown in MakeCrypto when available. Then open Shopify admin and go to Online Store > Themes > Customize. In the template selector, choose Checkout and customer accounts, then Thank you. Add the MakePay app block and save the template. Repeat the same process for the Order status page so returning customers can also complete payment from their order page.

The MakePay block verifies Shopify's session token, asks MakeCrypto for the matching payment link, and displays a Pay now button. If the order webhook is still being processed, the block waits briefly while MakePay prepares the link. The block never exposes Shopify API tokens or merchant secrets to the browser.

Manual payment method

In Shopify admin, open Settings > Payments > Manual payment methods and create a custom payment method. Its name must exactly match the MakeCrypto connection payment method name. New MakePay connections default to:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

When customers choose that method, Shopify creates the order as unpaid. The MakePay sync then attaches the hosted checkout URL to the order note and can send a MakePay payment request email when enabled.

Webhooks and sync

Use Register webhooks on the MakeCrypto Shopify connection after saving the store. MakeCrypto subscribes the custom app to order create/update events and app uninstall events. A scheduled sync also checks recently connected stores, so orders are still picked up if Shopify webhook delivery is delayed.

Incoming Shopify webhook signatures are verified before the payload is accepted. Request and webhook logs are kept on the connection page for troubleshooting.

Status mapping

When a Shopify order is pending through the MakePay manual payment method, MakePay creates or reuses a MakePay payment link for the order total and customer email.

When the MakePay payment reaches complete, MakePay adds a paid note/tag and uses Shopify Admin API orderMarkAsPaid when auto-mark-paid is enabled.

When a MakePay payment reaches failed, expired, or cancelled, MakePay adds a status note and leaves the Shopify order unpaid for merchant review.

Troubleshooting

If Test connection fails, verify the store slug belongs to the permanent myshopify.com domain and that the token still has the required order, draft-order, customer, and product scopes.

If orders are not detected, check that the Shopify manual payment method name matches the MakePay connection exactly and trigger Sync now.

If webhooks show failed signatures, copy the current API secret from the Shopify custom app into MakeCrypto and register webhooks again.

If the Pay now block stays in preparing state, confirm that the MakePay block is installed on the Thank You template, network access is enabled for the Shopify extension, and the Shopify order uses the exact manual payment method name.