Create Virtual Account
Both create virtual endpoints are designed to create both dynamic & static wallet on the VantPay platform for collection purposes.
Create Static Account
BVN: Customer’s Bank Verification Number. This is a mandatory field required for identity validation and for the creation of a static virtual account.Prefix: Merchant-specific prefix assigned by the system. This mandatory field is used in generating the customer’s virtual account number.TerminalId: Unique identifier of the merchant’s terminal or channel initiating the request. Used in identifying POS transaction and routing (Optional).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).IsPos: Boolean flag indicating whether the account is to be used on a POS terminal (Optional).true – Transaction initiated via POSfalse – Transaction initiated via a non-POS channelCreate Dynamic Account
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.This type of account has a configurable validity period and expires after the defined timeframe.
Modified at 2026-02-26 02:43:09