# Validate Account

Check that a beneficiary bank account exists and, when a name is supplied, that it matches the account holder. India only (`country` must be `IND`).

Endpoint: POST /v3/validate_account
Version: 3.0.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `country` (string, required)
    Enum: "BGD", "IND", "PAK", "PHL", "NPL", "EGY", "VNM", "NGA"

  - `payment_type` (string)
    Who is paying whom: consumer or business, either side.
    Enum: "B2B", "B2C", "C2B", "C2C"

  - `account_number` (string, required)
    Bank account id of the beneficiary

  - `branch_code` (string, required)
    Bank branch code (IFSC code for India)

  - `beneficiary_name` (any)
    Bank account holder name, when known

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `country` (string, required)
    Enum: "BGD", "IND", "PAK", "PHL", "NPL", "EGY", "VNM", "NGA"

  - `account_number` (string, required)
    Bank account id of the beneficiary

  - `branch_code` (string, required)
    Bank branch code (IFSC code for India)

  - `status` (string, required)
    Result of a beneficiary account check.
    Enum: "valid", "invalid", "nre", "pending"

  - `name` (any)
    Account holder name reported by the backend

## Response 400:

  - `400` (unknown)
    Bad data in the request

## Response 400 fields (application/problem+json):

  - `type` (string, required)

  - `title` (string, required)

  - `status` (integer, required)

  - `detail` (any)

  - `instance` (any)

## Response 401:

  - `401` (unknown)
    Access token not valid or expired

## Response 401 fields (application/problem+json):

  - `type` (string, required)

  - `title` (string, required)

  - `status` (integer, required)

  - `detail` (any)

  - `instance` (any)

## Response 403:

  - `403` (unknown)
    Access token missing permissions to access the resource

## Response 403 fields (application/problem+json):

  - `type` (string, required)

  - `title` (string, required)

  - `status` (integer, required)

  - `detail` (any)

  - `instance` (any)

## Response 404:

  - `404` (unknown)
    Requested resource not found

## Response 404 fields (application/problem+json):

  - `type` (string, required)

  - `title` (string, required)

  - `status` (integer, required)

  - `detail` (any)

  - `instance` (any)

## Response 422:

  - `422` (unknown)
    One or more request fields are invalid

## Response 422 fields (application/problem+json):

  - `type` (string, required)

  - `title` (string, required)

  - `status` (integer, required)

  - `detail` (any)

  - `instance` (any)

  - `errors` (array, required)

  - `errors.detail` (string, required)

  - `errors.pointer` (string, required)

  - `errors.code` (any)

  - `errors.input` (any)

## Response 429:

  - `429` (unknown)
    Request rate too high; back off and retry. Where a `retry-after` response header is present it gives the seconds to wait.

## Response 429 fields (application/problem+json):

  - `type` (string, required)

  - `title` (string, required)

  - `status` (integer, required)

  - `detail` (any)

  - `instance` (any)

## Response 429 headers (application/problem+json):

  - `retry-after` (integer)
    Seconds to wait before retrying this request.

## Response 500:

  - `500` (unknown)
    Internal server error (contact administrator)

## Response 500 fields (application/problem+json):

  - `type` (string, required)

  - `title` (string, required)

  - `status` (integer, required)

  - `detail` (any)

  - `instance` (any)