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