Products

Transfers and payouts

Send naira to any Nigerian bank account, one at a time or up to 500 at once. Every name is checked first.

Transfers (and Payouts) is switched on by request. Ask from Settings › Products and access; once approved it works in test and live mode. Until then the API answers 403 with the code shown below.

Check the account

GET/v1/banks lists bank codes. POST/v1/banks/resolve with bank_code and account_number returns the account name.

One transfer

curl https://api.paygenthq.ai/v1/transfers \
  -H "Authorization: Bearer sk_test_…" -H "Idempotency-Key: pay-3391" \
  -d bank_code=058 -d account_number=0123456789 \
  -d amount=500000 -d account_name="Kitchen Hub Ltd" -d reference=pay-3391

If you send account_name, the transfer is refused (name_mismatch) when the bank's name for the account doesn't match. The amount and our fee leave your available balance at once; transfer.success or transfer.failed follows. A failed transfer's money comes back.

Bulk

POST/v1/transfers/bulk with { "name": "November salaries", "transfers": [ … ] }: up to 500, each like a single transfer. Every account is checked first; if any row is wrong, nothing is sent and rows_invalid lists the rows.

Payouts to your own bank

POST/v1/payouts sends your available balance (or amount) to the settlement account set in the dashboard. Payouts to your own account have no fee. You can also turn on nightly payouts. Events: payout.paid, payout.failed.

Not switched on: 403 transfers_not_enabled or payouts_not_enabled.