Browse project documentation

Pardakht

Pardakhtv1.0.0-beta.4View sourceEnglish / Persian

A unified, type-safe PHP library for Iranian payment gateways.

Tests License: MIT PHP

Documentation: English | فارسی

What is Pardakht?

Pardakht (پرداخت, “payment” in Farsi) is an omni-gateway PHP library that gives you a single, consistent API across all major Iranian payment providers — bank gateways (SOAP) and modern payment services (REST) alike. Write your payment logic once, swap the gateway with one line of config.

Why Pardakht?

  • Minimal dependencies — one internal Composer package (eram/abzar, Persian/Iranian utilities) plus the standard PHP extensions ext-curl, ext-json, ext-openssl, ext-soap. No Guzzle, no framework coupling, no third-party supply-chain risk.
  • Rial/Toman safety — the Amount value object eliminates the 10x conversion bugs that plague Iranian e-commerce.
  • One interface, every gateway — purchase() → verify() → optionally settle(). Same flow whether it’s Zarinpal or Mellat.
  • Framework-agnostic — works with Laravel, Symfony, or plain PHP. Plug in your own HTTP client, logger, or event dispatcher.
  • Fully tested — unit tests for every gateway, PHPStan static analysis, PER-CS2 code style.

Install

composer require eram/pardakht

Supported Gateways

AliasGatewayProtocolSettlementDocs
zarinpalZarinpalRESTAutoGuide
mellatMellat (Behpardakht)SOAPRequiredGuide
samanSaman (Sep)SOAPAutoGuide
parsianParsian (Pec)SOAPRequiredGuide
sadadSadad (Bank Melli)RESTAutoGuide
pasargadPasargadRESTAutoGuide
idpayIDPayRESTAutoGuide
zibalZibalRESTAutoGuide
payirPay.irRESTAutoGuide
nextpayNextPayRESTAutoGuide
vandarVandarRESTAutoGuide
sizpaySizpayRESTAutoGuide

Quick Start

The flow is always: create → purchase → redirect → verify (and optionally settle for bank gateways).

See the Getting Started guide for a complete walkthrough with code examples.

Documentation

Full documentation with API reference, cookbook, gateway guides, and more:

About Eram

Eram is a small engineering team building open-source developer tools for the Persian ecosystem. Our projects — pardakht, daynum, persian-kit — solve the everyday problems that Iranian developers run into: payment integration, calendar conversion, and string/number localization. Everything we ship is MIT-licensed, zero-dependency where possible, and built to be boring infrastructure you never have to think about.

License

MIT

Search documentation

Search across all projects. Close this window to return to your guide.

Tab to navigate · Enter to openEsc to close