Notice of change - bankId added to the GET /token-requests/{tokenRequestId}/result response

Issued: 13th November 2024 | TB-1542

What's changing?

We're adding bankId to the response for GET /token-requests/{tokenRequestId}/result.

bankId is the bank identifier, identical to the id in the response to GET /banks, for example: ob-modelo.

Here is an example response from the GET /token-requests/{tokenRequestId}/result call with the new bankId field.

Before payment initiation:

{
      "signature" : {}
      "status" : "PENDING",
     "bankId" : "ob-modelo"
}

After payment initiation:

{
     "tokenId" : "tt:G4cNrSYaoif6v2TDFq1pSCJfQxXD23XXmY3ZzUrRp1Kn:HK5cCSU5TAV8nJYQ1oVM"
     "signature" : {
          "memberId" : "m:2MsNiHgYNphSz2j9GbE83Yqr7iod:5zKtXEAq",
          "keyId" : "1x7df4vuFUHYQCa7",
          "signature" : "4eTAvCbkxiG48t4YwpjYvdsRoDjpL5AUjv5oXcCmSdsO33oXeprFOLP0_kJK8YXla5X5f5tLTQ1w5JhqBp2SCg"
     }
     "transferId" : "t:55qoM4svnzwxEyjF69rY8q13qmY7GqfyHbxvvN8yssSY:HK5cCSU5TAV8nJYQ1oVM",
     "status" : "PROCESSING",
     "bankId" : "ob-modelo"
}

What problem will this solve?

Including the bankId will ensure that customers using Token.io’s Hosted Pages for bank selection by the user are aware of the bank that has been selected. This is useful especially when a token-request ends in a REJECTED status and no transfer details are available. This change will apply to all Payment v1 initiations regardless of integration method.

Does this change affect you?

This is not a breaking change as bankId is being added as a new field.

This change will only affect customers using the API. It will not affect customers using the SDK.

What action do I need to take?

Please check for any backward compatibility issues to ensure that adding the new field doesn't break your integration.

When will this change apply to all impacted customers?

This change will become effective from 10th February 2025.

Where can I get further information?

For assistance with the above and other operational aspects of the Token.io Account-to-Account Infrastructure, please contact Token.io Support.