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 > 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:NOSVFIDAENDENLFR

Language code

Responses

200 Success

RESPONSE SCHEMA:

isValid

boolean

Is response valid

token

string

400 Model validation failed.

RESPONSE SCHEMA:

Array () [
type

string

Enum:BusinessErrorTechnicalErrorNotificationMessage

code

string > 100 Characters

Confirmation or error code

message

string > 4096 Characters

Message content

customerFacingMessage

string > 4096 Characters

Message to display to customer

actionCode

string

Enum:UnavailableAskConsumerToConfirmAskConsumerToReEnterDataOfferSecurePaymentMethodsRequiresSsnAskConsumerToIdentify

Action codes

fieldReference

string > 100 Characters

Reference to field that caused an error

]
401 Authorization has been denied for this request.

RESPONSE SCHEMA:

type

string

title

string

status

integer <int32>

detail

string

instance

string

429 Too many requests.

RESPONSE SCHEMA:

type

string

title

string

status

integer <int32>

detail

string

instance

string

500 Internal server error.

Request Example

Please select an example:

{
  "bankAccount": "DE75512108001245126199"
}

Response Example

{
  "isValid": true
}