Retry without paying twice
Every payment carries an idempotency key. Send it again and you get the same payment back, never a second one.
Sandbox on request
Send money from an account to any Nigerian bank account. Retry safely, and know exactly how every payment ended.
WHAT YOU GET
Every payment carries an idempotency key. Send it again and you get the same payment back, never a second one.
Each payment ends as success or failed. A pending payment shows as pending until it resolves.
A payment that would take an account below zero is refused before any money moves.
Signed webhooks tell your server when a payment succeeds or fails.
IN CODE
Every payment needs an Idempotency-Key header. Amounts are whole kobo: 15000000 is 150,000 naira.
POST /api/v1/pay
Authorization: Bearer wk_test_...
Idempotency-Key: order-2048
{
"source_account_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"amount_kobo": 15000000,
"counterparty_bank_code": "058",
"counterparty_account_number": "0123455678"
} {
"id": "b3a1f0de-6c52-4c2e-9f8e-2d7a51c0e912",
"source_account_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"counterparty_account_number": "0123455678",
"counterparty_bank_code": "058",
"amount_kobo": 15000000,
"status": "success",
"created_at": "2026-09-27T09:31:12"
} HOW IT WORKS
Confirm the account name with Verify before you pay.
Create the payment with an idempotency key of your own.
Read the final status, or receive it as a webhook.
WEBHOOKS
Each event is signed with HMAC SHA256 and carries an event id, so a repeat is easy to spot. Failed deliveries are retried six times over about a day.
payment.succeededThe money has left and landed.payment.failedThe payment did not go through.WHO BUILDS WITH IT
Pay a whole staff list, and know which salaries landed.
Settle marketplace sellers without paying anyone twice.
Let customers move their balance to their own bank.
QUESTIONS
Not yet. Developers build against the sandbox, which uses simulated customers and money. Live access opens after regulatory approval and a banking partnership are in place.
Tell us what you are building. We issue a test key for your organisation, and you can start calling the sandbox straight away.
Send it again with the same idempotency key. You get the first payment back, not a second one.
Every error has the same shape: a code, a message and a request id. Quote the request id when you contact us.
KEEP EXPLORING
Money APIs are available in the sandbox on request. Live access depends on regulatory approval and a banking partnership.