Multigate

Validate Beneficiary Account (NGN only)

POST

/client-service/api/v1/beneficiaries/validate

Beneficiary

Request

Body Params application/json

BeneficiaryLookUpInput type

bankAccountNumber

string

optional

The client profile UUID (optional)

countryIso3Code

string

optional

Account currency (required)

currencyIso3Code

string

optional

Account Name (required)

bankCode

string

optional

Account country (optional)

Example

{
  "bankAccountNumber": "string",
  "countryIso3Code": "string",
  "currencyIso3Code": "string",
  "bankCode": "string"
}

Request 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/beneficiaries/validate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bankAccountNumber": "string",
    "countryIso3Code": "string",
    "currencyIso3Code": "string",
    "bankCode": "string"
}'

Responses

🟢200OK

application/json

success response

Body

BeneficiaryLookUpOutput type

accountName

string

optional

The client profile UUID (optional)

bankName

string

optional

Account currency (required)

Example

{
  "accountName": "string",
  "bankName": "string"
}

🟠400Bad Request

🟠401Unauthorized

Update Beneficiary

Create Single Transfer