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: 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

​
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.