Skip to Main Content
Riverty Docs
    riverty logo Docs

    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:
    • NO
    • SV
    • FI
    • DA
    • EN
    • DE
    • NL
    • FR
    The language code used for client communication. If not provided, the system will default to the language configured for the client.

    Responses

    • isValid
      boolean
      Is response valid
      array
      Risk check messages
      type
      string
      Enum:
      • BusinessError
      • TechnicalError
      • NotificationMessage
      code
      string
      Max length: 100
      Confirmation or error code
      message
      string
      Max length: 4096
      Message content
      customerFacingMessage
      string
      Max length: 4096
      Message to display to customer
      actionCode
      string
      Enum:
      • Unavailable
      • AskConsumerToConfirm
      • AskConsumerToReEnterData
      • OfferSecurePaymentMethods
      • RequiresSsn
      • AskConsumerToIdentify
      • ManualReview
      Action codes
      fieldReference
      string
      Max length: 100
      Reference to field that caused an error
      token
      string
    • type
      string
      Enum:
      • BusinessError
      • TechnicalError
      • NotificationMessage
      code
      string
      Max length: 100
      Confirmation or error code
      message
      string
      Max length: 4096
      Message content
      customerFacingMessage
      string
      Max length: 4096
      Message to display to customer
      actionCode
      string
      Enum:
      • Unavailable
      • AskConsumerToConfirm
      • AskConsumerToReEnterData
      • OfferSecurePaymentMethods
      • RequiresSsn
      • AskConsumerToIdentify
      • ManualReview
      Action codes
      fieldReference
      string
      Max length: 100
      Reference to field that caused an error
    • 401 Authorization has been denied for this request.
    • 413 Request body too large.
    • 429 Too many requests.
    • 500 Internal server error.
    Successful Request, Valid AccountSuccessful Request, Invalid Account

    Request Example

        
        {
 "bankAccount": "DE75512108001245126199"
}

    Response Example

        
        {
 "isValid": true
}