Accept Bitcoin in Shopify with BTCPay Server

Introducing BTCPay Server for Shopify – open-source payment gateway that enables you accept bitcoin payments directly on your website or stores from customers with no fee.

Our integration with Shopify allows you connect your self-hosted BTCPay Server with your Shopify store, enabling you accept Bitcoin payments swiftly and securely.

:::warning

⚠️ Shopify V1 Integration Deprecated

New users can no longer use the Shopify V1 integration with BTCPay Server. Please refer to the Shopify V2 integration guide for instructions on setting up BTCPay Server with Shopify. Existing users experiencing issues with the V1 integration are encouraged to open an issue on our Github repository or report them via Mattermost or Telegram, and plan a migration to V2. :::

What BTCPay offers:

Zero fees: Enjoy a payment gateway with no fees. Yes, You saw that right. Zero fees!
Direct payment, No middlemen or KYC: Say goodbye to intermediaries and tedious paperwork, and get your money directly in your wallet
Fully automated system: BTCPay takes care of payments, invoice management and refunds automatically.
Display Bitcoin QR code at checkout: Enhance customer experience with an easy and secure payment option.
Self-hosted infrastructure: Maintain full control over your payment gateway.
Lightning Network integrated: Instant, fast and low cost payments and payouts
Easy CSV exports
Versatile plugin system: Extend functionality according to your needs
Point-of-sale integration – Accept payments in your physical shops
Multilingual ready: Serve a global audience right out of the box.
Community-driven support: Get responsive assistance from our dedicated community (Mattermost or Telegram).

Prerequisites:

Before diving into the setup process, ensure you have the following:

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

In Shopify, click on Apps > in the left sidebar
On the modal popped up, click on App and sales channel settings
From the page displayed, click on Develop apps button
If prompted, click on Allow custom app development
Create an app and name it, e.g. BTCPay Server
On the app page, in Overview tab, click on the Configure Admin API scopes
In the filter admin access scopes type in Orders
In Orders enable read_orders and write_orders and then click Save
Click on the Install App in the top right corner and when pop-up window appears click Install
Reveal Admin API access token and copy it
In your BTCPay Server, go to your store and on the left sidebar click on Shopify
In the first field, Shop name enter the subdomain of your Shopify store e.g. SOME_ID.myshopify.com then enter SOME_ID
In third field, Admin API access token paste the Admin API access token you just copied from Shopify
In the second field, API key paste the API key from Shopify - which you can find at the bottom of the same page where you copied the Admin API access token
Click Save on BTCPay Shopify settings page
Back on Shopify: On left menu select Checkout scroll down to "Order status page" and paste the HTML <script> code you see in BTCPay Shopify settings into the "Additional scripts" text field.
Click Save and scroll back up to the top
Now click on Payments in the left sidebar, scroll down to "Manual payment methods", click on (+) Manual payment method and select Create custom payment method on the dropdown.
In Custom payment method name fill in Bitcoin with BTCPay Server, optionally you can fill in other fields, but it's not required.
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 (case-insensitive): bitcoin, btcpayserver, btcpay server or btc to work. :::

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