Skip to main content

​
Supported Currencies

The Swerv Payouts API currently supports the following currencies: • Nigerian Naira (NGN) • United States Dollar (USD) (🚧 Coming Soon) • Euro (EUR) (🚧 Coming Soon) • British Pound (GBP) (🚧 Coming Soon)

​
Supported Banks for Naira Bank Transfer

The Swerv Payouts API currently supports the following banks for Naira Bank Transfer:
Bank NameBank Code
Access Bank044
Citibank023
Diamond Bank063
Ecobank Nigeria050
Fidelity Bank Nigeria070
First Bank of Nigeria011
First City Monument Bank214
Guaranty Trust Bank058
Retrieve the full list of supported banks using the list banks endpoint.

​
Create a Payout

To initiate a payout, use the create payout endpoint. This method allows you to send funds to a specified bank account. We currently support: • Naira Bank Transfer Parameters
​
bank_code
string
required
A unique bank code.
​
account_number
string
required
The recipient’s bank account number.
​
amount
integer
required
The total payout amount in the smallest currency unit (e.g., cents, kobo).
​
currency
string
required
The three-letter ISO currency code in uppercase.
​
reference
string
A unique identifier for the transaction.
​
narration
string
A description for the transaction, to appear on the recipient’s statement.
Request Body Provide details of the payout, including the recipient’s bank information, amount, and currency
Request Body
{
  "bank_code": "059",
  "account_number": "0690000000",
  "amount": 8500,
  "currency": "NGN",
  "reference": "reference",
  "naration": "narration",
}

​
Get a Payout

Retrieve details of a specific payout using its unique ID with the get payout endpoint. Path Parameters
​
id
string
required
The unique identifier of the payout to retrieve.