E-Commerce Integrations Shopify

Integrate Bitcoin, USDC, EURC, and Lightning checkouts in your Shopify store. Benefit from direct settlements in fiat or stablecoin

Enhance your Shopify checkout experience by adding cryptocurrency options, including Bitcoin, USDC, EURC, and Lightning, using Whalestack. Enjoy swift exchange, enabling direct settlements in either fiat or your chosen stablecoin.

View Guide
Logo: Shopify

Commercial Benefits

Elevate your Shopify site to new heights with seamless Bitcoin, Lightning, USDC, and EURC sales

Boost Sales and Revenue

Attract and retain a broader customer base within the thriving demographic of crypto and stablecoin enthusiasts who prefer cutting-edge payment methods.

Optimize Conversion Rates

Enhance customer satisfaction by optimizing conversion rates through the implementation of innovative payment methods tailored to specific buyer preferences.

Increase Shopping Cart Values

Capitalize on the opportunity presented by customers using crypto and stablecoins, who often demonstrate a propensity for larger shopping cart values.

Enhance Profit Margins

Boost your profit margins by leveraging the advantages of low transaction fees and the absence of chargebacks, enhancing financial stability and operational efficiency.

Global Reach from Day One

Enjoy built-in multi-currency support and seamless adaptability to diverse languages, ensuring a globally accessible and user-friendly shopping experience for your customers.

Financial Flexibility

Experience financial flexibility with quick and hassle-free access to your crypto and stablecoin earnings, allowing you to reinvest and grow your business at your own pace.

Key Features

Discover how Whalestack effortlessly enhances your Shopify store to achieve its goals

Accept Crypto and Stablecoin Payments

Instant Settlement in Your Preferred Currency

Access 50 Billing Currencies

Eliminate Chargebacks and Control Refunds

Mitigate Currency Volatility Risks

Ensure Seamless Tax Compliance

Set Product Prices in Your National Currency

Customize Checkout Page in Your Preferred Language

Translate the Plugin into Any Required Language

Shopify Extension Installation

Take your Shopify website to new levels by providing payment choices for Bitcoin, cryptocurrencies, and stablecoins. Seamlessly integrate an innovative payment option into your website for selling digital content, services, and products, and accept payments in 50 global currencies effortlessly.

1. Creating a Custom Shopify App

Get Started with Whalestack

to unlock the power of cryptocurrency payments for your website.

Enable Custom App Development

Before you can create a custom app for your store, you need to enable custom app development. Only the store owner can enable custom app development.

  1. From your Shopify admin, navigate to Settings > Apps and sales channels.
  2. Click on Develop apps.
  3. Click Allow custom app development.
  4. Read the provided warning and information, and then click Allow custom app development.

Create Your Custom App

  1. From your Shopify admin, navigate to Settings > Apps and sales channels.
  2. Click on Develop apps.
  3. Click Create an app.
  4. In the modal window, enter the App name (Whalestack) and select an App developer. The app developer can be the store owner or any staff or collaborator account with the Develop apps permission.
  5. Click Create app.

Select API Scopes

  1. In the app that you just created Apps and Sales channels -> Develop apps -> Whalestack, click the Configure Admin API scopes button
  2. Scroll down to the Orders section and activate both write_orders and read_orders.
  3. At the bottom of the page, in the Webhook subscriptions section, choose Latest from the dropdown menu.
  4. Click Save, and then click Install app at the top of the page and confirm it on the modal popup.

Collect API Access Token

  1. In the API credential tab, click on Reveal token once and save it in a secure place.

2. Create a Webhook

Create a Webhook

This webhook is a custom callback event that sends notifications to your Whalestack account.

Create a Shopify webhook for the Whalestack crypto payment method

  1. In your Shopify account, go to Settings -> Notifications.
  2. Scroll to the bottom of the page and find the Webhooks section.
  3. Click Create webhook.
  4. Choose the following parameters in the popup window:
    • Event: Order creation
    • Format: JSON
    • URL: https://www.whalestack.com/api/v1/shopify-order
    • Webhook API version: Choose Latest
  5. Click Save.

3. Create the Whalestack Payment Method

Create a New Crypto Payment Method

This payment method becomes an option in your Shopify store.

Create a Shopify crypto and Bitcoin payment method

  1. In your Shopify account, go to Settings -> Payments.
  2. Scroll down in the list of payment providers to the Manual payment methods section.
  3. Click on the dropdown menu for Manual payment methods and choose Create custom payment method.
  4. Enter the fields in the popup window as follows:
    • Custom payment method name: Enter Whalestack or Bitcoin via Whalestack. Important: You can customize the name to your liking, but it must include the word Whalestack otherwise we will not be able to capture payments. Also, Bitcoin via Whalestack will be easier to understand for your clients than just Whalestack.
    • Additional details: Enter a short description for Whalestack payment method, for example: Pay with Bitcoin and other digital currencies or stablecoins via Whalestack.
    • Payment instructions: These instructions appear on the order confirmation page and should inform shoppers that they will receive an email to make the payment and finalize the order. Example: Check your email inbox now, you will receive instructions to pay this order securely via the Whalestack checkout page.
  5. Click Activate.

