> For the complete documentation index, see [llms.txt](https://docs.oxapay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oxapay.com/welcome-to-oxapay/integrations/make-automation/shopify.md).

# Shopify

This integration allows you to connect OxaPay with Shopify. By combining OxaPay’s crypto payment gateway with Shopify stores, you can accept cryptocurrency payments, generate payment requests, and automate order processing and payment confirmations in real time.

<div data-with-frame="true"><figure><img src="/files/edVUTsmSiAsRValQxZxs" alt=""><figcaption></figcaption></figure></div>

## What is Shopify? <a href="#what-is-magento-2" id="what-is-magento-2"></a>

Shopify is a leading cloud-based eCommerce platform that enables businesses to build, manage, and scale online stores with minimal infrastructure requirements. It provides a complete set of tools for product and inventory management, checkout and payments, order processing, shipping, and customer experience optimization.

## Key Features of Shopify

1. **Product Management:** Provides flexible tools for creating and managing products, including variants, SKUs, pricing, collections and inventory tracking for efficient catalog control.
2. **Order Management:** Supports the complete order lifecycle (from checkout to fulfillment) with capabilities for order status tracking, shipping labels, refunds, returns (depending on setup/apps), and customizable checkout and delivery options.
3. **Customer Management:** Maintains customer profiles with contact details and order history, supports customer segmentation, and enables personalized experiences through targeted communications and storefront customization.
4. **Marketing and Promotions:** Includes built-in tools for discount codes, automatic discounts, gift cards, abandoned cart recovery, and integrations with major marketing channels such as email, social media, and search platforms through apps and native integrations.
5. **Payments and Security:** Offers secure checkout and payment processing options with features like fraud analysis, SSL encryption, role-based staff access, and compliance support aligned with industry standards for handling transactions.
6. **Performance and Scalability:** Cloud-hosted infrastructure is optimized for reliability and speed, with global CDN support and scalable architecture that can handle growing traffic and product catalogs without requiring server management.

## OxaPay Integration for Shopify (via Make)

Integrating OxaPay with Shopify via Make is an effective way to add cryptocurrency payments to your store without installing a native Shopify app. In this approach, the integration is implemented as an automation workflow that connects the Shopify module with the OxaPay module, enabling your store to create and manage crypto payment requests in a structured, trackable process.

By using Make to orchestrate the integration, you can automate key steps such as generating payment invoices, syncing payment status, and updating order records. This integration provides a modern payment option that can enhance the overall payment experience and support growth in a digital-first marketplace.

## Integrating OxaPay with Shopify Scenario

This integration is built with **three separate** Scenarios:

<table><thead><tr><th width="171.33331298828125"></th><th></th></tr></thead><tbody><tr><td>Scenario 1</td><td>Generate and store Shopify access token every 20 hours</td></tr><tr><td>Scenario 2</td><td>Receive Shopify order, create OxaPay invoice, send invoice email</td></tr><tr><td>Scenario 3</td><td>Receive OxaPay payment webhook and mark Shopify order as Paid</td></tr></tbody></table>

### Before starting, make sure you have:&#xD; <a href="#before-starting-make-sure-you-have" id="before-starting-make-sure-you-have"></a>

* A Shopify store with admin access
* Access to Shopify Dev Dashboard
* Your OxaPay Merchant API Key
* A Make account with access to Data Store

### Step 1 — Create a Shopify App

1. From the Shopify Admin, go to **Settings → Apps → Develop apps → Build apps in Dev Dashboard**. This will open the Shopify Dev Dashboard, where you can manage custom apps for your store. In the Dev Dashboard, create a new app and provide the required app details.

<div data-with-frame="true"><figure><img src="/files/SqCczfnqNW8c7EoguBLp" alt=""><figcaption></figcaption></figure></div>

2. Create a new app version and configure the required settings before releasing it. If the app is not embedded in the Shopify Admin, set the **App URL** to a public URL or use your own n8n/application URL. Set **Embed app in Shopify admin** to **Off** and for the **Webhooks API version**, select the latest available stable Shopify API version, for example `2026-04`.

<div data-with-frame="true"><figure><img src="/files/uGflLmu9kq0uh2U6WJt5" alt=""><figcaption></figcaption></figure></div>

3. Next, add the required **Admin API scopes** for the app. The minimum recommended scopes are `read_orders`, `write_orders`, `read_products` and `read_customers`. After completing the configuration, release the app version so the settings become active.

<div data-with-frame="true"><figure><img src="/files/d5QmCQI4sK2IpMKqM6NA" alt=""><figcaption></figcaption></figure></div>

4. After the app version has been released, install the app on the target Shopify store. In the Shopify Dev Dashboard, open the app and go to **App → Home → Install app**. Select the store where the app should be installed, then review and approve the requested Admin API scopes.

<div data-with-frame="true"><figure><img src="/files/5YASM9XkHpXp8AUjB4sj" alt=""><figcaption></figcaption></figure></div>

5. In the Shopify Dev Dashboard, open the app’s settings page and copy the **Client ID** and **Secret**. These values will be stored in the n8n Data Table and used later during the authentication process.

<div data-with-frame="true"><figure><img src="/files/OEDPhb20Ew70coFFgOUj" alt=""><figcaption></figcaption></figure></div>

> The **Client ID** is used to identify the Shopify app, while the **Secret** is used to request Shopify access tokens. Make sure both values are copied correctly and stored securely, as they are required for generating a valid Admin API access token.

### Step 2 — Create the Make Data Store&#xD; <a href="#step-2-create-the-n8n-data-table" id="step-2-create-the-n8n-data-table"></a>

1. Scenario 1 requires a dedicated place to store the Shopify client credentials, the Shopify store identifier, and the latest generated access token. For this purpose, create a Data Store in Make with the recommended name shopify\_config.
2. Create exactly one record in this data store with four columns: client\_id, secret, shopify\_store, and access\_token. The **Client ID** and **Secret** should be copied from the Shopify Dev Dashboard. The **Shopify Store** field should contain only the **subdomain** without .myshopify.com . The Access Token will be generated and updated by the scenario after the app is installed and authorized.

<table><thead><tr><th width="220.77783203125">client_id</th><th width="208.77777099609375">secret</th><th width="179.4443359375">shopify_store</th><th>access_token</th></tr></thead><tbody><tr><td><code>YOUR_SHOPIFY_CLIENT_ID</code></td><td><code>YOUR_SHOPIFY_SECRET</code></td><td><code>YOUR_SHOPIFY_STORE_SUBDOMAIN</code></td><td><code>Null</code></td></tr></tbody></table>

### Step 3 — scenario 1: Generate Shopify Access Token

1. First, create a new scenario by going to the Make dashboard and clicking the "**Create scenario**" button.

<div data-with-frame="true"><figure><img src="/files/NoQGw5Xp2pbpIODLcegd" alt=""><figcaption></figcaption></figure></div>

2. In the top-right corner, click the three-dot menu, then choose "**Import blueprint"** and upload the downloaded scenario file.

{% file src="/files/YsbLuPRHl4hfBwQiZ0Gi" %}

<div data-with-frame="true"><figure><img src="/files/qAoRd12lZPdieidu5Hlj" alt=""><figcaption></figcaption></figure></div>

3. Now, click on each **module** one by one and complete the required **connection** and configuration steps.

<figure><img src="/files/eF2MaKBFpL1bRnagSQ0U" alt=""><figcaption></figcaption></figure>

4. Once all modules are configured, set Scheduling to 1200 minutes, which equals 20 hours, then click Save to store the scenario.

<div data-with-frame="true"><figure><img src="/files/9D1L620S1OpcRXGBrKpB" alt=""><figcaption></figcaption></figure></div>

5. Now, go to the scenario page you created and click the **Active** button to activate the scenario.

<div data-with-frame="true"><figure><img src="/files/kTIhRIJNizdnJ0S3kvIo" alt=""><figcaption></figcaption></figure></div>

### Step 4 — Scenario 2: Create OxaPay Invoice and Send Shopify Invoice Email <a href="#step-4-workflow-2-create-oxapay-invoice-and-send-shopify-invoice-email" id="step-4-workflow-2-create-oxapay-invoice-and-send-shopify-invoice-email"></a>

Next, download the scenario blueprint provided below and import it into Make, following the same steps used for the previous scenario. After importing the scenario, review and configure each module based on your account settings. Once all module configurations are completed, then click Save and turn on the scenario to ensure it runs properly and can process payment-related events automatically.

{% file src="/files/ygGgWcyOut2uvBFkQwHS" %}

<div data-with-frame="true"><figure><img src="/files/nNiCinkUcdXQsQvqCOD4" alt=""><figcaption></figcaption></figure></div>

### **Step 5 — Create Shopify Order Created Webhook**&#xD;

Shopify must be configured to send new order data to n8n through a webhook. In the Shopify Admin, go to **Settings → Notifications → Webhooks**, then click **Create webhook** to add a new webhook endpoint.

<div data-with-frame="true"><figure><img src="/files/gxpAeExxgtbwDN2m0DWZ" alt=""><figcaption></figcaption></figure></div>

Set the webhook event to Order creation and choose JSON as the data format. In the URL field, paste  the webhook URL generated by the Make Custom Webhook module in Scenario 2.
\\

### Step 6 — Add OxaPay as a Manual Payment Method in Shopify

To allow customers to select OxaPay during checkout, add OxaPay as a custom manual payment method in Shopify. In the Shopify Admin, go to **Settings → Payments**, then find the **Manual payment methods** section and click **Create custom payment method**.

<div data-with-frame="true"><figure><img src="/files/EfS4IHJBVoDd81vM5BJY" alt=""><figcaption></figcaption></figure></div>

Use a clear payment method name, such as **OxaPay Crypto Payment**. In the **Additional details** field, you can explain that customers will pay securely with cryptocurrency through OxaPay and that an invoice email containing the crypto payment link will be sent after the order is placed.

#### Step 7 — Customize the Shopify Order Invoice Email Template&#xD; <a href="#step-7-customize-the-shopify-order-invoice-email-template" id="step-7-customize-the-shopify-order-invoice-email-template"></a>

1. Customize the Shopify **Order invoice** email template so customers can clearly see the OxaPay payment instructions and access the crypto payment link directly. In the Shopify Admin, go to **Settings → Notifications**, then open **Customer notifications → Order invoice** and click **Edit code**.

<div data-with-frame="true"><figure><img src="/files/1bdolDmHSeWji1TZqnW1" alt=""><figcaption></figcaption></figure></div>

2. The invoice email sent by Workflow 2 uses `custom_message`, so the template must include a custom message block to display the OxaPay payment message. Make sure the template contains a Liquid condition such as `{% if custom_message != blank %}` and outputs `{{ custom_message }}` inside the email body. This ensures that the OxaPay payment instructions are shown only when a custom message is provided.

{% code expandable="true" %}

```
custom_message
```

{% endcode %}

3. To connect the **Pay Now** button directly to the OxaPay payment link, replace the default Shopify payment URL variable, `checkout_payment_collection_url`, with `custom_message` in the button link. This allows the customer to click **Pay Now** and be redirected directly to the OxaPay crypto payment page instead of the default Shopify payment collection page.

{% code expandable="true" %}

```
<a href="{{ checkout_payment_collection_url }}">Pay Now</a>

Replace it with:

<a href="{{ custom_message }}">Pay Now</a>
```

{% endcode %}

### Step 8 — Workflow 3: Receive OxaPay Payment Webhook and Mark Shopify Order as Paid

1. Download the ready-made Scenario 3 blueprint and import it into Make by creating a new scenario and selecting Import Blueprint. After importing the scenario, review and configure the required modules based on your account settings. Once all module configurations are completed, click Save and turn on the scenario to ensure it runs properly.

{% file src="/files/ZV53DbAXfJQfgQIPlFbn" %}

<div data-with-frame="true"><figure><img src="/files/iCLQ2dEvnycv54pPPzjg" alt=""><figcaption></figcaption></figure></div>

2. This scenario is responsible for receiving payment status updates from OxaPay. Once OxaPay confirms that a payment has been completed, the scenario continues processing and marks the related Shopify order as Paid.
3. Then copy the webhook URL generated by the Make Custom Webhook module and use it as the callback\_url when creating OxaPay invoices in Scenario 2.

We hope this guide was helpful! The OxaPay integration for Shopify is a powerful solution that enables your store to accept cryptocurrency payments and automate the payment flow, helping you deliver a smoother checkout experience and support your business growth.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oxapay.com/welcome-to-oxapay/integrations/make-automation/shopify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.