How to accept Bitcoin in Shopify

The following document guides you through setting up BTCPay Server with Shopify (opens new window).

Prerequisites:

• Shopify account
• BTCPay Server] - self-hosted or run by a third-party host v1.4.8 or later.
• Created BTCPay Server store with wallet set up

Setting up BTCPay Server with Shopify

1. In Shopify, go to Apps > and at the bottom of the page click on the Develop apps for your store.
2. If prompted, click on Allow custom app development
3. Create an app and name it
4. On the app page, in Overview tab, click on the Configure Admin API scopes
5. In the filter admin access scopes type in Orders
6. In Orders enable read_orders and write_orders and then click Save
7. Click on the Install App in the top right corner and when pop-up window appears click Install
8. Reveal Admin API access token and copy it.
9. In your BTCPay Server, go to Store > Settings > Integrations > Shopify. and click Setup button.
10. In second field, API Secret Key the paste the Admin API access token
11. In the first field, API key paste the API key from Shopify.
12. In Shopify's Store Settings > Checkout > Order status page > Additional Scripts paste the script provided by BTCPay Server on Shopify Integration page (including the opening and closing tag </script>.
13. In Shopify's Store Settings > Payments > Manual payment methods add manual payment method then click create custom payment method
14. In Custom payment method name fill in Bitcoin with BTCPay Server, optionally you can fill in other fields, but it's not required. Note that the name should exactly Bitcoin with BTCPay Server
15. Hit Activate and you've set up Shopify and BTCPay Server successfully.

TIP

Custom Payment method name must contain at least one of the following words: bitcoin, btcpayserver, btcpay server or btc to work.

Below are step by step visuals describing the process outlined above.