Create a wallet
curl --request POST \
--url https://{host}/v1/wallets \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "Lekki branch",
"fee_bearer": "business"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
customer_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
label: 'Lekki branch',
fee_bearer: 'business'
})
};
fetch('https://{host}/v1/wallets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/v1/wallets"
payload = {
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "Lekki branch",
"fee_bearer": "business"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_number": "<string>",
"account_name": "<string>",
"purpose": "<string>",
"owner_type": "<string>",
"status": "<string>",
"fee_bearer": "business",
"received_minor": 123,
"created_at": "2023-11-07T05:31:56Z",
"name_status": "<string>",
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "Lekki branch",
"tier": "<string>",
"tier_at_issue": "<string>",
"limits": {
"max_single_txn_minor": 123,
"max_daily_credit_minor": 123,
"max_daily_debit_minor": 123,
"max_balance_minor": 123
},
"product": "<string>"
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"fields": {}
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}Wallets
Create a wallet
Opens a wallet: for a customer (named after them; the customer must be registered with the bank, and an open business’s needs KYC tier 1), or one of the business’s own with a label. A retry with the same Idempotency-Key and body returns the same wallet.
Required permission: feature:WALLETS, wallets:write
POST
/
v1
/
wallets
Create a wallet
curl --request POST \
--url https://{host}/v1/wallets \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "Lekki branch",
"fee_bearer": "business"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
customer_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
label: 'Lekki branch',
fee_bearer: 'business'
})
};
fetch('https://{host}/v1/wallets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/v1/wallets"
payload = {
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "Lekki branch",
"fee_bearer": "business"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_number": "<string>",
"account_name": "<string>",
"purpose": "<string>",
"owner_type": "<string>",
"status": "<string>",
"fee_bearer": "business",
"received_minor": 123,
"created_at": "2023-11-07T05:31:56Z",
"name_status": "<string>",
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "Lekki branch",
"tier": "<string>",
"tier_at_issue": "<string>",
"limits": {
"max_single_txn_minor": 123,
"max_daily_credit_minor": 123,
"max_daily_debit_minor": 123,
"max_balance_minor": 123
},
"product": "<string>"
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"fields": {}
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}Authorizations
Headers
Body
application/json