Payment Gateway for ZainPay for WooCommerce

Accept secure online payments in Nigeria and beyond with ZainPay, directly from your WooCommerce store.
This plugin connects your store to ZainPay, allowing customers to pay with their cards and local payment methods, while you receive automatic order updates and detailed payment logs.

Key Features

• Seamless WooCommerce Integration
  Works like any native WooCommerce gateway – customers select “ZainPay” at checkout and complete payment without leaving your store flow.
• Redirect and Popup/Inline Payments
  • Redirect: Send customers to ZainPay’s secure hosted page to make payments.
  • Popup / Inline: Open a payment popup directly on your checkout page for a smoother experience.
• Automatic Order Status Updates
  • Successful payments move orders to the correct status (processing/completed).
  • Failed or cancelled payments are clearly marked so you always know what happened.
• Webhook & Callback Handling
  • Secure webhook verification with HMAC (Zainpay-Signature header).
  • Handles both callback redirects and background webhooks to keep orders in sync even if the customer closes the payment window.
• Inline Metadata & Extra Info
  Optionally send additional metadata with each transaction, such as:
  • WooCommerce order ID
  • Customer name
  • Email address
  • Phone number. This helps you reconcile transactions easily from the ZainPay dashboard.
• Saved Cards (Tokenization) Ready
  Support for charging via saved cards (card data is stored by ZainPay, not on your server) so returning customers can pay faster.
• WooCommerce Blocks (Cart & Checkout) Support
  Compatible with the new WooCommerce Blocks checkout experience via a dedicated integration class and JS assets.
• Developer‑Friendly Logging & Debugging
  • Optional debug mode that logs to WooCommerce’s built‑in logger.
  • Detailed logs for initialization, callbacks, verification responses, and errors to help diagnose any edge cases.
• Security‑First Design
  • Nonces on all AJAX endpoints.
  • Sanitization and validation of incoming data.
  • Webhook signature validation with a secret key per environment.
  • No card details are stored on your server; all sensitive handling is done by ZainPay.

How It Works

At checkout, the customer selects ZainPay as the payment method. The plugin then sends the order details, such as amount, currency, and customer information, to ZainPay to start the transaction.

The customer then completes the payment either on a secure ZainPay-hosted page (via a redirect) or through an inline popup on the checkout page. Once payment is made, ZainPay notifies your store via callback or webhook.

The plugin then verifies the transaction automatically and updates the WooCommerce order status (successful, pending, failed, or cancelled). Stock levels can also be reduced automatically if enabled.

Requirements

• WordPress with a working SSL (HTTPS) site
• WooCommerce installed and active
• A ZainPay account with:
• Test and/or live public keys
• ZainBox code
• Webhook/callback URL configured as provided by the plugin

Documentation & Resources

• ZainPay API Documentation
  Full API reference and technical details:
  https://zainpay.ng/developers
• Plugin Setup Guide
  Step‑by‑step instructions on configuring the plugin and ZainPay together:
  https://ibrahim.ng/zainpay-payments-for-woocommerce-setup-guide/
• Support & Contact
  Need help with integration, bug reports, or feature requests?
  Contact the developer here:
  https://ibrahim.ng/contact/

Why Use ZainPay for Your WooCommerce Store?

• Built specifically for Nigerian merchants and other African markets.
• Designed to be easy to set up for store owners and deeply configurable for developers.
• Strong focus on reliability (detailed logs, robust verification) and security (webhooks, signatures, nonces, sanitization).

If you run a WooCommerce store and need a reliable, Nigeria‑friendly payment solution with strong developer tooling, Payment Gateway for ZainPay for WooCommerce is built for you.