Skip to Content

New J2Commerce 6.6.5 is out. Here is everything in the release.

See What’s New

Search

Start For Free
Account
Enter the email address on your account.
Forgot your username?
Enter your password.
Forgot your password?

Or continue with

Accept ZarinPal Payments in Your Store

The plugin uses the official ZarinPal SDK, supports Rial and Toman and includes sandbox testing and refunds.

Everything Your Iranian Checkout Needs

The official SDK, currency handling and admin actions for ZarinPal.

  • Official ZarinPal SDK

    Ships with the SDK ZarinPal maintains, pointed at the current live endpoint.

  • Sandbox Testing

    Switch to ZarinPal's sandbox with one setting, with separate live and test credentials.

  • Rial (IRR) and Toman (IRT)

    Choose Rial or Toman, and the amount sent at checkout matches the amount verified on return.

  • Double-Finalize Guard

    Reloads and repeated requests never confirm an order twice.

  • Refund, Inquiry & Reverse

    With your Access Token, refund payments, look up transactions and reverse unpaid payments from J2Commerce.

  • Gateway Surcharge

    Add ZarinPal's fee as a named cart line, as a percentage, fixed amount or both.

  • Geo-Zone Restrictions

    Show ZarinPal only to customers with Iranian billing addresses, or any geo zone you set.

  • Order Total Limits

    Set minimum and maximum subtotals for ZarinPal.

  • Persian + English Language Files

    Farsi (fa-IR), American English and British English translations are included.

Built on ZarinPal's Current Endpoint

The plugin ships with the official ZarinPal SDK, which ZarinPal updates when its endpoints change.

  • Official ZarinPal SDK, not a five-year-old fork
  • Correct live payment endpoint, automatically
  • Sandbox environment wired to ZarinPal's real sandbox
  • Automatic updates keep you current with gateway changes

Rial or Toman, Your Choice

Set your currency unit once, and the plugin converts amounts correctly when it requests and verifies each payment.

  • IRR (Rial) and IRT (Toman), your choice
  • Amount stored at request time, used exactly at verify time

Refund, Look Up and Reverse Payments

With your ZarinPal Access Token, refund payments, look up any transaction and reverse unpaid payments without the ZarinPal portal.

  • Refund with reason code, customer request, duplicate, or other
  • Inquiry: look up any transaction's status by reference
  • Reverse: void an unpaid payment before capture
  • Transaction history query with filters (status, card, email, mobile)

Add ZarinPal to Your Store

The official SDK, Rial and Toman support, Farsi translation, refunds and sandbox testing.

  • Official ZarinPal SDK
  • Sandbox Testing
  • Rial (IRR) and Toman (IRT)

Use Cases

Rial Store, Full Production

Iranian Online Retailer

A clothing shop in Tehran runs their Joomla ecommerce store with prices in Iranian Rial. Their previous ZarinPal plugin had been silently broken for months, all attempted payments were failing before reaching the gateway. They install the J2Commerce ZarinPal plugin, set the currency to Rial, enter their live merchant ID, and test a complete checkout through the sandbox. They flip to production, take their first confirmed ZarinPal payment, and the ZarinPal reference ID appears in the order record. The customer sees the custom Farsi thank-you message the store owner wrote.

Toman Store With Surcharge

Digital Products Store

A Toman-priced download store adds a 1.5% "Gateway Fee" that shoppers see before they confirm.

Geographic Payment Routing

Mixed-Market Marketplace

A marketplace shows ZarinPal only to shoppers with Iranian billing addresses.

Refunds Without Portal Access

High-Volume Store

A store issues refunds from J2Commerce with a reason code, using its ZarinPal Access Token.

Languages

Translated into 3 languages.

  • English (United Kingdom) en-GB
  • English (United States) en-US
  • Persian Farsi fa-IR

Reviews

Customer Rating

No reviews yet

Every review comes from a licensed customer and appears exactly as written.

Write a Review

Log in to share your review.

Payment Methods

ZarinPal

Iranian shoppers pay through ZarinPal using the official SDK, with prices handled in Rial or Toman.

Billing Option
Free $39.00 Save 100%
Every year

Item added to cart. Checkout

View Wishlist
  • Updates, downloads and support for the length of the license
  • Your plugin keeps working after the license ends, and renewing brings new updates
  • A step-by-step user guide for every setting, linked below
Joomla
J2Commerce

Documentation

User Guide (Version 6)

You May Also Like

Advanced Cart

Apps J2Commerce

Give shoppers a slide-out cart drawer with a free shipping progress bar and inline coupons, so they never leave the page to see their cart.

$39.00

Gift Wrapping

J2Commerce

Offer paid or free gift wrap at checkout with a personal message field, and the wrap price shows live in the cart.

$19.00

Auto-Coupon Pop Up

Apps J2Commerce

Put a coupon code in a link, and shoppers who click it land with the discount already applied and a branded popup confirming it.

$39.00

Conditional Payments

Apps J2Commerce

Show or hide payment methods at checkout based on the shipping method a customer picks and their access level, updated live.

$19.00