The Wallet Model

A wallet is an account that stores cash, it has a bank account number, and money paid into this bank account number comes to the wallet directly. Wallets have currencies attached to them, making it possible to provide a user with a USD wallet or NGN wallet, or other currencies. The currencies you can assign to your users will be dependent on what has been enabled for you on the Embed API.

Note
Wallets are not created by default on the production environment. After creating and verifying an account you’ll need to make an API call to create the user’s wallet.

To create a wallet for a user, please make a request to this endpoint

{
  "wallet_id": "40bfc3a8797ffc4f61c4a749cbf57852",
  "account_id": "c6d4696eb3f0a8fa14d1db540ae03866",
  "name": "USD-Wallet",
  "bank_name": "",
  "product_code": "PRC7236DE330373",
  "created_on": "2022-08-16T17:03:04.018069+00:00",
  "currency": "USD",
  "balance": "0.00000",
  "account_number": "",
  "account_name": ""
}
Sample Wallet Model

Attributes

wallet_id
string
unique identifier of wallet
account_id
string
unique identifier of wallet owner's account
name
string
user specified wallet name
product_code
string
auto generated product code
currency
string
the currency code which follows ISO-4217 standard
balance
string
wallet balance
account_number
string
wallet account number
account_name
string
name of wallet account number
bank_name
string
bank name of wallet account number
created_on
string
wallet creation date