Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Base URL, request and response format, and the rules every endpoint follows.
https://api.ketapay.com/v1
sk_test_ keys use test money, sk_live_ keys real money, and every object carries livemode.
HTTPS only, TLS 1.2 or later. Plain HTTP is refused, not redirected.
curl https://api.ketapay.com/v1/checkout_sessions \
-H "Authorization: Bearer $KETAPAY_SECRET_KEY" \
-H "Idempotency-Key: order_7781" \
-H "Content-Type: application/json" \
-d '{
"amount": 45000000,
"title": "...",
"description": "...",
"buyer": { "email": "ada@example.com" },
"seller": { "email": "tunde@example.com" }
}'
| Header | When |
|---|---|
Authorization: Bearer <secret key> | Every request (Authentication) |
Content-Type: application/json | Every request with a body (multipart/form-data for file uploads) |
Idempotency-Key | Every POST (Idempotency) |
KetaPay-Customer-Token | Calls your customer must approve (Customer tokens) |
id, an object field naming its type, and livemode.
{
"id": "b1c2d3e4-5f60-4a7b-8c9d-0e1f2a3b4c5d",
"object": "checkout_session",
"livemode": false,
"status": "open"
}
{ "object": "list", "data": [...], "has_more": true, "next_cursor": "..." } (Pagination). Errors return { "error": { ... } } (Errors).
| Response header | Meaning |
|---|---|
KetaPay-Request-Id | Unique per request. Quote it to support |
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset | Your rate limit (Rate limits) |
| Type | Format |
|---|---|
| Amounts | Integers in kobo: 250000 is ₦2,500.00. Currency is always NGN |
| Dates | ISO 8601 strings in UTC: 2026-10-18T09:30:00Z |
| IDs | UUIDs |
| Phone numbers | Nigerian mobile numbers in E.164 format: +2348012345678 |