Create a new virtual account

Post https://app.moneygraph.ai/api/v1/virtual/accounts/{customer}/create

Headers

Authorization* string

Pass your {api_key} as a bearer token in the request header to authorize this call

Path parameters

customer* string

Customer ID. The ID or MCP Key of the onboarded customer.

Body parameters

currency* string

Currency code in ISO 4217 format (3-letter code such as USD, EUR, GBP). The selected currency must be available for virtual accounts in the customer's registered country.

bvn* string

This is required if the currency is NGN.

Response


{
    "message": "Virtual account generated successfully",
    "status": "success",
    "data": {
        "id": "a7b3bd8a-9410-40ad-9a71-5411dwrfad7d",
        "account_status": "active",
        "account_number": "33433155552223444",
        "account_type": "CHECKING",
        "bank_name": "Olky Payment Service Provider S.A.",
        "currency": "GBP",
        "mode": "live",
        "created_at": "2025-07-20T02:28:28.360277Z"
    }
}