Virtual Accounts

For merchants utilizing the wallet service, you can create virtual accounts for your customers. To initiate the virtual account creation, please include all the necessary parameters listed below in your request.

Parameters:

Endpoint: POST - {{baseUrl}/payment/virtual-account/create

Example Payload:

{
    "private_key": "PUB_0000000",
    "first_name": "Mic",
    "last_name": "Testing",
    "phone": "000000000",
    "email": "[e-mail]"

Success Response

{
    "status": true,
    "message": "Customer created successfully",
    "data": {
        "wallet_id": "W00000000",
        "customer_id": "CUS000000",
        "customer_email": "[e-mail]",
        "account_name": "CR| Mic Testing",
        "account_number": "1111111111",
        "bank_name": "WEMA",
        "credit": 0,
        "debit": 0,
        "balance": 0,
        "virtual_accounts": [
            {
                "id": "VA0000000",
                "wallet_id": "W00000000",
                "name": "Mic Testing",
                "first_name": "Mic",
                "last_name": "Testing",
                "phone": "000000000",
                "email": "[e-mail]",
                "account_name": "MC| Mic Testing",
                "account_number": "1111111111",
                "bank_name": "WEMA",
                "account_type": "STANDARD",
                "service_provider": "provider",
                "status": "ACTIVE",
                "expiry_date": null,
                "created_at": "2023-11-06 12:05:15",
                "updated_at": "2023-11-06 12:05:15",
                "account_reference": null
            }
        ],
        "reference": "REF0000000000"
    }
}

Failed Response

{
    "status": false,
    "message": "Invalid Authorization key"
}