Create a wallet
Create a digital wallet and associate a virtual account with it.
POST
https://api.tryduplo.com/v1/wallets
Parameter
Field
Type
Description
email
String
Valid user's email address
bvn
String
Valid Bank Verification Number.
phonenumber (optional)
String
A valid phone number
first_name
String
User's first name
last_name
String
User's last name
currency (optional)
String
Preferred currency code (in ISO three-letter format i.e NGN)
preferred_banks
Array
Codes of preferred banks in order of preference
fallback_bank
(optional)
(optional)
Boolean
Use any available bank if none of the preferred_banks is available
Default value: true
Default value: true
metadata
(optional)
(optional)
Object
Additional details
curl --location --request POST 'https://api.duplo.com/wallets' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer dp_test_P2tH90snfuQB0qlPopnhdgkOpbs' \
--data-raw '{
"email": "try@duplo.com",
"bvn": "16048672904",
"phonenumber": "09029308134",
"first_name": "Victor",
"last_name": "Alade"
}'
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer dp_test_P2tH90snfuQB0qlPopnhdgkOpbs' \
--data-raw '{
"email": "try@duplo.com",
"bvn": "16048672904",
"phonenumber": "09029308134",
"first_name": "Victor",
"last_name": "Alade"
}'
const duplo = require('duplo')('dp_test_P2tH90snfuQB0qlPopnhdgkOpbs');
const virtualAccount = await duplo.wallets.create({
email: 'try@duplo.com',
bvn: '16048672904',
phonenumber: '09029308134',
first_name: 'Victor',
last_name: 'Alade'
});
const virtualAccount = await duplo.wallets.create({
email: 'try@duplo.com',
bvn: '16048672904',
phonenumber: '09029308134',
first_name: 'Victor',
last_name: 'Alade'
});
$duplo = new \Duplo\DuploClient(
'dp_test_P2tH90snfuQB0qlPopnhdgkOpbs'
);
$duplo->wallets->create(
[
'email'=> 'try@duplo.com',
'bvn' => '16048672904',
'phonenumber' => '09029308134',
'first_name' => 'Victor',
'last_name' => 'Alade'
]
);
'dp_test_P2tH90snfuQB0qlPopnhdgkOpbs'
);
$duplo->wallets->create(
[
'email'=> 'try@duplo.com',
'bvn' => '16048672904',
'phonenumber' => '09029308134',
'first_name' => 'Victor',
'last_name' => 'Alade'
]
);
200 OK
{
"data": {
"wallet_ref": "dp_wallet_7c443af256472ac95b68fc531bb545e6",
"first_name": "Victor",
"last_name": "Alade",
"email": "victor@duplo.com",
"created_at": "2021-08-09T12:06:19.000Z",
"currency": "NGN",
"status": "active",
"available_balance": "0.00",
"legder_balance": "0.00",
"bank_accounts": [
{
"account_ref": "dp_act_ab21b285350ae40d49034aebbcaa1a41",
"account_number": "9977633837",
"created_at": "2021-08-09T12:06:19.000Z",
"account_name": "MERCHANT(Victor Alade)",
"provider": {
"bank_code": "053",
"bank_name": "Providus",
"id": "providus",
"default": true
}
}
]
},
"errors": {},
"message": "wallet created successfully"
}
{
"data": {
"wallet_ref": "dp_wallet_7c443af256472ac95b68fc531bb545e6",
"first_name": "Victor",
"last_name": "Alade",
"email": "victor@duplo.com",
"created_at": "2021-08-09T12:06:19.000Z",
"currency": "NGN",
"status": "active",
"available_balance": "0.00",
"legder_balance": "0.00",
"bank_accounts": [
{
"account_ref": "dp_act_ab21b285350ae40d49034aebbcaa1a41",
"account_number": "9977633837",
"created_at": "2021-08-09T12:06:19.000Z",
"account_name": "MERCHANT(Victor Alade)",
"provider": {
"bank_code": "053",
"bank_name": "Providus",
"id": "providus",
"default": true
}
}
]
},
"errors": {},
"message": "wallet created successfully"
}
What’s Next?
Need Support?
Helpful resources while you’re building or for that tricky problem you might be having.
Go to Help Center
