Local Payouts
Send domestic disbursements — single or in bulk — to bank accounts and mobile wallets, funded from your local-currency wallet.
1. List banks
GET /v1/banks?country=NG
Response · 200 OK
{
"data": [
{ "code": "058", "name": "Guaranty Trust Bank" },
{ "code": "044", "name": "Access Bank" },
{ "code": "057", "name": "Zenith Bank" }
]
}
2. Resolve the account
POST /v1/banks/resolve
Confirm the account name before paying out — show it to your user for confirmation.
cURL
curl https://api.finlogic.com/v1/banks/resolve \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "country": "NG", "bank_code": "058", "account_number": "0123456789" }'
Response · 200 OK
{ "account_number": "0123456789", "account_name": "ADAEZE OKAFOR", "bank_code": "058" }
3. Create the payout
POST /v1/payouts
cURL
curl https://api.finlogic.com/v1/payouts \
-H "Authorization: Bearer sk_test_..." \
-H "Idempotency-Key: 7d2f9e1a-..." \
-H "Content-Type: application/json" \
-d '{
"amount": 250000,
"currency": "NGN",
"bank_code": "058",
"account_number": "0123456789",
"narration": "June salary",
"reference": "SAL-0625-014"
}'
Response · 201 Created
{
"id": "po_4h8s2n1q",
"status": "processing",
"amount": 250000,
"currency": "NGN",
"account_name": "ADAEZE OKAFOR",
"reference": "SAL-0625-014",
"created_at": "2026-07-10T09:12:44Z"
}
4. Track status
GET /v1/payouts/{id}
| Status | Meaning |
|---|---|
| processing | Submitted to the local rail. |
| completed | Credited to the recipient. Most rails settle in seconds. |
| failed | Rejected by the destination bank — see failure_reason. Funds return to your wallet. |
Bulk payouts
POST /v1/payouts/batch
Send up to 1,000 payouts in one request. Each item carries its own reference; the batch returns a batch_id and per-item results, and each item fires its own payout.completed / payout.failed webhook.
References must be unique per payout. Reusing a reference returns
duplicate_transaction — this is your safety net against double disbursement.