Shopify
With the OxaPay Shopify integration, store owners can seamlessly offer cryptocurrency payments to their customers. The integration simplifies payment request creation, tracks transactions in real time, and helps automate order updates once payments are confirmed.
What is Shopify?
Shopify is a cloud-based eCommerce platform that helps businesses create, run, and grow online stores without needing complex technical infrastructure. It offers built-in tools for managing products, inventory, payments, checkout, orders, shipping, and customer interactions, making it easier for merchants to sell products online and manage their store operations efficiently.
Key Features of Shopify
Product Management: Provides flexible tools for creating and managing products, including variants, SKUs, pricing, collections and inventory tracking for efficient catalog control.
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.
Customer Management: Maintains customer profiles with contact details and order history, supports customer segmentation, and enables personalized experiences through targeted communications and storefront customization.
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.
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.
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 n8n
Integrating OxaPay with Shopify via n8n 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 Shopify with OxaPay, allowing your store to create and manage crypto payment requests in a structured and trackable process.
By using n8n to orchestrate the integration, you can automate key steps such as generating payment invoices, syncing payment statuses, and updating order records. This integration provides a modern payment option that can improve the overall checkout experience and support business growth in a digital-first marketplace.
Integrating OxaPay with Shopify Workflow
This integration is built with three separate n8n workflows:
Workflow 1
Generate and store Shopify access token every 20 hours
Workflow 2
Receive Shopify order, create OxaPay invoice, send invoice email
Workflow 3
Receive OxaPay payment webhook and mark Shopify order as Paid
Before starting, make sure you have:
A Shopify store with admin access
Access to Shopify Dev Dashboard
Your OxaPay Merchant API Key
An n8n instance with a public HTTPS URL
Stable production n8n URLs for Shopify and OxaPay webhooks
Step 1 — Create a Shopify App
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.
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.
Next, add the required Admin API scopes for the app. The minimum recommended scopes are
read_orders,write_orders,read_productsandread_customers. After completing the configuration, release the app version so the settings become active.
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.
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.
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 n8n Data Table
Workflow 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 an n8n Data Table with the recommended table name
shopify_config.
Create exactly one record in this table 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 workflow after the app is installed and authorized.
client_id
secret
shopify_store
access_token
YOUR_SHOPIFY_CLIENT_ID
YOUR_SHOPIFY_SECRET
YOUR_SHOPIFY_STORE_SUBDOMAIN
Null
You can also use the CSV file provided below to create or import the Data Table structure more easily. Make sure the table contains only one record, since Workflow 1 will read and update this single row when managing the Shopify access token and store connection details.
Step 3 — Workflow 1: Generate Shopify Access Token
Before importing or configuring the workflow, make sure the OxaPay Community node is installed in your n8n instance. You can install it from the n8n settings by going to Settings, opening Community nodes, selecting Install, entering the package name n8n-nodes-oxapay, and confirming the installation. After installation, the OxaPay node will be available in your n8n node list.
To get started, open your n8n dashboard and create a new workflow by clicking “Create Workflow”.
In the top-right corner of the n8n workflow editor, click the three-dot menu, select “Import from File”, and upload the downloaded workflow JSON file.
Now, open each node in the workflow one by one and complete the required setup steps, including connecting your OxaPay and Shopify credentials, checking the node parameters, and adjusting any values based on your use case.
Now, click Publish in the top-right corner. This will save and activate the workflow so it can start receiving Telegram events.
Step 4 — Workflow 2: Create OxaPay Invoice and Send Shopify Invoice Email
Next, download the workflow provided below and import it into n8n, following the same steps used for the previous workflow. After importing the workflow, review and configure the nodes based on your account settings. Once all node configurations are completed, publish the workflow to ensure it runs properly and can process payment-related events automatically.
Step 5 — Create Shopify Order Created Webhook
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.
Set the webhook event to Order creation and choose JSON as the data format. In the URL field, paste the Production URL from the Webhook node in Workflow 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.
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
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.
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.
To connect the Pay Now button directly to the OxaPay payment link, replace the default Shopify payment URL variable,
checkout_payment_collection_url, withcustom_messagein 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.
Step 8 — Workflow 3: Receive OxaPay Payment Webhook and Mark Shopify Order as Paid
Download the ready-made Workflow 3 file and import it into n8n by going to New Workflow → Import from File. After importing the workflow, review and configure the required nodes. Once all node configurations are completed, publish the workflow to ensure it runs properly.
This workflow is responsible for receiving payment status updates from OxaPay. Once OxaPay confirms that a payment has been completed, the workflow continues processing and marks the related Shopify order as Paid.
Then copy the node’s Production URL and use it as the
callback_urlwhen creating OxaPay invoices in Workflow 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.
Last updated