README

A comprehensive Laravel package for integrating multiple payment gateways into your application. This package provides a unified interface for processing payments through various payment providers including Stripe, PayPal, Razorpay, Paystack, and many more.

Features
Supported Gateways
Installation
Configuration
Basic Usage
Gateway Documentation
- Stripe
- PayPal
- Paystack
- Razorpay
- PayTM
- Flutterwave
- SSLCommerz
- Mollie
- SenangPay
- bKash
- Mercado Pago
- Cashfree
- PayFast
- Skrill
- PhonePe
- Telr
- iyzico
- Pesapal
- Midtrans
- MyFatoorah
- EasyPaisa
Testing
Contributing
License

Features

Unified Interface: Single API for all payment gateways
Multiple Gateways: Support for 20+ payment gateways
Secure: Built with security best practices
Flexible: Easy to extend with new gateways
Laravel Ready: Built specifically for Laravel
Webhook Support: Built-in webhook handling
Error Handling: Comprehensive error management
Test Friendly: Full testing support

Supported Gateways

Gateway	Regions	Supported Methods	Documentation
Stripe	Global	Cards, Apple Pay, Google Pay, ACH	Guide
PayPal	Global	PayPal, Cards, Venmo	Guide
Paystack	Africa	Cards, Bank Transfer, USSD	Guide
Razorpay	India	Cards, UPI, NetBanking, Wallets	Guide
PayTM	India	Wallet, Cards, NetBanking, UPI	Guide
Flutterwave	Africa	Cards, Mobile Money, Bank Transfer	Guide
SSLCommerz	Bangladesh	Cards, Mobile Banking, Bank Transfer	Guide
Mollie	Europe	Cards, iDEAL, Bank Transfer, Klarna	Guide
SenangPay	Malaysia	Cards, FPX, Online Banking	Guide
bKash	Bangladesh	Mobile Wallet	Guide
Mercado Pago	Latin America	Cards, Bank Transfer, Wallets	Guide
Cashfree	India	Cards, UPI, NetBanking, Wallets	Guide
PayFast	South Africa	Cards, EFT, Zapper, Masterpass	Guide
Skrill	Global	Wallet, Cards, Bank Transfer	Guide
PhonePe	India	UPI, Cards, Wallets	Guide
Telr	Middle East	Cards, Knet, Sadad, Fawry	Guide
iyzico	Turkey	Cards, Bank Transfer, Wallets	Guide
Pesapal	Africa	Cards, Mobile Money, Bank Transfer	Guide
Midtrans	Indonesia	Cards, Bank Transfer, E-Wallets	Guide
MyFatoorah	Middle East	Cards, Knet, Benefit, Sadad	Guide
EasyPaisa	Pakistan	Mobile Wallet, Bank Transfer	Guide

Installation

Install the package via Composer:

composer require mdiqbal/laravel-payments

Publish the configuration file:

php artisan vendor:publish --provider="Mdiqbal\LaravelPayments\PaymentsServiceProvider"

Add your payment gateway credentials to your .env file:

# Example for Stripe
STRIPE_MODE=test
STRIPE_SANDBOX_SECRET=your_sandbox_secret_key
STRIPE_SANDBOX_KEY=your_sandbox_publishable_key
STRIPE_LIVE_SECRET=your_live_secret_key
STRIPE_LIVE_KEY=your_live_publishable_key
STRIPE_WEBHOOK_SECRET=your_webhook_secret

# Example for PayPal
PAYPAL_MODE=sandbox
PAYPAL_SANDBOX_CLIENT_ID=your_sandbox_client_id
PAYPAL_SANDBOX_CLIENT_SECRET=your_sandbox_client_secret
PAYPAL_LIVE_CLIENT_ID=your_live_client_id
PAYPAL_LIVE_CLIENT_SECRET=your_live_client_secret

