Sepehr (Saderat) Payment Gateway for WooCommerce — KJNR is Kelid Jahan Nama Raya’s dedicated plugin for connecting a WooCommerce store to the Sepehr / Bank Saderat payment gateway. It follows the official Token API documentation v4.0.1 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 Sepehr payments via the token flow (docs 4.0.1)
  • Mandatory Advice after the customer returns from the gateway
  • Double-spending protection with transaction-state controls
  • Optional Rollback support (when enabled by Sepehr operations)
  • WooCommerce Blocks Checkout and HPOS compatibility
  • Terminal ID, title, and payment method description settings
  • Custom gateway logo on the checkout payment method
  • Outbound server IP detection for Sepehr panel whitelisting
  • Debug logging under WooCommerce → Status → Logs (source: sepehr-saderat-kjnr)
  • 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 Sepehr (Bank Saderat) payment terminal
  • 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 Sepehr (Saderat) — KJNR.
  5. Enter your Terminal ID and configure Rollback / debug logging if needed.
  6. Register the server outbound IP in the Sepehr panel and run a test payment.

Rollback note

Per Sepehr documentation, Rollback is disabled by default for merchants and must be requested from Sepehr operations. Enable it in the plugin settings only after Sepehr has activated it for your terminal.

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