Create a Dynamic Virtual Account

Dynamic (Temporary) virtual accounts are useful for receiving one-off payments via bank transfer. When the customer is checking out, you generate a temporary virtual account with a fixed amount and provide it to them. When they make payment, we'll send you a webhook and you can handle it.

You can create a Dynamic Virtual account with the create virtual account number endpoint.

❗️

Timer on Dynamic Virtual Accounts

Dynamic Virtual Accounts have a default time of 10mins, after which they are automatically disabled.

Make a POST request to this endpoint

JSON

https://baseURL/fintech/api/v1/account/assignDynamicAccount

Body Parameters

JSON

{
  "accountName": "Test account",
  "bvn": "22222222211",
  "accountUserNatureOfBusiness": "Grocery",
  "bankCode": "101",
  "accountType": "One time",
  "amount": "100",
  "transactionReference": "537465873946"
}

Response

JSON

{
    "requestSuccessful": true,
    "responseMessage": "Dynamic Account Generated Successfully",
    "responseCode": "00",
    "responseBody": {
	"accountNumber":"9945634562",
        "accountName": "(MERCHANT)Botaj",
	"transactionReference": "537465873946"
    }
}