Setup your Shopify store

Good to know: we currently support Shopify and WooCommerce. We have other platforms and a REST API and SDK on our roadmap to make it easier to integrate KuPay into your webshop or application. Contact us if you have a special request.

Requirements/ limitations:

  1. 1.
    Requires a KuPay merchant account. Apply now at​
  2. 2.
    Currently works with KuCoin Community Chain (KCC) and Binance Smart Chain (BSC) for our Checkout product, and many more chains for donations and payments.
  3. 3.
    Only works with USD currency at the moment. Please contact us to request another currency.
  4. 4.
    Only in English language


  1. 1.
    Create a new Shopify shop (if you haven’t already)
  2. 2.
    Sign up for a new Merchant account on​
    1. 1.
      Details of your shop (name, URL etc.)
    2. 2.
      Wallet address (0x....)
  3. 3.
    We generate a webhook address for you, that you need to add to Shopify, see below
  4. 4.
    Setup a custom payment method, see below
  5. 5.
    Add custom code to the checkout page (optional, but recommended)
  6. 6.
    Create a custom app to get updates from KuPay about the payment status


Prerequisites: - You will need the webhook address that is generated in your merchant account on​
Visit https://<your shop> Settings > Notifications (scroll to the bottom of the page)
Add webhook to Shopify under notifications to send every new order here Webhook<YOUR_MERCHANT_ID> Eg.
Be sure to use the settings exactly like this:
Event: Order creation
Format: JSON
URL: You can find this in your account information
Webhook API version: 2021-10
Click Save

Add a new custom payment method

Add a new custom payment method, and name it KuPay
  1. 1.
    In Shopify visit Settings > Payments Note: only the owner of the Shopify store can do this!
  2. 2.
    Scroll down to Manual payment methods
  3. 3.
    Click on Create custom payment method in the dropdown list
  4. 4.
    Type KuPay (the name is important and cannot be changed later)
  5. 5.
    Make sure to have the word KuPay in the name because you need it and cannot change it later.
  6. 6.
    Click Manage to update the payment method and add more details to describe the payment method.
  7. 7.
    Additional details are displayed on the check out page, for example: Pay with KCS and other digital KCC currencies via KuPay for super low transaction fees and fast transaction speed.
  8. 8.
    Payment instructions are displayed on the status/thank you page, for example: Please pay via the button above. We have also sent you the link by email.

Add custom code to the checkout page

While this is not strictly required, we do recommend adding the code, to optimize the customer experience. This code will load a payment button directly on the thank you page. Without this code, the customer will have to click the link in the email they receive, which will be a little bit less likely to convert (eg. if the email goes to spam somehow, or the customer changes their mind).
  1. 1.
    In Shopify visit Settings > Checkout
  2. 2.
    Scroll to the bottom where it says “Additional scripts”
  3. 3.
    In the box “Order status page” you can add the following 2 lines of code:
<div id="kupay-shopify-status" class="content-box" style="margin-top:3em"></div>
<script src="{{checkout.order.order_number}}&order_id={{checkout.order_id}}"></script>
It should look like this on the status/thank you page:
If your status/thank you page is not dark but using a light theme, please contact our support to give you instructions.

Create a custom app (coming soon!)

In the Shopify admin panel, click on Apps > Develop apps
or visit https://<your-shop>
Click on Create app
App name: backend app
Configuration -- Admin API access scopes: write_order_edits, read_order_edits, write_orders, read_orders, write_third_party_fulfillment_orders, read_third_party_fulfillment_orders, read_reports, write_fulfillments, read_fulfillments -- click Save
Webhook version: 2022-01
Click Install app
Visit the API credentials -- View the Admin API access token and store it in a safe place (you can only view it once)
>> This access token needs to be entered on the merchant panel