PHP code example of joynala / multi-pay

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

joynala / multi-pay example snippets

// 1. Same payload for every gateway — only the name changes
$result = MultiPay::gateway('stripe')->pay([
    'amount' => 100,
    'currency' => 'USD',
    'order_id' => 'ORD-1001',
    'customer' => ['name' => 'John Doe', 'email' => '[email protected]'],
]);

return redirect($result['payment_url']);

// 2. When the customer comes back, verify with one call
$result = MultiPay::confirm($session, $request);

if ($result->success) {
    // money confirmed by the gateway — fulfil the order
}

// routes/web.php
use App\Http\Controllers\PaymentController;

Route::match(['get', 'post'], '/payment/{session}/success', [PaymentController::class, 'success'])->name('multipay.success');
Route::match(['get', 'post'], '/payment/{session}/cancel',  [PaymentController::class, 'cancel'])->name('multipay.cancel');
Route::match(['get', 'post'], '/payment/{session}/failure', [PaymentController::class, 'failure'])->name('multipay.failure');
Route::match(['get', 'post'], '/payment/{session}/callback', [PaymentController::class, 'callback'])->name('multipay.callback');

->withMiddleware(function (Middleware $middleware): void {
    $middleware->validateCsrfTokens(except: ['payment/*']);
})

// config/multipay.php
'stripe' => [
    'is_active' => true,
    'secret_key' => 'secret_key_data',   // package's "secret_key" lives in JSON field "secret_key_data"
    'public_key' => 'public_key_data',
],

MultiPay::gateway('stripe', ['secret_key' => 'sk_test_...', 'public_key' => 'pk_test_...']);

use Abedin\MultiPay\Facades\MultiPay;

$result = MultiPay::gateway('razorpay')->pay([
    'amount' => 499.00,
    'currency' => 'INR',
    'order_id' => 'ORD-' . $order->id,
    'customer' => [
        'name' => $user->name,
        'email' => $user->email,
    ],
    'meta' => [
        'title' => 'Pro Plan',
        'description' => 'Pro plan subscription',
        'phone' => $user->phone,
    ],
]);

return redirect($result['payment_url']);

[
    'success'         => true,
    'gateway'         => 'razorpay',
    'payment_id'      => 'plink_...',      // gateway-side reference, stored on the session
    'payment_url'     => 'https://...',    // send the customer here
    'status'          => 'pending',
    'supports_iframe' => false,
    'message'         => 'Razorpay payment link generated successfully.',
    'raw'             => [...],            // full gateway response
]

class PaymentController extends Controller
{
    public function success(Request $request, string $session)
    {
        $result = MultiPay::confirm($session, $request);

        if (!$result->success) {
            return redirect()->route('checkout')->with('error', $result->message);
        }

        Order::where('order_no', MultiPay::session($session)->order_id)
            ->update(['status' => 'paid']);

        return redirect()->route('orders.thankyou');
    }

    public function callback(Request $request, string $session) // server-to-server
    {
        MultiPay::confirm($session, $request);

        return response()->json(['ok' => true]);
    }

    public function cancel(Request $request, string $session)
    {
        MultiPay::cancel($session);

        return redirect()->route('checkout')->with('error', 'Payment cancelled.');
    }

    public function failure(Request $request, string $session)
    {
        $result = MultiPay::confirm($session, $request); // records the failure with gateway proof

        return redirect()->route('checkout')->with('error', 'Payment failed.');
    }
}

// A listener is a clean place for fulfilment logic:
class FulfilOrder
{
    public function handle(PaymentSucceeded $event): void
    {
        Order::where('order_no', $event->session->order_id)->update(['status' => 'paid']);
    }
}

$session = MultiPay::session($uuid);   // fetch the PaymentSession (throws PaymentSessionNotFoundException)
MultiPay::cancel($uuid);               // mark cancelled — only affects sessions still 'pending'; never downgrades a paid session

'admin_middleware' => ['web', 'auth', 'can:manage-payments'], // default: ['web', 'auth']

Route::get('/api/payment-methods', fn () => MultiPay::activeGateways());

bash
php artisan vendor:publish --tag=multi-pay
php artisan migrate

blade
@foreach (MultiPay::activeGateways() as $g)
    <label>
        <input type="radio" name="gateway" value="{{ $g['name'] }}">
        <img src="{{ $g['icon'] ?? $g['icon_data_uri'] }}" alt="{{ $g['label'] }}" height="28">
        {{ $g['label'] }}
    </label>
@endforeach

bash
php artisan vendor:publish --tag=multi-pay-config --force
php artisan vendor:publish --tag=multi-pay-migrations --force
php artisan migrate