Account on File

Create an Account on File

Creates an Account on File from the provided bank account details. This can be used by Third Party Providers (TPPs) in future API requests to reference the account without resending the full account information.

post/tokenized-accounts

Request

  • Base URL
    https://api.token.io
  • URL
    https://api.token.io/tokenized-accounts
  • Auth
    • HTTP bearer
    • or API key in header Authorization

Request body

bankIdstring

Identifier of the bank where the account belongs.

Example request

{
  "accountDetails": {
    "iban": "GB29NWBK60161331926819",
    "bic": "BOFIIE2D",
    "name": "John Smith",
    "ultimateDebtorName": "John Smith",
    "address": {
      "addressLine": [
        "The Coach House"
      ],
      "streetName": "221B",
      "buildingNumber": "2C",
      "postCode": "TR26 1EZ",
      "townName": "Saint Ives",
      "state": "Cornwall",
      "country": "GB"
    }
  },
  "bankId": "ob-modelo"
}

Response

Successful response

tokenizedAccountIdstring

The tokenized account id of the provided account details.

Example response

{
  "tokenizedAccountId": "tai:4HoNxTfhn9EjwNnQmjGCsWsuYS7S:5zJAqBcE"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.