Skip to main content

​
Overview

ZAFA PAY can be integrated as a WooCommerce payment gateway plugin. It uses hosted checkout, so your site never handles card information directly.

​
Download

ZAFA PAY Gateway for WooCommerce v1.0.0

Download plugin (ZIP)

​
Requirements

  • WordPress 5.0+
  • WooCommerce 5.0+
  • PHP 7.4+
  • ZAFA PAY merchant account

​
Setup Flow

1

Install Plugin

Upload the downloaded ZIP file via Plugins → Add New → Upload Plugin in the WordPress admin and activate it
2

WooCommerce Settings

Go to WooCommerce → Settings → Payments → ZAFA PAY and configure your API token and Webhook secret
3

ZAFA PAY Dashboard Settings

Configure the Webhook URL and redirect URLs
4

Test Payment

Run a test payment in sandbox mode to verify everything works

​
Plugin Settings

Configure the following in the WooCommerce admin (WooCommerce → Settings → Payments → ZAFA PAY):
Sandbox and production use different API tokens. Make sure to update the token when switching environments.

​
ZAFA PAY Dashboard Settings

​
Webhook URL

Register the following URL in the Webhooks tab of the ZAFA PAY dashboard:
Events to subscribe:
  • payment.succeeded
  • payment.failed
  • payment.canceled
  • payment.refunded
  • payment.chargeback

​
Redirect URLs

Configure the following in the Redirect URL settings of the ZAFA PAY dashboard:
Success and failure use the same URL. The plugin automatically determines the result based on the status parameter appended by ZAFA PAY.

​
Payment Flow

​
Refunds

Refunds can be processed from the WooCommerce admin:
  1. Go to WooCommerce → Orders and open the target order
  2. Click the “Refund” button
  3. Enter the refund amount in the product line item fields
  4. Click “Refund via ZAFA PAY”
Both partial and full refunds are supported.

​
Order Status Mapping

​
API Environments