Create Virtual Account

POST

/client-service/api/v1/accounts

Create a new virtual account.

Request

Body Params application/json

Example

{
    "onBehalfOf": null,
    "currencyIso3Code": "NGN",
    "accountName": "ABC Limited",
    "uniqueRequestId": "24d564a9-f45a-44d2-9b31-340bdb8d92a1",
    "email": "not_email@email.com",
    "partnerCodes": [
        "214",
        "057"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api-gateway-uat.mmacs.io/platform/client-service/api/v1/accounts' \
--header 'Content-Type: application/json' \
--data-raw '{
    "onBehalfOf": null,
    "currencyIso3Code": "NGN",
    "accountName": "ABC Limited",
    "uniqueRequestId": "24d564a9-f45a-44d2-9b31-340bdb8d92a1",
    "email": "not_email@email.com",
    "partnerCodes": [
        "214",
        "057"
    ]
}'

Responses

🟢200OK

application/json

success response

Bodyapplication/json

Examples

SuccessDuplicate uniqueRequestId

{
    "message": "account created",
    "account": {
        "accountId": "2WCK3respo6qoTOtF76iH",
        "clientId": "ZnEzkE9tIQE_tOdPZ5i_Q",
        "uniqueRequestId": "9ef5e9f5-6e1f-49c7-821d-3ae6286c48b9",
        "currencyIso3Code": "NGN",
        "accountName": "Liveness Check Dec 16 API",
        "status": "active",
        "accountType": "wallet",
        "fundingDetails": [
            {
                "accountName": "Multigate Test Buyer",
                "bankOrSortCode": "214",
                "bic": "FCMBNGLA",
                "accountNumber": "8700002499",
                "bankCountry": "NGA",
                "bankName": "FCMB",
                "bankAddress": "Primrose Tower, 17A, Tinubu Street, Marina, Lagos",
                "countryIso3Code": "NGA"
            },
            {
                "accountName": "Multigate Test Buyer",
                "bankOrSortCode": "057",
                "bic": "ZEIBNGLA",
                "accountNumber": "1285507215",
                "bankCountry": "NGA",
                "bankName": "Zenith Bank Plc",
                "bankAddress": "Plot 84/87, Ajose Adeogun Street, Victoria Island, Lagos, Nigeria",
                "countryIso3Code": "NGA"
            }
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2026-05-29 06:02:04

Download statement

Get Account