Sadad (Melli) Payment Gateway for WooCommerce — KJNR is Kelid Jahan Nama Raya’s dedicated plugin for connecting a WooCommerce store to the Sadad (Bank Melli) payment gateway. It follows the official Sadad internet gateway protocol (revision 1.11) 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 PaymentRequest per Sadad protocol
  • Mandatory Verify after the customer returns from the gateway
  • Double-spending protection with secure transaction identifiers
  • Merchant settings: MerchantId, TerminalId, and TerminalKey
  • WooCommerce Blocks Checkout and HPOS compatibility
  • Optional customer mobile (UserId) sent to the gateway
  • Outbound server IP detection for Sadad registration
  • Custom payment method logo on checkout
  • Debug logging under WooCommerce → Status → Logs
  • Related Refund 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 Sadad merchant (MerchantId, TerminalId, TerminalKey)
  • Store server IP registered with Sadad when required
  • 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 Sadad (Melli) — KJNR.
  5. Enter MerchantId, TerminalId, and TerminalKey.
  6. Register the outbound server IP if needed 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.