Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
ketapay/ketapay-php: no dependencies, PHP 8.1 or later.
composer require ketapay/ketapay-php:@beta
require_once __DIR__ . '/ketapay-php/init.php';.
use KetaPay\KetaPay;
// sk_test_... or sk_live_...
$ketapay = new KetaPay(getenv('KETAPAY_SECRET_KEY'));
$session = $ketapay->checkoutSessions->create([
'amount' => 45_000_000,
'category' => 'goods',
'title' => 'iPhone 15 Pro Max 256GB',
'description' => 'Used, 91% battery, no scratches.',
'buyer' => ['email' => 'ada@example.com'],
'seller' => ['email' => 'tunde@example.com'],
'release' => ['method' => 'release_code'],
'external_reference' => 'order_7781',
]);
header('Location: ' . $session->url);
$session->url, $escrow->milestones[0]->status. Status values have constants in KetaPay\Enums.
$otp = $ketapay->customerSessions->create([
'email' => 'ada@example.com',
]);
$token = $ketapay->customerSessions->verify(
$otp->id,
$codeTheyTyped,
)->token;
$ketapay->escrows->milestones->release(
$escrowId,
$milestoneId,
[],
['customerToken' => $token],
);
list() returns the first page. foreach over it walks every item across all pages.
use KetaPay\Webhook;
$event = Webhook::verify(
file_get_contents('php://input'),
$_SERVER['HTTP_KETAPAY_SIGNATURE'] ?? null,
// or [new, old] while rotating
getenv('KETAPAY_WEBHOOK_SECRET'),
);
KetaPay\Errors\KetaPayError. Branch on $e->code (a string such as dispute_open), never on the message.
$ketapay->testHelpers->checkoutSessions->pay($session->id);
$ketapay->testHelpers->escrows->simulate($escrowId, [
'action' => 'deliver',
'milestone_id' => $milestoneId,
]);