Skip to main content

​
The fiat account object

A fiat settlement account is a saved bank account linked to your business profile. Once added, it can be used as a payout destination for fiat withdrawals.
​
id
string
Unique identifier for the fiat settlement account.
​
bankName
string
Name of the bank (e.g. “Access Bank”).
​
bankCode
string
Bank code used for transfers (e.g. “044”).
​
accountName
string
Name on the bank account.
​
accountNumber
string
Bank account number.
​
isPrimary
boolean
Whether this is the primary settlement account for the profile. Only one account can be primary.
​
profileId
string
Business profile that owns this settlement account.
{
  "id": "f3a1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
  "bankName": "Access Bank",
  "bankCode": "044",
  "accountName": "Chidi and Co.",
  "accountNumber": "0123456789",
  "isPrimary": true,
  "profileId": "84a9f045-8a21-4ce4-a7a0-828265c0021b"
}
Fiat settlements are coming soon. The endpoints below are planned and not yet available.

​
Planned endpoints

MethodEndpointDescription
GET/settlement/fiat/bank-listList supported banks
POST/settlement/fiat/addAdd a bank account
GET/settlement/fiatList saved bank accounts
PATCH/settlement/fiat/{id}Update a bank account
DELETE/settlement/fiat/{id}Remove a bank account
Stay tuned — we will update this page when fiat settlements launch. In the meantime, use Crypto Settlements for payouts.