Validate Bank Account | Riverty Docs

Path

POST /api/v3/validate/bank-account

Request Body

application/json

bankAccount

required

string

> 34 Characters

Account number

bankCode

string

> 11 Characters

Account swift number

bankNumber

string

> 50 Characters

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:

Language code

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"
  }
 ]
}