Support
Products

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}
StatusMeaning
processingSubmitted to the local rail.
completedCredited to the recipient. Most rails settle in seconds.
failedRejected 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.