create-dynamic-account

This endpoint enables the creation of dynamic virtual accounts on the VantPay platform for collection purposes.

Descriptions for each field:

Prefix:
Merchant-specific prefix assigned by the system. This mandatory field is used in generating the customer’s virtual account number.

Amount:
Transaction amount to be processed, expressed in the lowest currency denomination where applicable. Must be greater than zero if amount validation is enabled on the prefix (Optional).

FirstName:
Customer’s first name as it appears on official records. This field is mandatory for account identification and record creation.

LastName:
Customer’s surname/last name as it appears on official records. This field is mandatory for proper customer identification.

PhoneNumber:
Customer’s valid and active mobile number. Used for communication, transaction notifications, and account association. Must be in a valid format.

NB:
This type of account has a configurable validity period and expires after the defined timeframe.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://digitvirtual-dev.digitvant.com/api/v1/virtual-accounts/create/dynamic' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "firstName": "Orji", "lastName": "Nelson", "phoneNumber": "09088888888", "amount": 0, "prefix": "311", "validityMinutes": 0 }'

Request

Responses