Shopify
This page describes how to install and configure Zapper as a payment provider for the Shopify eCommerce platform.
Overview
Shopify
Shopify, a dynamic and user-friendly eCommerce platform, empowers businesses with its streamlined approach to online retail. Leveraging a range of built-in functionalities and customizable themes, Shopify eliminates the complexities of setting up an online store. With an array of apps and integrations available in the Shopify App Store, you can effortlessly enhance your store's capabilities, tailoring it to your unique business needs. This all-inclusive approach ensures that Shopify equips you with the fundamental features anticipated from an eCommerce platform right from the start, simplifying your journey to online success.
Zapper Payments Plugin
The Zapper payment provider for Shopify offers a seamless and versatile payment experience. Customers can pay using:
Dynamic QR Code – Scan the QR code with the Zapper mobile app.
Credit or Debit Cards – Enter card details securely during checkout.
Pay with Bank – Select your bank and log in to complete the payment.
This flexibility enhances the customer experience by accommodating a range of payment preferences.
The Zapper payment provider for Shopify offers a seamless payment experience, catering to a wider range of customer preferences. With our enhanced system, customers now have the option to make payments using their credit or debit cards, pay with bank in addition to our existing dynamic QR code solution. This means that during checkout, customers can either choose to scan the dynamic QR code using the Zapper app, directly enter their card details or pay with bank to complete their order payment. This versatility ensures a convenient and efficient payment process for all customers, making their shopping experience even more enjoyable. Learn more about the payments flow here.
This guide is composed of the following sections:
Pre-requisites - The pre-requisites required before the Zapper payment method can be used in production.
Installation - Installation and configuration of the Zapper payment method.
Checkout and Payments - The customer experience when making use of the Zapper payment method.
Pre-requisites
Before enabling the Zapper Payments Plugin on your Shopify store, ensure the following requirements are met:
Zapper Merchant Account – You must have a valid Zapper merchant account and be able to log in to Zapper merchant portal..
API Credentials – Obtain your Zapper API key, Merchant ID and Site ID.
Shopify Store Access – Ensure you have admin-level access to your Shopify store.
Payment Gateway Settings – Ensure third-party payment providers are enabled in Shopify.
The merchant must be registered as a Zapper Merchant to use the Zapper plugin in production.
The merchant must be able to log in to the Zapper Merchant Portal.
Installation
To install the Zapper payment method on your Shopify Store, complete the following steps:
Navigate to https://apps.shopify.com/zapper
Select "Install"
Login to your Shopify Store
Follow the Shopify prompts to install the Zapper application:
Zapper app requesting permission to edit payment sessions and payment gateways The merchant will be redirected to Zapper's Merchant Portal and prompted to sign into a merchant account:
Select a Zapper site from the dropdown and click "Link site":
The merchant will be redirected to the Shopify store to activate the Zapper payment method.
Checkout and Payments
This section describes the user experience when checking out and making a payment using the Zapper payment method.
Checkout
On Checkout the user will be provided with Zapper as a payment provider option. The following image is a snippet of the payment options on the Shopify checkout page:
Payments
The payment process is as follows:
When the user selects the Zapper payment option on checkout and proceeds to finalize their order, they will be presented with Zapper Hosted Payment page.
If the user prefers the familiar convenience of our dynamic QR code solution, they can proceed by using the Zapper mobile app to effortlessly scan the on-screen QR Code. For users accessing the store from a mobile device, the QR Code is seamlessly replaced with a deep-link button, ensuring a smooth transition to the Zapper application.
If the user prefers to use their credit or debit card for payment, they can opt for the card payment option. This straightforward method allows users to directly input their card details and complete the payment process right on the spot.
However, if user prefers payments made directly from their bank account they can select pay with bank.
Once the payment is successfully processed – whether through QR code scanning, card payment or pay with bank – users will receive a confirmation in the form of a checkmark symbol. With this assurance of payment, they will then be seamlessly redirected back to the store's default payment confirmation page. If the payment fails, users will have the opportunity to retry or select a different payment method.
If a payment attempt fails:
Customers are prompted to retry using the same method or switch to an alternative method.
Failed transactions are logged and can be reviewed in the Zapper merchant dashboard and Shopify order history.
By introducing card payment option and pay by bank alongside our existing QR code solution, we're committed to delivering a more inclusive and user-friendly payment experience that caters to a diverse range of customer preferences.
Zapper Plugin for Shopify – Troubleshooting Guide & FAQs
Common Troubleshooting Steps
1. Plugin Not Displaying at Checkout
Cause: Zapper may not be enabled as a payment method in Shopify admin.
Fix:
Go to Shopify Admin > Settings > Payments.
Ensure Zapper is selected and enabled.
Click Manage, and confirm configurations are correct.
2. Transactions Not Showing in Zapper Dashboard
Cause: Callback/notification URL might be incorrect or unreachable.
Fix:
Ensure your Shopify store URL is correct in the Zapper Merchant Portal.
Make sure HTTPS is enabled and accessible for your store.
Check that firewall or app blocking isn’t interfering with callbacks.
3. Payment Fails After Scanning QR Code
Cause: Invalid credentials or expired QR session.
Fix:
Confirm your Merchant ID, Site ID and API key are correct in the plugin config.
Re-authenticate via Zapper’s onboarding or re-install the plugin.
4. Orders Paid but Still Marked as Pending
Cause: Shopify didn’t receive the payment confirmation webhook.
Fix:
Check webhook delivery logs in Zapper’s Merchant Dashboard.
Confirm the webhook matches between Zapper and Shopify plugin config.
Frequently Asked Questions (FAQs)
How do I install the Zapper plugin on Shopify?
Go to Shopify App Store and search for Zapper Payments.
Click Install and follow the onboarding wizard.
Enter your Zapper Merchant ID and API Key from your Zapper Merchant Portal.
Activate Zapper under Payments > Third-party providers.
What do I need before installing the plugin?
A verified Zapper merchant account.
API and merchant credentials (available in your Merchant Portal).
Shopify store with HTTPS enabled.
Can I test the Zapper plugin in sandbox mode?
You can request a test merchant profile from Zapper support for testing.
What does a successful Zapper payment look like?
Customer scans a QR → Confirms on their phone → Redirects to success page.
The order in Shopify is marked as Paid and completed as usual.
Who do I contact for Zapper plugin support?
Email: support@zapper.com
Include your store URL, Merchant ID, and a brief issue summary.
Last updated
Was this helpful?