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.

Remember:

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 https://api.blochq.io/v1/wallets/{{customerID}} \
     --header 'accept: application/json' \
     --header 'authorization: Bearer sk_live_64520e0201478f5cd412865f64520e0201478f5cd4128660' \
     --header 'content-type: application/json'

Attribute	Required?	Description
customer_id	Yes	This 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"
}

Attribute	Type	Description
success	boolean	Lets you know that the API request was successful
data	object	Contains all of the attributes owned by the wallet you've just created.
id	string	The unique id of the wallet
name	string	Name of the collection account created for the wallet
created_at	string	Time the wallet was created.
account_number	string	Account number of the collection account created
bank_name	string	Bank name of the collection account created
balance	integer	The current balance of the wallet.
message	string	Summarizes 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.