Validate Account Details

Endpoint

POST {{base_url}}/v1/accounts/validate

Description

This endpoint is used to validate a GBP or EUR account using the provided account details.

Request Body GBP

The request body should be a JSON object containing the following fields:

• Account Number: "00002120"

• SortCode: "041917"

• currency: "GBP"

Example Request

{
    "status": false,
    "message": "Failed to validate GBP account",
    "code": 500
}

Response

The API will return a JSON object containing a success message with "status": true when the parameters are correct, and an error message with "status": false when the parameters are incorrect.

GBP Response(Success Validation)

{
    "status": true,
    "message": "Account validation successful",
    "data": {
        "bankBic": "ARPY",
        "iban": "ARPY04191700002120",
        "bankName": "PRUNE PAYMENTS LTD",
        "bankTown": "London",
        "bankAddress": "35-37, Ludgate Hill Office 7 "
    },
    "code": 200
}

GBP Response(Failed validation)

Request Body EUR

The request body should be a JSON object containing the following fields:

• Iban: "00002120"

• BIC: "041917"

• currency: "EUR"

{
    "iban": "GB12045505050505424",
    "bic": "ARPYGB21",
    "currency": "EUR"
}

Response

The API will return a JSON object containing a success message with "status": true when the parameters are correct, and an error message with "status": false when the parameters are incorrect.

EUR Response(Success Validation)

{
    "status": true,
    "message": "Iban validated successfully",
    "data": {
        "bankName": "PRUNE PAYMENTS LTD",
        "bankBranch": "",
        "address": "OFFICE 7, 35-37 LUDGATE HILL",
        "city": "LONDON",
        "state": "",
        "country": "United Kingdom"
    },
    "code": 200
}

EUR Response (failed Validation)

Error

Include common error responses and their meanings.

• 400 Bad Request: Account can not be verified.

• 500 Internal Server Error: An error occurred on the server.