TZPayWay for WooCommerce (Wordpress-Module)

Official WordPress & WooCommerce Payment Gateway integration for TZPayWay. Accept instant, automated payments from customers in Bangladesh via bKash, Nagad, Rocket, Upay, Bank Cards, and Crypto directly on your WooCommerce store.

Features

• Full HPOS Compatibility: Built with native support for WooCommerce High-Performance Order Storage (HPOS) and Checkout Blocks.
• Automated Instant Order Processing: Real-time IPN Webhook updates order status immediately upon customer payment completion.
• Enterprise-Grade Security: Validated with HMAC-SHA256 signatures (X-Webhook-Signature) and AES-256 decryption.
• Fallback Verification Engine: Automatically cross-verifies payment status with the TZPayWay API if webhooks are delayed.
• Integrated Debug Logging: Comprehensive transaction logs stored in standard WooCommerce logs (WooCommerce > Status > Logs).

Requirements

• WordPress 5.6 or newer
• WooCommerce 4.0 or newer
• PHP 7.4 or newer (PHP 8.0, 8.1, 8.2, 8.3, 8.4 fully supported)
• Active TZPayWay Merchant Account with API credentials

Quick Installation

Method 1: Upload via WordPress Admin

1. Download the latest release ZIP archive from GitHub: https://github.com/TZPayWay/Wordpress-Module/archive/refs/heads/main.zip
2. In your WordPress Admin Dashboard, navigate to Plugins > Add New > Upload Plugin.
3. Select the tzpayway.zip (or Wordpress-Module.zip) file and click Install Now.
4. Once uploaded, click Activate Plugin.

Method 2: Manual FTP / SFTP Upload

1. Extract the Wordpress-Module contents into a folder named tzpayway.
2. Upload the tzpayway folder to your WordPress server at:

   wp-content/plugins/tzpayway/

3. Go to Plugins > Installed Plugins in WordPress and activate TZPayWay for WooCommerce.

Configuration

1. In WordPress Admin, navigate to WooCommerce > Settings > Payments.
2. Locate TZPayWay and click Manage / Finish set up.
3. Configure the following options:
   • Enable / Disable: Check to enable the gateway.
   • Title: TZPayWay (bKash, Nagad, Rocket, Upay, Cards)
   • Description: Pay securely via bKash, Nagad, Rocket, Upay, Bank Cards, or Crypto.
   • API Key (X-API-KEY): Your live API Key from the TZPayWay dashboard.
   • Secret Key: Your merchant secret key for HMAC signature verification.
   • API Base URL: https://tzpayway.com
   • Successful Order Status: Choose Processing or Completed.
4. Copy your Webhook URL shown on the settings page:

   https://yourdomain.com/?wc-api=wc_gateway_tzpayway

5. Paste this URL into your TZPayWay Merchant Dashboard under Developer Settings > Webhook URL.
6. Click Save changes.

Security & Verification Flow

1. Customer initiates checkout on WooCommerce.
2. The plugin requests a secure checkout session via POST https://tzpayway.com/api/v1/payment/create.
3. Customer completes payment via their preferred payment channel (bKash, Nagad, etc.).
4. TZPayWay sends an automated IPN webhook to https://yourdomain.com/?wc-api=wc_gateway_tzpayway.
5. The plugin verifies the HMAC-SHA256 signature, validates the order total, credits the order, and updates the status to Processing or Completed.

Support & Documentation

• Developer Documentation: https://tzpayway.com/api-docs/modules
• Official GitHub: https://github.com/TZPayWay/Wordpress-Module
• Direct ZIP Download: https://github.com/TZPayWay/Wordpress-Module/archive/refs/heads/main.zip
• Technical Support: support@tzpayway.com