README

Lightweight, Framework-Independent PHP Library (PHP 7 Compatible)

A simple PHP SDK to integrate EzeePlusPay PSP Aggregator Gateway into any PHP 7+ project.
Works with plain PHP + Composer.

📦 Installation

Install via Composer

composer require travansoft/ezeepluspay

🛠 Requirements

Component Version

PHP 7.0+ Extensions cURL, JSON Server Apache/Nginx

🚀 Quick Start

1. Initialize Client

<?php
require 'vendor/autoload.php';

use Travansoft\EzeePlusPay\Client;

$client = new Client([
    'api_key' => 'YOUR_API_KEY',
    'secret'     => 'YOUR_SECRET_KEY',
    'base_url'    => 'https://secure.example.in/'
]);

💰 Create a Payment Request

$merchantTransactionId$ = "ORD" . time();

$response = $client->createPayment([
    'merchant_tid'   => $merchantTransactionId,
    'amount'     => 49900,    
    'callback_url' => "https://yourdomain.com/payment/redirect.php",
    'metadata'   => [
        'customer'   => 'John Doe',
        'mobile' => '9876543210',
        'email'  => 'john@example.com'
    ]
]);

echo "Redirect user to: " . $response['payment_url'];

🌐 Redirect the User

header("Location: " . $response['payment_url']);
exit;

🔄 Handling Redirect Response Auto mode (recommended):

 
$result = $client->processPaymentCallback();

if (!$result->isValid()) {
    http_response_code(400);
    exit("Callback Error: " . $result->getError());
}

$data = $result->getData();

🔄 Handling Redirect Response Manual mode (if merchant wants control):

$result = $client->handleCallback($signedPayload, $signature);

if ($result->isValid()) {
    $data = $result->getData();
} else {
    echo $result->getError();
}

📬 Server-to-Server Callback (Webhook)

<?php

$result = $client->processWebhook();

if (!$result->isValid()) {
    http_response_code(400);
    exit("Callback Error: " . $result->getError());
}

$data = $result->getData();
$merchantTransactionID = $data['merchant_tid'];
$status  = $data['status'];

🔎 Offline Transaction Status API (Reconciliation)

Use this API to:

Check payment status manually

Handle missed callbacks

Reconcile pending transactions

Run cron-based verification

This API works even if the user never returned from the payment page.

<?php
$response = $client->fetchTransactionStatus($aggregatorTid);

if ($response['status'] === 'success') {
    $event = $response['event'];
    echo "Payment Status: " . $event['status'];
} else {
    echo "Transaction is still pending";
}

🔥 Forced PSP Reconciliation (Admin / Cron)

This always calls the underlying PSP, even if the transaction was already resolved earlier.

<?php

$response = $client->fetchTransactionStatus($aggregatorTid, true);

if ($response['status'] === 'success') {
    $event = $response['event'];

    /*
     * Event payload structure:
     * [
     *   'aggregator_tid',
     *   'merchant_tid',
     *   'psp_tid',
     *   'amount',
     *   'status',        // SUCCESS | FAILED | REFUNDED
     *   'message',
     *   'psp',
     *   'raw_response',
     *   'timestamp'
     * ]
     */
} else {
    echo "Transaction still pending at payment gateway";
}

📞 Support

For API credentials or support, contact EzeePlusPay.

📝 License

MIT License