Sign in

v1

latestOpenAPI 3.0.12026-07-225791279.7 KB
Virtual Accounts

Create Reserved/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

Request body

OR

Example request

{
  "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"
}

Response

Transfer initiated successfully

OR

Example response

{
  "success": true,
  "message": "Virtual Account generated successfully",
  "data": {
    "account_name": "Payaza(Test DVA)",
    "account_number": "7000009348",
    "account_type": "Dynamic",
    "bank_name": "78 FINANCE COMPANY LIMITED",
    "account_reference": "Ref123456780",
    "transaction_id": 23366137,
    "transaction_amount_payable": 1000,
    "transaction_reference": "Ref123456780",
    "expires_in_minutes": 20
  }
}