POST /v1/customers/{id}/virtual-account Bearer Idempotent

Issue customer bank account

Issues (or returns) one ACTIVE dedicated static bank account for the customer. Cap applies per merchant (default 1000 active customer accounts). Requires Static VA.

Path parameters

id required string

Headers

Idempotency-Key required string: Required for money-moving and session/mandate creates; replays must use the same body.

POST https://omni.mojo-pay.com/v1/customers/{id}/virtual-account

[]

curl -X POST "https://omni.mojo-pay.com/v1/customers/{id}/virtual-account" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '[]'

Response

{
    "object": "virtual_account",
    "customer_id": "MC_PAYMENTS01",
    "virtual_account": {
        "account_number": "6200889900",
        "account_name": "Ama Customer",
        "account_type": "STATIC",
        "bank_code": "300325",
        "bank_name": "UNITED BANK FOR AFRICA (GH) LTD",
        "status": "ACTIVE",
        "expires_at": null,
        "single_deposit_limit": null
    }
}