Riverty Logo

Validate bank account

Validate bank account

PATH:

/api/v3/validate/bank-account

REQUEST BODY SCHEMA:

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 Integration Manager for more details.

conversationLanguage

string

Enum:NOSVSEFIDADKENDENLFR

Conversation language. 'SE' and 'DK' are obsolete values, and will be removed in the future. Use 'SV' instead of 'SE', and 'DA' instead of 'DK'.

RESPONSES:

200 OK

RESPONSE SCHEMA:

isValid

boolean

Is response valid

riskCheckMessages

array of riskCheckMessages

Risk check messages

Array () [
type

string

Enum:BusinessErrorTechnicalErrorNotificationMessage

Message type

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

Possible next action to make

fieldReference

string <= 100 characters

Reference to field that caused an error

]
token

string

400 Model validation failed.

RESPONSE SCHEMA:

Array () [
type

string

Enum:BusinessErrorTechnicalErrorNotificationMessage

Message type

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

Possible next action to make

fieldReference

string <= 100 characters

Reference to field that caused an error

]
401 Authorization has been denied for this request.
500 Internal server error.

Path

post

/api/v3/validate/bank-account

Request samples

  • {
    • "bankAccount": "string",
    • "bankCode": "string",
    • "bankNumber": "string",
    • "createToken": true,
    • "nonce": "string",
    • "conversationLanguage": "string"
    }

Response samples

200400
  • {
    • "isValid": true,
    • "riskCheckMessages": [ { ... }
      • {
        • "type": "string",
        • "code": "string",
        • "message": "string",
        • "customerFacingMessage": "string",
        • "actionCode": "string",
        • "fieldReference": "string"
        }
      ],
    • "token": "string"
    }
  • {
    • "type": "string",
    • "code": "string",
    • "message": "string",
    • "customerFacingMessage": "string",
    • "actionCode": "string",
    • "fieldReference": "string"
    }
Riverty 2023