Supported Currencies
The examples in this guide use Nigerian Naira (NGN) bank transfers. Confirm the currencies enabled for your business before creating a payout. • Nigerian Naira (NGN)Example bank codes for Naira transfers
These are example Nigerian bank codes. Bank codes can change, so use the list banks endpoint for the complete, current list before presenting a bank selector to your users:
Retrieve the full list of supported banks and their current codes using the list banks endpoint instead of maintaining a hard-coded list in your integration.
Create a Payout
To initiate a payout, use the create payout endpoint. This sends funds to a specified bank account. The example below covers a Naira bank transfer: • Naira Bank Transfer Parametersstring
required
A unique bank code.
string
required
The recipient’s bank account number.
number
required
The total payout amount in the smallest currency unit (e.g., cents, kobo).
string
required
The three-letter ISO currency code in uppercase.
string
A unique identifier for the transaction.
string
A description for the transaction, to appear on the recipient’s statement.
Request Body Provide the recipient’s bank information, amount, currency, and an optional reference or narration.
Request Body
Get a Payout
Retrieve the current status and details of a specific payout using its unique ID with the get payout endpoint. Path Parametersstring
required
The unique identifier of the payout to retrieve.