Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

WooCommerce (Wordpress)

This page describes how to install and configure Zapper as a payment method on the Wordpress (Woocommerce) eCommerce platform.

Overview

Wordpress and Woocommerce

WordPress and WooCommerce together create a versatile and customizable eCommerce solution that puts you in control of your online business. Utilizing the power of WordPress as a flexible Content Management System, and bolstered by the comprehensive features of the WooCommerce plugin, you can effortlessly establish your digital store. With an extensive range of themes, plugins, and integrations at your disposal, you can tailor your eCommerce site to perfectly suit your brand and offerings. This cohesive combination simplifies the process of building and managing an online store, ensuring you have access to the essential tools and capabilities required for eCommerce success, all from the outset of your journey.

Zapper Payments Plugin

The Zapper Payments plugin for WordPress extends Woocommerce's payment gateway options, now including Bank payment and card payment feature alongside our existing dynamic QR code solution. This means customers can conveniently choose between scanning a QR code using the Zapper app, directly entering their card details or bank payment during checkout. This versatile approach ensures a seamless payment experience, catering to a range of preferences and enhancing the overall shopping journey. Learn more about the payments flow here.

This guide is composed of the following sections:

  1. Pre-requisites - The pre-requisites required before the Zapper payment method can be used in production.

  2. Installation - Downloading and installation of the Zapper payment method.

  3. Configuration - Configuration of the Zapper Payment method with the merchant's Zapper credentials.

  4. Checkout and Payments - The customer experience when making use of the Zapper payment method.

Pre-requisites

  1. The merchant must be registered as a Zapper Merchant to use the Zapper plugin in production. (sandbox mode does not require credentials)

  2. Verify that the required Wordpress and PHP versions are met.

  3. The merchant must be able to log in to the Zapper Merchant Portal.

  4. The merchant must have access to the email address that was used during the Zapper registration.

Installation

The Zapper Wordpress plugin is available from: https://wordpress.org/plugins/zapper-payments. Installation is the same as any other standard Wordpress plugin, i.e. on the Admin page proceed as follows:

  1. Go to Plugins->Add New

  2. Search for "Zapper Payments" (by Zapper Development)

  3. Click "Install Now"

Configuration

After Zapper has been installed and activated, find Zapper Payments in the list of installed plugins and select "Settings". The plugin can be configured for sandbox or production as described in the following sections.

Sandbox

To make payments in sandbox mode, the Zapper mobile app must be configured to use a test card.

Configure Mobile Device for Test Payments:

  1. Open the Zapper mobile app.

  2. Navigate to Payment Methods and select "Add Card".

  3. Enter a valid test credit card number (e.g., 4000 0000 0000 0002).

  4. Enter any future expiry date and CVC.

  5. Enter any name in the "Name on Card" field.

  6. Click "Save".

Configure Zapper Plugin

To use the Zapper plugin in sandbox mode, configure the plugin as follows:

  1. Enable the plugin

  2. Enable Sandbox Mode

  3. Click the [Save Changes] button

Zapper Plugin Enable Sandbox

Production

Once installed, find Zapper Payments in the list of installed plugins and select "Settings", then configure the plugin as follows:

  1. Enable the plugin.

  2. Ensure Sandbox Mode is NOT enabled.

  3. Enter the Merchant and Site ID's.

  4. Click on the "Request OTP" button to have an OTP emailed to the Zapper Merchant email address.

  5. Enter the "OTP" (a.k.a "Verification Code") received in the email and click "Submit OTP".

  6. Click the "Save Changes" button

Zapper Plugin Configuration Complete

The OTP process may be bypassed by using the "Manual Token Entry". If this option is used, It is up to the merchant to ensure that the token is correct.

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 method as shown in the image below:

Checkout page may differ based on the theme.

Zapper Payment Option on Checkout

Payments

The payment process is as follows:

  1. 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.

  2. 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.

  3. If the user prefers to use their credit or debit card for payment, they can now 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.

  4. However, if user prefers payments made directly from their bank account they can select pay with bank.

  5. 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.

By introducing this new card payment option 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 Payment Gateway - Desktop Pay with QR
Zapper Payment Gateway - Desktop Pay with Card
Zapper Payment Gateway - Desktop Pay with Bank
Zapper Payment Gateway - Desktop Successful Payment
Zapper Payment Gateway - Mobile Payment Methods
Zapper Payment Gateway - Mobile Card Payment
Zapper Payment Gateway - Mobile Pay by Bank

The order on the merchants store will automatically be updated with payment complete.

Troubleshooting Steps: Zapper for WooCommerce

1. Zapper is not displaying as a payment method at checkout

  • Ensure the plugin is enabled under WooCommerce > Settings > Payments > Zapper.

  • Check if API Key, Merchant ID and Site ID are configured correctly.

  • Confirm you’re in the correct environment (sandbox vs production).

2. Payments not redirecting to Zapper or showing blank page

  • Check site SSL certificate is valid — Zapper requires HTTPS.

3. Plugin conflicts

  • Disable other payment plugins that may interfere and test again.

  • Reinstall the plugin.

4. Currency or country compatibility issues

  • Zapper may support specific currencies (e.g. ZAR)—make sure your store currency is supported.

  • Confirm your WooCommerce store's base location is supported by Zapper.

Frequently Asked Questions (FAQs)

1: What is required to activate the plugin?

  • You’ll need a Zapper merchant account, a Merchant ID, Site ID and API Key.

2: Can I test the plugin before going live?

  • Yes, Zapper offers a sandbox/test mode. Use test credentials from Zapper and enable test mode in the plugin settings.

3: Where can I find the logs for Zapper transactions?

  • Go to WooCommerce > Status > Logs, and select zapper-woocommerce from the dropdown.

4: How do I update the plugin safely?

  • Backup your site before updates.

5: Is Zapper compatible with subscriptions or recurring payments?

  • The standard plugin does not support recurring payments.

PreviousShopifyNextEcwid

Last updated

Was this helpful?