Api Documentation

Nigeria Collections — Virtual Account `300041`

Overview

Nigeria payins use a dynamic virtual bank account. After initiation, the customer transfers the exact amount to the account details returned in the API response.

Channel: 300041
Currency: NGN

See also: NIGERIA INTEGRATION GUIDE for other supported payment methods in Nigeria

Endpoint

Method	POST
URL	`/api/v2/payment/`
Channel	`300041`
Currency	`NGN`

Integration Flow

POST with channel 300041 and currency NGN.
Receive virtual_account in the response (account_number, bank_name, amount).
Display funding instructions to the customer.
Customer completes a bank transfer to the virtual account.
Receive final status on your result_url webhook.

Request Fields

Field	Required	Notes
`acc_name`	Yes	Customer full name
`acc_no`	Yes	Customer phone (e.g. `08012345678`)
`email`	Yes	Customer email
`amount`	Yes	Exact amount customer must transfer
`bank_code`	No	VA provider bank (default `1067`)

Example Request

{
    "wallet_no": "XXXXXXX",
    "reference": "CORNGN0089123036",
    "acc_name": "test",
    "acc_no": "08012345678",
    "email": "customer@example.com",
    "currency": "NGN",
    "amount": 5000,
    "channel": 300041,
    "description": "Order payment",
    "result_url": "https://your-server.com/webhook"
}

Example Response

{
    "success": true,
    "message": "Successfully initiated",
    "data": {
        "acc_name": "Test Customer",
        "acc_no": "1234876588",
        "description": "Order payment",
        "transaction_id": "126072834240",
        "reference": "CORNGN0089123036",
        "status": "PROCESSING",
        "amount": 5000,
        "charges": 0,
        "currency": "NGN",
        "status_description": "Account generated successfully",
        "date": "2026-07-28 13:23:15 PM",
        "fetched_at": "2026-07-28 13:23:21 PM",
        "virtual_account": {
            "account_number": "123456789",
            "account_name": "account-name",
            "bank_name": "bank-name",
            "expires": "2026-07-28 12:23:21 PM"
        }
    }
}

Nigeria Collections — Virtual Account 300041