curl --request POST \
--url https://api.payaza.africa/live/merchant-collection/merchant/virtual_account/generate_virtual_account \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"account_name": "Test DVA",
"account_type": "Dynamic",
"bank_code": "140",
"has_amount_validation": "true",
"account_reference": "Ref123456780",
"customer_first_name": "John",
"customer_last_name": "Doe",
"customer_email": "johndoe@gmail.com",
"customer_phone_number": "07012345678",
"transaction_description": "Test Description",
"transaction_amount": 1000,
"expires_in_minutes": 20
}
'{
"message": "Virtual Account generated successfully",
"data": {
"account_name": "Payaza(Test DVA)",
"account_number": "3340009013",
"account_type": "Dynamic",
"bank_name": "GLOBUS BANK",
"account_reference": "accRef123",
"account_expired": false,
"message": "Virtual Account generated successfully",
"transaction_id": 49555930,
"transaction_amount_payable": 100,
"transaction_reference": "accRef123",
"expires_in_minutes": 20
},
"success": true
}Virtual Accounts
Create Static/Dynamic Virtual Account
This API endpoint allows you to create dynamic virtual accounts with a duration of 30 mins and reserved/static virtual accounts that are permanent. Our virtual accounts guide can be found here
POST
/
merchant-collection
/
merchant
/
virtual_account
/
generate_virtual_account
curl --request POST \
--url https://api.payaza.africa/live/merchant-collection/merchant/virtual_account/generate_virtual_account \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"account_name": "Test DVA",
"account_type": "Dynamic",
"bank_code": "140",
"has_amount_validation": "true",
"account_reference": "Ref123456780",
"customer_first_name": "John",
"customer_last_name": "Doe",
"customer_email": "johndoe@gmail.com",
"customer_phone_number": "07012345678",
"transaction_description": "Test Description",
"transaction_amount": 1000,
"expires_in_minutes": 20
}
'{
"message": "Virtual Account generated successfully",
"data": {
"account_name": "Payaza(Test DVA)",
"account_number": "3340009013",
"account_type": "Dynamic",
"bank_name": "GLOBUS BANK",
"account_reference": "accRef123",
"account_expired": false,
"message": "Virtual Account generated successfully",
"transaction_id": 49555930,
"transaction_amount_payable": 100,
"transaction_reference": "accRef123",
"expires_in_minutes": 20
},
"success": true
}Body
application/json
- Create Dynamic Virtual Account Request
- Create Static Virtual Account Request
Response
Account generated successfully