WP Manifestindependent plugin directory
manifest / ecommerce / wordpress-module

TZPayWay for WooCommerce

TZPayWay Wordpress Plugin

by TZPayWay · github.com/tzpayway/wordpress-module · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/tzpayway/wordpress-module/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/tzpayway/wordpress-module ↗

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