Create a wallet

Create a digital wallet.

Every digital wallet has a virtual account number attached

When you create a digital wallet via the API, we automatically create a Customer using the same information and attach a wallet.




Authorization string

set value to Bearer SECRET_KEY

Body Param

business_id string required

Business ID

first_name string required

Customer's first name

last_name string required

Customer's last name

phone_number string required

Customer's phone number

email string required

Customer's email address

bvn string

Customer's bank verification number

metadata string

Customer's specific data - Stringified JSON

preferred_banks array

List of customer's preferred banks

Sample request

curl --location --request POST '' \
--header 'Authorization: Bearer SECRET_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
   "business_id": {YOUR_VALUE},
   "first_name": "John",
   "last_name": "Bellion",
   "email": "",
   "bvn": "23835759875",
   "metadata": "{'invoice_id': '11973600964773'}",
   "preferred_banks": [
           "bank_code": "111",
           "bank_name": "Wema Bank",
           "id": "wema"

Duplo Response

  "data": {
    "wallet_ref": "wal_7sdgewehe8",
    "first_name": "Manny",
    "last_name": "Norte",
    "email": "",
    "created_at": "2021-09-28T20:28:47.000Z",
    "currency": "NGN",
    "status": "active",
    "is_master": true,
    "available_balance": "0.00",
    "legder_balance": "0.00",
    "opening_balance": "0.00",
    "closing_balance": "0.00",
    "bank_accounts": [
        "account_ref": "act_gd53hs7enw3",
        "account_number": "9977658661",
        "created_at": "2021-09-28T20:28:47.000Z",
        "account_name": "MERCHANT(Manny Norte)",
        "provider": {
          "bank_code": "022",
          "bank_name": "wema",
          "id": "wema",
          "default": true
  "errors": {},
  "message": "Wallet created successfully"

Last updated