# Example for Mercado Pago
MERCADOPAGO_MODE=sandbox
MERCADOPAGO_SANDBOX_ACCESS_TOKEN=your_sandbox_access_token
MERCADOPAGO_LIVE_ACCESS_TOKEN=your_live_access_token
MERCADOPAGO_COUNTRY=MX
MERCADOPAGO_WEBHOOK_SECRET=your_webhook_secret

Configuration

The package configuration file is located at config/payments.php. Here you can configure all supported gateways:

return [
    'default' => env('PAYMENT_DEFAULT_GATEWAY', 'stripe'),

    'gateways' => [
        'stripe' => [
            'mode' => env('STRIPE_MODE', 'sandbox'),
            'sandbox' => [
                'secret_key' => env('STRIPE_SANDBOX_SECRET'),
                'api_key' => env('STRIPE_SANDBOX_KEY'),
            ],
            'live' => [
                'secret_key' => env('STRIPE_LIVE_SECRET'),
                'api_key' => env('STRIPE_LIVE_KEY'),
            ],
            'webhook_secret' => env('STRIPE_WEBHOOK_SECRET'),
        ],

        'paypal' => [
            'mode' => env('PAYPAL_MODE', 'sandbox'),
            'sandbox' => [
                'client_id' => env('PAYPAL_SANDBOX_CLIENT_ID'),
                'client_secret' => env('PAYPAL_SANDBOX_CLIENT_SECRET'),
            ],
            'live' => [
                'client_id' => env('PAYPAL_LIVE_CLIENT_ID'),
                'client_secret' => env('PAYPAL_LIVE_CLIENT_SECRET'),
            ],
            'webhook_id' => env('PAYPAL_WEBHOOK_ID'),
        ],

        // ... other gateways
    ],
];

Basic Usage

Making a Payment

use Mdiqbal\LaravelPayments\Facades\Payment;
use Mdiqbal\LaravelPayments\DTO\PaymentRequest;

// Create a payment request
$paymentRequest = new PaymentRequest(
    amount: 100.00,
    currency: 'USD',
    description: 'Payment for Order #12345'
);

// Set optional parameters
$paymentRequest->setTransactionId('order_' . uniqid());
$paymentRequest->setReturnUrl(route('payment.success'));
$paymentRequest->setCancelUrl(route('payment.cancel'));

// Process payment with default gateway
$response = Payment::pay($paymentRequest);

// Or process with a specific gateway
$response = Payment::gateway('stripe')->pay($paymentRequest);

// Handle response
if ($response->isSuccess()) {
    if ($response->isRedirect()) {
        return redirect($response->getRedirectUrl());
    }

    $transactionId = $response->getTransactionId();
    // Save transaction ID to database
} else {
    $errorMessage = $response->getMessage();
    // Handle error
}

Retrieving Payment Status

use Mdiqbal\LaravelPayments\Facades\Payment;

$transactionId = 'txn_1234567890';
$response = Payment::gateway('stripe')->retrievePayment($transactionId);

if ($response->isSuccess()) {
    $status = $response->getData()['status'];
    $amount = $response->getData()['amount'];
    // Update order status
}

Processing Refunds

use Mdiqbal\LaravelPayments\Facades\Payment;

$transactionId = 'txn_1234567890';
$refundAmount = 50.00;
$reason = 'Customer requested refund';

try {
    $success = Payment::gateway('stripe')->refund($transactionId, $refundAmount, $reason);

    if ($success) {
        // Refund processed successfully
    }
} catch (\Exception $e) {
    // Handle refund failure
}

mdiqbal / laravel-payments

Maintainers

Details

README

Table of Contents

Features

Supported Gateways

Installation

Configuration

Basic Usage

Making a Payment

Retrieving Payment Status

Processing Refunds

Gateway Documentation

Stripe

PayPal

Paystack

Razorpay

PayTM

Flutterwave

SSLCommerz

Mollie

SenangPay

bKash

Mercado Pago

Cashfree

PayFast

Skrill

PhonePe

Telr

iyzico

Pesapal

Midtrans

MyFatoorah

EasyPaisa

Testing

Running Tests

Test Configuration

Contributing

Development Setup

License

Support

Security