Create Virtual Account

Create a new virtual account request for receiving and managing transactions

/ request

POST https://staging-eagle.kongapay.com/request/knip/new-vir-account

This endpoint allows you to create a new virtual account

# Headers

Name	Type	Description
secret_key	string	Unique integration key
Content-Type	string	Set value to application/json

Request Body

Name	Type	Description
amount	string	Total transaction amount in kobo
reference	string	Unique identifier from client / kpay if not provided
account_name	string	Unique IBAN account
type	string	Type of Account-> * nonstatic * static-flex * static
callback_url	string	Webhook Notification

Response

{
    "status": "success",
    "message": "Generate New Virtual Account  request successful",
    "data": {
        "status": "success",
        "message": "",
        "data": {
            "account_number": "5005239003",
            "account_name": "AJibade Akanin",
            "reference": "KP-VIR-1751454667-IXCR",
            "Bank": "KongaPay OR Zinternet",
            "external_reference": "CH-202503231316-PSWRF-KP",
            "status": "active"
        }
    },
    "request_id": 79480
}

Request

{
    "account_name": "AJibade Akanin",
    "reference": "CH-202504231314-PSWRF-KP",
    "type":"static-flex"
}