# 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="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FSF4beDxeLbez0m9oAPx1%2F86ddfecf-4eb6-4df7-9bff-7d68794ace12.png?alt=media&#x26;token=f629fa6b-0619-4a5d-be82-a74b68da014b" 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

In this guide, you can integrate OxaPay with Shopify using a Make automation scenario that connects the OxaPay and Shopify modules.

**You can download the scenario blueprint file below:**

{% file src="<https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FRIV9Ecuw77OkPDGWH7tI%2FShopify%20and%20OxaPay.blueprint.json?alt=media&token=c977a78f-dfbc-424d-b2a2-6393966b2330>" %}

#### **Prerequisites**

* An active **OxaPay** account and a **Merchant API Key**.
* Admin access to your Shopify store (to add a payment method and manage orders).

### **How To Set Up OxaPay for Shopify**

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="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2F8r5RkJ6Rf49S6YqH75g2%2Fimage.png?alt=media&#x26;token=12c541bb-ca3f-4f30-a247-f53c34d1aa9d" 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.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2F6UzQm4cgB5O6LqFgbCY4%2FScreenshot%20(160).png?alt=media&#x26;token=4ff19fef-9d50-49b6-8072-43e7dbf23e85" alt=""><figcaption></figcaption></figure></div>

3. After the scenario is displayed, click the first **Shopify** module to configure it. In the window that opens, click **Create a webhook**.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FCdiGeVmVptWJd1cH0mG4%2FScreenshot%20(177).png?alt=media&#x26;token=b3d4911d-5051-4d69-af08-1b4b29a7da37" alt=""><figcaption></figcaption></figure></div>

4. Next, click **Create a connection** to enter your Shopify store details.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FVqE8cHS0NmyTBooD2CFb%2FScreenshot%20(178).png?alt=media&#x26;token=3b418ebb-1ce3-4ae8-a69b-e198fc03f8bb" alt=""><figcaption></figcaption></figure></div>

5. In the window that opens, set **Connection type** to **Shopify**, then enter your Shopify store details as instructed (**Client ID** and **Client secret** are not required). Make sure to click **Advanced settings**, and under **Scope**, enable **read\_orders** and **write\_orders**. Finally, click **Save**.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FbWKO9Spz8DsuzrF3sfFJ%2FScreenshot%20(180).png?alt=media&#x26;token=7cbd4653-87c8-4239-a18b-1a6e67fd5c01" alt=""><figcaption></figcaption></figure></div>

6. Now in the **Create a webhook** window, set **Event topic** to **Order Created**, then click **Save**.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2Fc81QJdBbIr11JZr77tIE%2FScreenshot%20(181).png?alt=media&#x26;token=e8e74cd5-214a-429f-9999-ea6100a8cafb" alt=""><figcaption></figcaption></figure></div>

7. Now configure the remaining modules. Make sure both **Shopify** modules use the same **Connection**.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FWxjohBFtAY4g5NX42kwp%2FScreenshot%20(182).png?alt=media&#x26;token=af622c69-5445-4be3-b6d7-f1c27d47301d" alt=""><figcaption></figcaption></figure></div>

8. Once all modules are configured, click **Save** to store the scenario. Then go to the scenario page and click **Active** to enable it.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FXv3EjozhNomi62YOfCZx%2FScreenshot%20(165).png?alt=media&#x26;token=a60e9f11-ee7f-4a58-aa02-836684c99ae4" alt=""><figcaption></figcaption></figure></div>

9. To receive real-time payment status updates on your store and automatically update the order payment status, you need to create a separate scenario and import the blueprint file below into a new scenario.

{% file src="<https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FgCuuHsD8OYhedwM79Yje%2FShopify%20and%20OxaPay%20Webhook.blueprint.json?alt=media&token=5f4aa170-dc90-4633-bda3-8813b7c83c45>" %}

10. Now configure the modules, and make sure the connections in this scenario are the same as the connections used in the previous scenario.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FNBxfcPycEvrdKVN16McI%2FScreenshot%20(188).png?alt=media&#x26;token=474219c0-2f03-419b-aa89-63769700c8a3" alt=""><figcaption></figcaption></figure></div>

10. Once all modules are configured, copy the webhook URL from the "**Watch Payment Webhook**" module and add it to the Callback URL of OxaPay module in the previous scenario. Finally, save and activate the scenario.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FeAZcCDWv6Fq6hv3fEfHc%2FScreenshot%20(187).png?alt=media&#x26;token=993f0de9-5626-4231-8e0d-e0fe4af7471c" alt=""><figcaption></figcaption></figure></div>

12. Go to **Settings → Payments** in your Shopify admin. Under **Manual payment methods**, click **Create custom payment method**.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2Fqx06cOWPYXF1d4bmoZRf%2FScreenshot%20(185).png?alt=media&#x26;token=4108c302-6b4a-4bc6-9d8a-064b2c8f9c8a" alt=""><figcaption></figcaption></figure></div>

13. Enter the required information, then click **Activate**. (You can use the same details shown in the image.)

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FyOurfdPbmEu2N9vkbsFg%2FScreenshot%20(186).png?alt=media&#x26;token=98c94320-ff7f-4172-952b-24974d901c27" alt=""><figcaption></figcaption></figure></div>

### OxaPay and Shopify Integration Flow

When a customer places an order in Shopify, the first Make scenario is triggered by the **Order Created** webhook. The scenario generates an OxaPay invoice and then sends a Shopify invoice email to the customer containing the OxaPay **payment URL**.

After the customer completes the payment using the received link, OxaPay sends a real-time payment status update to the second Make scenario (Webhook). If the payment status is **Paid**, the scenario automatically marks the corresponding Shopify order as paid.

### Customize the Shopify Order Invoice Email Template

For a cleaner invoice layout and a better customer UI, **OxaPay recommends customizing the Shopify “Order invoice” email template** by applying the HTML/Liquid content provided in the integration package.

**Download the HTML/Liquid template file below:**

{% file src="<https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2Fda7Y852JqNqGIbLdxM8D%2FOrder%20Invoice%20Notification.html?alt=media&token=d38577b0-82dd-41c0-aef9-4ddf8dd22bb6>" %}

1. Log in to **Shopify Admin** and go to **Settings → Notifications**.
2. Under **Customer notifications**, open **Order invoice** (in the *Order exceptions* section).
3. Click **Edit code**.
4. Replace the template with the content of the provided **HTML/Liquid** file.
5. Click **Save**, then **preview** or **send a test email** to confirm the final appearance.

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.