Virtual Account Generation

The Virtual Account endpoint allows merchants to instantly generate dedicated Nigerian bank account numbers (NUBAN) for their customers. Payments made into these accounts are instantly credited to the merchant's wallet balance.

Endpoint Details

Base URL https://merchant.finovopay.com/v1/index.php

Method POST

Request Parameters

Specify the va_type as Individual for standard B2C accounts.

Field	Required	Description
action	Yes	Set to `create_va`
customer_name	Yes	Full name of the customer.
customer_bvn	Yes	11-digit BVN for KYC verification.
customer_email	Yes	Primary email for notifications.

B2C Implementation Example

Request Body (JSON)

{
  "action": "create_va",
  "va_type": "Individual",
  "customer_name": "John Doe",
  "customer_email": "[email protected]",
  "customer_bvn": "22222222222"
}

Success Response

{
  "success": true,
  "message": "Virtual Account created successfully.",
  "data": {
      "account_number": "7154651263",
      "bank_name": "FinovoPay Partner Bank",
      "account_name": "FINOVOPAY/JOHN DOE",
      "reference": "CUST_BA7D649C"
  }
}

KYC Compliance

In accordance with CBN regulations, the customer_bvn provided is verified against the name in the national database. Mismatched records will result in a validation error. Ensure your users provide their legal names as registered on their BVN.