Create a Wallet

Learn how to create a wallet

What this means

All wallets are created on top of your Main Balance. Your Main Balance serve as the bank account where all of the deposits and withdrawals happen for all wallets created.


Why this is important:

It is illegal for a non-banking institution to electronically hold money. You need a banking licence or a settlement account issued by a duly licensed bank to hold money.


  • When creating a wallet, you do not need to provide the full KYC details of the customer. All virtual accounts created for the purpose of funding the wallet are owned by the user.

Getting Started

All wallets must be owned by a customer. To create a wallet, call the endpoint URL below and pass the customer_id in the payload.

curl --request POST \
     --url{{customerID}} \
     --header 'accept: application/json' \
     --header 'authorization: Bearer sk_live_64520e0201478f5cd412865f64520e0201478f5cd4128660' \
     --header 'content-type: application/json'
customer_idYesThis is the unique id of the customer you want to create a wallet for.

Here's a sample response

  "success": true,
  "data": {
    "id": "645a1e0385b17f000a3052a2",
    "name": "Bloc Dashboard 240",
    "created_at": "2023-05-09T10:18:43.241568455Z",
    "account_number": "2010451356",
    "bank_name": "Banc Corp",
    "balance": 0
  "message": "wallet created"
successbooleanLets you know that the API request was successful
dataobjectContains all of the attributes owned by the wallet you've just created.
idstringThe unique id of the wallet
namestringName of the collection account created for the wallet
created_atstringTime the wallet was created.
account_numberstringAccount number of the collection account created
bank_namestringBank name of the collection account created
balanceintegerThe current balance of the wallet.
messagestringSummarizes the API response for your application.


Helpful Tip:

Every wallet created has a Collection Account automatically generated for funding and updating its balance via bank transfer.


Helpful Tip:

You can create as many wallets as you want for a customer.