Skip to main content
POST
/
wallets
/
add
Create Wallet
curl --request POST \
  --url https://waas-staging.embedly.ng/api/v1/wallets/add \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "customerId": "<string>",
  "currencyId": "<string>",
  "name": "<string>"
}
'
{
	"message": "Wallet created successfully.",
	"walletId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
	"virtualAccount": {
		"accountNumber": "9710000498",
		"bankCode": "232",
		"bankName": "Sterling"
	},
	"mobNum": "2345678880"
}
To improve performance on your system, the upon successful creation of a wallet in favour of a customer, the returned walletId, accountNumber and bankCode should be stored in your database

​
Request Body

​
customerId
string
required
The ID of the customer who owns this wallet. (Must be a UUID) Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”
​
currencyId
string
required
ID of the currency for this wallet. (Must be a UUID) Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6” The value should be gotten from the get currency endpoint in the wallet utils section
​
name
string
required
Name of the wallet or wallet owner. Example: “Emmanuel Emah” This is an optional field
{
	"message": "Wallet created successfully.",
	"walletId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
	"virtualAccount": {
		"accountNumber": "9710000498",
		"bankCode": "232",
		"bankName": "Sterling"
	},
	"mobNum": "2345678880"
}