Skip to content
Last updated

Notice of change - Improving Bank Monitoring capability

Issued: 14th June 2023 | TB-1148

What's changing?

We're enhancing our bank monitoring capability by:

  • increasing the number of detection scenarios for when a bank might be 'down'

  • implementing a status change when the scenarios are detected

  • making customers aware of the status change through a bank maintenance field in the GET /banks endpoint

GET {{BASE_URL}}/banks response

{
    "banks": [
        {
            "bankGroup": "XYZ-Bank-Group",
            "bic": "BOFIIE2D",
            "countries": [ ... ],
            "credentialFields": [ ... ],
            "fieldsFormatInformation": [ ... ],
            "fullLogoUri": "https://s3-us-west-2.amazonaws.com/tokenio-assets/1.0.0/logos/gold/gold_full.png",
            "id": "ob-modelo",
            "identifier": "BLZ",
            "logoUri": "https://s3-us-west-2.amazonaws.com/tokenio-assets/1.0.0/logos/gold/gold_square.png",
            "mandatoryFields": { ... },
            "maintenanceWindow": {
                "startTime": "2023-05-03T12:28:20.466Z",
                "endTime": "2023-05-03T12:40:25.47Z",
                "type": "OUTAGE",
                "productType": "SIP"
            }
        }
    ]
}
  • amending the hosted payments page (Token.io Hosted Pages) to prevent the user from proceeding when an outage is detected
  • enabling customers to be notified via webhooks when a bank's status changes, if they subscribe

What problem will this solve?

The bank monitoring capability will improve Token.io’s ability to detect when a bank is 'down' and notify customers accordingly.

Does this change affect you?

This change applies to all customers using both Token.io’s Account Information Service (AIS) and Payment Initiation Service (PIS) via API.

If you're using the hosted payments page (Token.io Hosted Pages) for bank selection, where the TPP owns the full user experience, you will see the new Bank is currently unavailable page when the bank is down.

If you're using the hosted payments page for handling embedded flow credentials only, your current experience will not change.

The existing Bank Health Check will continue to work in its current form.

What action do I need to take?

If you would like to receive notifications when a bank status changes, please subscribe to the AIS and PIS bank status change webhooks:

  • BANK_AIS_OUTAGE_STATUS_CHANGED

  • BANK_SIP_OUTAGE_STATUS_CHANGED

When will this change apply to all impacted customers?

This functionality will be available from the 14th June 2023.

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.