Validate Bank Account

Validates and evaluates the account and bank details in the context of direct debit payment. It is possible to transfer either the combination of BankCode and AccountNumber or IBAN and BIC

Path

POST /api/v3/validate/bank-account

Request Body

application/json

bankAccount

required

string

Max length: 34

Account number

bankCode

string

Max length: 11

Account swift number

bankNumber

string

Max length: 50

Bank and branch identifier

createToken

boolean

nonce

string

Unique string provided by Riverty if the merchant is using Hosted Fields. Contact your Key Account Manager for more details.

conversationLanguage

string

Enum:

The language code used for client communication. If not provided, the system will default to the language configured for the client.

Responses

Successful Request, Valid Account

Successful Request, Invalid Account

Request Example

    
        {
 "bankAccount": "DE75512108001245126199"
}

Response Example

    
        {
 "isValid": true
}

Request Example

    
        {
 "bankAccount": "DE75512108001245126198"
}

Response Example

    
        {
 "isValid": false,
 "riskCheckMessages": [
  {
   "type": "BusinessError",
   "code": "200.908",
   "message": "Value format is incorrect.",
   "customerFacingMessage": "Die eingegebenen Bankdaten sind ungültig, bitte überprüfen und korrigieren.",
   "actionCode": "AskConsumerToReEnterData",
   "fieldReference": "bankAccount"
  }
 ]
}