README

💳 Anypay — Multi-Gateway PHP / Laravel Payment Library

A comprehensive PHP & Laravel payment library that connects 40+ payment gateways behind one unified API — purchase, pay, and verify online transactions with a single, consistent interface.

📖 Overview

Anypay is a comprehensive PHP and Laravel payment library for handling multiple payment-gateway integrations through a single, unified API. Instead of learning a different SDK for every bank or gateway, you write your checkout flow once and switch providers by changing a driver name — Anypay gives developers a simple, uniform payment experience with consistent purchase → pay → verify semantics across every gateway.

The package bundles 40+ drivers, covering the major Iranian bank and PSP gateways (Mellat, Melli/Sadad, Saman, Parsian, Pasargad, Saderat, Zarinpal, IDPay, Zibal and many more), popular wallet and installment (BNPL) providers (Azki, Etebarino, Walleta, Digipay, Vandar, Toman), and international gateways such as PayPal and Bitpay. It ships with Laravel auto-discovery (service provider + facade) and works equally well in plain PHP projects.

🔎 Keywords: PHP payment gateway, Laravel payment library, multi-gateway payment, online payment integration, unified payment API, Iran payment gateway, Iranian bank integration, Zarinpal, Mellat, Saman, PayPal PHP, payment processing library, BNPL installment payment.

✨ Features

• 🔌 40+ payment gateways out of the box — one driver-based interface for all of them.
• 🧩 Unified API — the same purchase(), pay(), and verify() flow regardless of gateway.
• 🛟 Robust error handling — dedicated exceptions for invalid payments, failed purchases, and missing drivers/invoices.
• ⚙️ Dynamic configuration — pass settings inline or load them from a published config file.
• 🪝 Trackable payment events — hook into each stage of the payment lifecycle.
• 🧱 Laravel-ready — auto-registered service provider and Anypay facade (also usable in plain PHP).
• 💳 Cards, wallets & installments — supports standard card gateways plus BNPL / installment providers.

🏦 Supported Gateways

The following drivers are bundled under src/Drivers/:

🛠️ Tech Stack

🚀 Getting Started

Prerequisites

• PHP 7.2+ and Composer

Installation

composer require morpheusadam/anypay

In Laravel, the service provider and Anypay facade are auto-discovered — no manual registration required.

📦 Usage

Create and pay an invoice

$config  = ['driver' => 'gatewayName', 'api_key' => 'your_api_key'];
$anypay  = new Morpheusadam\Anypay\Anypay($config);

$invoice = new Morpheusadam\Anypay\Invoice();
$invoice->amount(1000); // amount in Rials

$anypay->via('gatewayName')->purchase($invoice)->pay();

Quick pay with the payWith helper

$config  = ['api_key' => 'your_api_key'];
$gateway = 'gatewayName';
$amount  = 1000; // amount in Rials

try {
    $anypay   = new Morpheusadam\Anypay\Anypay($config);
    $response = $anypay->payWith($gateway, $amount, $config);
    echo $response->getContent(); // payment response details
} catch (Exception $e) {
    echo 'Payment error: ' . $e->getMessage();
}

Verify a payment (on the callback)

try {
    $anypay  = new Morpheusadam\Anypay\Anypay($config);
    $receipt = $anypay->verify();
    echo 'Payment confirmed. Transaction ID: ' . $receipt->getTransactionId();
} catch (Exception $e) {
    echo 'Verification error: ' . $e->getMessage();
}

Using the Laravel facade with a published config

use Morpheusadam\Anypay\Facades\Anypay;

$invoice = (new Invoice)->amount(1000);

Anypay::via('driverName')->purchase($invoice, function ($driver, $transactionId) {
    // store $transactionId against the order
});

🤝 Contributing

Contributions are welcome! Open an issue or submit a pull request to add a gateway driver, fix a bug, or improve the docs.

📜 License

Distributed under the MIT License. See the LICENSE file for full terms.

👤 Author — Morpheus Adam

Web developer & cheerful hacker · PHP · Laravel · Go

⭐ If Anypay simplified your checkout, consider giving it a star! ⭐