POST
/
wallets
/
add
curl --request POST \
  --url https://waas-staging.cafeone.ng/api/v1/wallets/add \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "id": "<string>",
  "walletGroupId": "<string>",
  "customerId": "<string>",
  "availableBalance": 123,
  "ledgerBalance": 123,
  "walletRestrictionId": "<string>",
  "walletClassificationId": "<string>",
  "currencyId": "<string>",
  "isInternal": true,
  "isDefault": true,
  "name": "<string>",
  "overdraft": 123,
  "virtualAccount": {},
  "mobNum": "<string>",
  "customerTypeId": "<string>"
}'

​
Request Body

​
id
string

Unique identifier for the wallet. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
walletGroupId
string

The ID of the wallet group this wallet belongs to. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
customerId
string
required

The ID of the customer who owns this wallet. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
availableBalance
number

The balance available for transactions. Example: 23444440

​
ledgerBalance
number

The total balance including pending transactions. Example: 500000

​
walletRestrictionId
string

ID referencing wallet restrictions. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
walletClassificationId
string

ID referencing wallet classification. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
currencyId
string
required

ID of the currency for this wallet. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
isInternal
boolean

Whether this is an internal wallet. Example: true

​
isDefault
boolean

Whether this is the default wallet for the customer. Example: true

​
name
string
required

Name of the wallet or wallet owner. Example: “Emmanuel Emah”

​
overdraft
number

Available overdraft amount, if any. Example: 0

​
virtualAccount
object

Virtual account details associated with the wallet.

​
mobNum
string

Mobile number associated with the wallet. Example: “2345678880”

​
customerTypeId
string

ID referencing the customer type. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
Response

✅ Success Response Status Code: 201 Created

{
  "message": "Wallet created successfully.",
  "walletId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "virtualAccount": {
    "accountNumber": "9710000498",
    "bankCode": "232",
    "bankName": "Sterling"
  },
  "mobNum": "2345678880"
}