Create Virtual Account

Request

Body Params application/json

AccountInput type

onBehalfOf

string | null

optional

Subclient UUID (only needed when creating account on behalf of a subclient)

currencyIso3Code

string

required

Account currency (required)

accountName

string

required

Account name (required)

<= 70 characters

Match pattern:

^[A-Za-z0-9\s().-]+$

uniqueRequestId

string

required

Unique id for idempotency

<= 100 characters

email

string

optional

email (optional), first request uses the email associated with the profile, subsequent request must include email in order to ensure new virtuaal account is created, else it will return the previously created virtual account

Example

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

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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

AccountOutput type

entityId

string

optional

Account id

currencyIso3Code

string

optional

Account currency

accountName

string

optional

Account name

fundingDetails

array [object {5}]

optional

Account funding details (SSIs)

bankOrSortCode

string

optional

Bank code e.g. SWIFT BIC, sort code, routing code

accountNumber

string

optional

Account number

bankCountry

string

optional

Bank country

bankName

string

optional

Bank name

bankAddress

string

optional

Bank address

status

enum<string>

optional

Account status

Allowed values:

processingactivedisconnecteddisabledfailed

availableBalance

number

optional

Available balance

accountType

enum<string>

optional

Account type

Allowed values:

multigatelinked

Example

{
  "entityId": "MeMjZgLaixUunSHLRqP9d",
  "currencyIso3Code": "NGN",
  "accountName": "ABC Limited",
  "fundingDetails": [],
  "status": "processing",
  "availableBalance": 0,
  "accountType": "multigate"
}

🟠400Bad Request

🟠401Unauthorized