README

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

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

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:

• English Documentation
• مستندات فارسی

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