a-sabagh/laravel-iran-payment

Simplifies integration with Iranian payment gateways, offering secure, configurable, payment processing

dev-main 2025-10-23 12:17 UTC

Requires

• php: ^8.1
• a-sabagh/laravel-enhance-enums: @dev
• guzzlehttp/guzzle: ^6.0|^7.0
• illuminate/http: ^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0
• illuminate/support: ^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.24
• orchestra/testbench: ^4.0|^5.0|^6.0|^7.0|^8.0|^9.0|^10.0
• phpunit/phpunit: ^8.0|^9.3|^10.4|^11.5

MIT

• payment
• gateway
• laravel
• zarinpal

README

A developer-friendly Laravel package that simplifies integration with Iranian payment gateways. It offers a consistent API, secure flows, and an extensible driver system so you can plug in multiple gateways with minimal effort.

Why this exists: to provide a secure, configurable, and developer-friendly way to accept payments via Iranian gateways in Laravel. (Source: repository description & license.)

Table of contents

• Features
• Requirements
• Installation
• Configuration
• Quick start
• Usage
  • Process Payment
  • Custom drivers
• Testing

Features

• ✅ Unified, fluent API across supported gateways
• ✅ Secure purchase → process → verify flow
• ✅ First-class Laravel experience (config, facades, DI, routes, workbench)
• ✅ Extensible driver contract for adding new gateways
• ✅ Well-structured tests scaffold (PHPUnit)

Note: List the exact gateways you ship with under “Supported gateways” below.

Supported gateways (update this list):

• Zarinpal
• Payping
• …add more

Requirements

• PHP 8.1+ (recommended: 8.2/8.3)
• Laravel 10+ or 11

If your code requires different versions, update this section.

Installation

Install via Composer:

composer require a-sabagh/laravel-iran-payment

Configuration

This package merges its own config and loads translations out-of-the-box:

• Config is merged from: vendor/a-sabagh/laravel-iran-payment/config/irpayment.php
• Translations are loaded from: vendor/a-sabagh/laravel-iran-payment/lang (namespace: irpayment)
• Views are loaded from: vendor/a-sabagh/laravel-iran-payment/resources/views (namespace: irpayment)

php artisan vendor:publish --tag=irpayment