Business Verification (B2B)

The B2B Virtual Account endpoint is designed for merchants serving registered companies. Unlike individual accounts, these accounts are branded with the company's registered business name, making them ideal for corporate invoicing and bulk collections.

Technical Note: Latency Handling

Business account verification involves real-time corporate database lookups. Merchants are advised to set a client-side timeout of 60-90 seconds for B2B requests to account for external registry verification.

Request Parameters

Set va_type to Business.

Field	Required	Description
action	Yes	Must be `create_va`
business_name	Yes	The legally registered name of the company.
customer_bvn	Yes	The 11-digit BVN of the business signatory.
customer_email	Yes	Corporate email for payment alerts.

B2B Implementation Example

JSON Request Payload

{
  "action": "create_va",
  "va_type": "Business",
  "business_name": "ReignHost Technologies LTD",
  "customer_email": "[email protected]",
  "customer_bvn": "22222222222"
}

Success Response

{
  "success": true,
  "message": "Virtual Account created successfully.",
  "data": {
      "account_number": "5395683527",
      "bank_name": "FinovoPay Partner Bank",
      "account_name": "REIGNHOST TECHNOLOGIES LTD",
      "reference": "BUS_6AB690DA"
  }
}