Behpardakht Mellat Payment Gateway for WooCommerce — KJNR is Kelid Jahan Nama Raya’s dedicated plugin for connecting a WooCommerce store to the Behpardakht Mellat (Bank Mellat) payment gateway. It follows the official gateway functions documentation v1.38 (Shahrivar 1404) and is built for Iranian online stores.

This product is completely free and offered without any license. There is no activation fee, subscription, or license lock. The plugin was custom-coded exclusively by the Kelid Jahan Nama Raya (KJNR) team.

Key features

  • Secure payments via bpPayRequest per Behpardakht docs
  • Verify then Settle (recommended) to finalize transactions
  • Double-spending protection with RefId / SaleOrderId controls
  • Amount handling for store currency in Rial / Toman
  • WooCommerce Blocks Checkout and HPOS compatibility
  • Terminal settings: Terminal ID, username, and password
  • Optional customer mobile number sent to the gateway
  • Outbound server IP detection for Behpardakht whitelist registration
  • Custom payment method logo on checkout
  • Debug logging under WooCommerce → Status → Logs
  • Related Refund / Reverse flows within gateway capabilities
  • Automatic updates from WordPress admin via the KJNR update server

Requirements

  • WordPress 6.4+
  • WooCommerce 8.0+ (tested up to 11.1)
  • PHP 8.1+
  • Active Behpardakht Mellat terminal (Terminal ID, username, password)
  • Store server IP registered with Behpardakht Mellat
  • HTTPS on the storefront

Installation

  1. Download the ZIP from this page.
  2. In WordPress go to Plugins → Add New → Upload Plugin and install the file.
  3. Activate the plugin.
  4. Open WooCommerce → Settings → Payments and enable Behpardakht Mellat — KJNR.
  5. Enter Terminal ID, username, and password.
  6. Register the outbound server IP in the Behpardakht panel and run a test payment.

For support or bug reports, use the “Report a bug” button on this page or contact us through the site contact form.