IBAN Tokenization

Collecting the IBAN

Riverty offers two different approaches to tokenizing the consumer's IBAN.

  1. The Merchant Collects the IBAN
  2. The Merchant uses Hosted Fields to securely collect that information

Tokenization via Direct Input

If the consumer enters the IBAN into a Merchant input form, the Merchant must send the IBAN to our validateBankAccount endpoint.

As an outcome the IBAN will be validated and a token will be created. This token can be sent into the authorization request.

Tokenization via Hosted Fields

If the consumer enters the IBAN into a Riverty Hosted Field, the Merchant simply needs to receive the nonce from the Hosted Field and send it to Riverty's validateBankAccount endpoint

As an outcome the nonce will be validated and a token will be created. This token can be sent into the Authorization Call.

Request

{
  "bankAccount": "DE123...",
  "bankCode": "string",
  "createToken": true
}

Response

{
  "isValid": true,
  "token": "string"
}