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"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '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"
}'

Responses

🟢200OK

application/json

success response

Body

Example

{
    "message": "account created",
    "account": {
        "entityId": "a3PEjoHafbKUrkGg4_JhK",
        "currencyIso3Code": "NGN",
        "accountName": "Test Account 1",
        "status": "active",
        "accountType": "multigate",
        "fundingDetails": [
            {
                "bankOrSortCode": "214",
                "accountNumber": "1000062929",
                "bankCountry": "NGA",
                "bankName": "FCMB",
                "bankAddress": null,
                "countryIso3Code": "NGA"
            }
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-04-17 15:04:34

Download statement

Get Account