Laravel - KetaPay Docs

Laravel 12 and 13, PHP 8.2 or later. Built on the PHP library, so everything there applies. Source on GitHub.

composer require ketapay/ketapay-laravel:@beta

KETAPAY_SECRET_KEY=sk_test_...
KETAPAY_WEBHOOK_SECRET=whsec_...

To change anything else (base URL, retries, timeout, log channel, webhook path): php artisan vendor:publish --tag=ketapay-config.

Call the API

Type-hint the client anywhere Laravel injects, or use the facade:

use KetaPay\KetaPay;

public function store(Order $order, KetaPay $ketapay)
{
    $session = $ketapay->checkoutSessions->create([
        'amount' => $order->total_kobo,
        'title' => $order->listing->title,
        'description' => $order->listing->description,
        'buyer' => ['email' => $order->buyer->email],
        'seller' => ['email' => $order->listing->seller->email],
        'external_reference' => "order_{$order->id}",
    ]);

    return redirect()->away($session->url);
}

use KetaPay\Laravel\Facades\KetaPay;

KetaPay::escrows()->retrieve($escrowId);

Webhooks

The package registers POST /ketapay/webhook. Add https://<your domain>/ketapay/webhook as a webhook endpoint. Every delivery is verified before anything runs, then dispatched as KetaPay\Laravel\Events\WebhookReceived and as ketapay.<type>:

use Illuminate\Support\Facades\Event;
use KetaPay\Laravel\Events\WebhookReceived;

Event::listen('ketapay.escrow.funded', function (
    WebhookReceived $webhook,
) {
    $escrow = $webhook->event->data->object;
    Order::where(
        'reference',
        $escrow->external_reference,
    )->update([
        'status' => 'paid',
    ]);
});

Repeat deliveries are acknowledged without dispatching again (event ids kept in your cache for 3 days).
Do slow work in a queued listener (ShouldQueue): KetaPay waits 10 seconds.
While rotating, list both secrets: KETAPAY_WEBHOOK_SECRET=whsec_new,whsec_old.

Testing

KetaPay\Laravel\Testing\InteractsWithKetaPayWebhooks posts signed webhooks in your feature tests:

$this->postKetaPayWebhook($this->ketapayEvent('escrow.funded', [
    'object' => 'escrow',
    'id' => 'esc_1',
    'external_reference' => 'order_1',
]))->assertOk();