4. Customize the Checkout Order Page

Customize the Payment Method Display

  • In your Shopify account, go to Settings -> Checkout.
  • Scroll to the bottom of the page and find the Order status page section.
  • Copy the following Liquid snippet into the textarea:
      {% assign gateway = checkout.transactions[0].gateway | downcase %}
      {% if gateway contains 'whalestack' %}
        <div class="text-container">
            <h2 style="font-weight:bold;color:red">Payment Instructions</h2>
            <p>Please check your email inbox for instructions from <strong>Whalestack // Service</strong> on how to pay this order securely with Bitcoin, Lightning, Litecoin, XLM, USDC, or EURC.</p>
            <p>Powered by <img src="https://www.whalestack.com/images/ws-logo-blue.svg" width="100px"></p>
      {% endif %}
  • Click Save.

5. Connect Shopify with Whalestack

Configure Shopify API Credentials in Whalestack

  1. Log in to your Whalestack account and navigate to the Shopify API settings page.
  2. Fill in the fields as follows:
    • Shopify Store URL: Enter your store URL in the format https://{your-store-name}.myshopify.com.
    • Access Token: Enter the API access token obtained in step 2 (Create a Shopify custom app) of this guide.
    • Webhook Signing Key: Navigate to Settings -> Notifications -> Webhooks. You will find the signing key there.
    • Settlement Asset: The settlement asset in which your account is credited when a checkout completes. Choose "ORIGIN" to be credited in the same asset your customer paid with.
    • Checkout Page Language: The language in which the checkout page, where your customer pays, will be displayed. Choose "auto" to automatically detect the user's language.
  3. Click Submit.

Order Updates and Refunds

Order Confirmation

Upon order confirmation, an email is sent to the user containing a link to securely pay for the order via the Whalestack payment page.

Payment Information

Completed payments will automatically update Shopify orders to Paid.


Manage all payments and refunds in your Whalestack account. You will receive email notifications for every new payment.

White-Label Customization

Payment Page

Customize the checkout page to match your brand's look and feel directly in the Brand Connect settings of your Whalestack account. Configure brand information, images, fonts, colors, and more. Refer to the Brand Connect guide for more details.

Demo Checkout

Integrate Whalestack checkouts alongside traditional payment gateways or as standalone solution

Item Amount
PCI Graphics Card 199.00 EUR
Loyalty Discount (10.00 EUR)
Shipping and Handling (Non-Taxable) 10.00 EUR
Sales Tax (23 %) 43.47 EUR
Total 242.47 EUR
Arrow pointing up

Click to try a checkout...

Key Benefits

Capitalize on the advantages of the Whalestack payment solution

Integrate our crypto payment gateway to expand your customer base and increase revenue. Optimize conversion rates, boost shopping cart values, and enhance profit margins with innovative payment methods. Enjoy global reach and multilingual support, providing a user-friendly shopping experience.

Compliant Accounting

Benefit from exportable financial reports and accurate recording of cryptocurrency transactions in your base currency for enhanced financial transparency.

Risk Protection

Eliminate chargebacks entirely and profit from robust measures to shield your enterprise from the inherent fluctuations in cryptocurrency values, thereby ensuring an effective mitigation of financial risks.

Built-in Automation

Automate with webhooks and programmatically trigger actions based on lifecycle events like checkouts, deposits, transfers, swaps, and refunds.

Auditable Transactions

Efficiently gather and securely retain payment information across various payment methods, with the capability to seamlessly export this data at your convenience.

Assets and Networks

Integrate the most relevant, trusted, and robust crypto and stablecoin assets. Effortlessly exchange and transfer from and to your bank accounts

Crypto Assets
Bitcoin Bitcoin Lightning Lightning Sats Litecoin Litecoin Stellar Lumens Stellar Lumens
Bank Networks
BTC Bitcoin Lightning Lightning Litecoin Litecoin Stellar Stellar Network Ethereum Ethereum
List Assets


Capitalize on new payment transactions and empower your business with seamless blockchain integration


Integrate fully customizable cryptocurrency and stablecoin checkouts with your business.



Build invoices with payment links and receive payment using your web browser or the API.


Blockchain Wallets

Connect your business to Bitcoin, Lightning, Litecoin, USDC, EURC, and Stellar.


Bank Connectivity

Link your SWIFT, SEPA, Brazilian PIX, and other bank accounts with blockchains.


See Also

Whalestack Whale

Try the #1 payment processor for cryptocurrencies and stablecoins.

Book Demo
Space Cat
Space Cat! Meow. 🐱🚀