WooCommerce

Zai Payment Plugin for WooCommerce

Version compatibility: WordPress 6.x | WooCommerce 7.x, 8.x, 9.x


Overview

The Zai Payment Plugin for WooCommerce enables you to accept secure credit card payments directly on your store. With our WooCommerce plugin Solution, you can provide your customers with a seamless checkout experience while managing transactions through the Zai dashboard.

⚡️ Key features

  • Accept major credit cards (Visa, Mastercard, American Express)
  • Secure, PCI-compliant hosted payment solution
  • Simple configuration with your Zai merchant account
  • Test mode for development and testing

Before you begin

Requirements

Make sure your system meets these requirements before installation:

ComponentRequirement
WordPressVersion 6.x
WooCommerceVersion 7.x, 8.x, 9.x
Web serverApache or nginx
PHPVersion 7.4 or later
MySQLDatabase with sample data
SSLValid security certificate (self-signed not supported)
CurlVersion 7.20.0 or later

⚠️

Important

A valid SSL certificate is required for secure payments. Self-signed certificates are not supported.

Create your Zai merchant account

Before installing the plugin, you'll need to:

  1. Sign up for a Zai merchant account by reaching out to Zai team
  2. Wait for account approval
  3. Once approved, you'll receive your API credentials

💡

Note

Test accounts are available for development and testing purposes.


Installation

Step 1: Get the plugin

Download the plugin ZIP file from this link.

Step 2: Upload and activate

Navigate to WordPress Admin → Plugins → Add New → Upload Plugin
  1. Select the ZIP file you received
  2. Click Install Now
  3. After installation completes, click Activate Plugin

Configuration

After activating the plugin, you'll need to configure it with your Zai merchant account details.

Set up in test mode (Pre-live)

Test mode allows you to test transactions without processing real payments.

  1. Go to WooCommerceSettingsPayments
  2. Click on Zai Credit Card Payment Gateway
  3. Configure the following settings:
    • Check Enable/Disable to activate the payment method
    • Set Title to "Credit Card (Zai)" (or your preferred title)
    • Set Description to "Pay with your credit card via Zai" (or your preferred description)
    • Check the Test Mode box
    • Enter your Pre-live API credentials:
      • Seller ID
      • Client ID
      • Client Secret
      • Scope
    • Optionally enable logging for troubleshooting
    • Optionally upload a Zai logo
  4. Click Save changes

📋

Locating your credentials

Your API credentials can be found in the Zai Pre-live dashboard under Platform Profile.

Verify your configuration

After entering your credentials, use the Test Zai Credentials button to verify your integration is working correctly. If your credentials are valid, you'll see a confirmation message.


Testing

Always test your integration thoroughly before going live.

Test a payment

  1. Ensure Test Mode is enabled in your plugin settings
  2. Go to your store's frontend
  3. Add a product to the cart and proceed to checkout
  4. Use one of these test card numbers:
Card typeCard numberExpiry dateCVV
Visa (Approval)4111 1111 1111 1111Any future dateAny 3 digits
Mastercard (Approval)5555 5555 5555 4444Any future dateAny 3 digits
American Express (Approval)3782 822463 10005Any future dateAny 4 digits
  1. Click Use This Card button
  2. You should see a successful message if your card details are correct
  3. Click Place Order button
  4. A successful transaction message will appear if everything is working correctly

Check the transaction in your dashboard

After completing a test transaction:

  1. Log into your Zai Pre-live Merchant Dashboard
  2. Navigate to PaymentsPayInsCredit Card
  3. Verify that your test transaction appears and check its details

Test error scenarios

To ensure your error handling works correctly:

  • Try using an expired card date
  • Use an invalid card number (e.g., 4000 0000 0000 0002)
  • Verify that clear and informative error messages appear for customers

Going live

When you're ready to accept real payments:

  1. Go to WooCommerceSettingsPaymentsZai Credit Card Payment Gateway
  2. Uncheck the Test Mode box
  3. Enter your live API credentials:
    • Seller ID
    • Client ID
    • Client Secret
    • Scope
  4. Click Save changes
  5. Process a low-value real transaction to confirm everything works

📋

Locating your credentials

Your API credentials can be found in the Zai dashboard under Platform Profile.

⚠️

Important

In the pre-live environment, settlement occurs immediately. In production, funds automatically settle to the seller’s wallet after T+2 business days.


Troubleshooting

IssueSolution
Connection errorVerify your API credentials are correct and try the "Test Zai Credentials" button
Transaction declinedCheck that you're using valid test card details or that the customer has sufficient funds
Plugin not appearingVerify that WooCommerce is active and compatible with your WordPress version

For error codes and more detailed troubleshooting, refer to the Zai developer documentation.


Support

If you need assistance:

Email: [email protected]
Hours: Monday to Friday, 9am to 5pm AEST

The Zai support team can help with:

  • Plugin installation and configuration
  • Payouts to your bank account
  • Zai merchant dashboard questions
  • Other Zai services

📝

Note

For issues related to your WooCommerce cart, website hosting, or other services, please contact your hosting provider.


FAQ

How do I obtain my API credentials?
Your API credentials are available in your Zai merchant dashboard under the Platform Profile section.

Can I accept American Express cards?
Yes, you can enable or disable American Express acceptance in the plugin payment settings.

Does the plugin support refunds?
Yes, you can process refunds directly from the WooCommerce order management screen.

How do I handle failed transactions?
Failed transactions will display an error message to the customer. You can view details of failed transactions in your Zai dashboard.

How does funds settlement differ between Pre-live and Production?
In the pre-live environment, settlement occurs immediately. In production, funds automatically settle to the seller’s wallet after T+2 business days.