Skip to main content

Platform Module Overview

Directory of Participants​

The Directory of Participants endpoint allows the Service Provider to query the list of registered Service Users and the Service User to query a list of registered Service Providers.

All participants (Service Providers and Service Users) using the bLink API are listed in the directory and can access it using the Directory of Participants Endpoint. The directory holds the information necessary for operations and seamless integration of participants and it is maintained by SIX.

IMPORTANT

The directory should not be replicated by the participants. However, the data can be cached for a short period to improve the user experience.

Content​

The information about the participants contains a unique identification (providerId for Service Providers and clientId for Service Users), name, address, contact information (technical and business), logos/images and short/marketing descriptions. All these details must be provided by participants, with the exception of providerId and clientId, which are provided by SIX.

The participant status, registration date and last modification date are stored on bLink.

note

All descriptions must be provided in German, English, French and Italian.

Marketing images are supported in the following formats: PNG, JPEG and SVG. For logos, only SVG is allowed. The maximum allowed size is 3 MB. The images are included base64-encoded.

StatusDescription
ONBOARDING_DEVELOPMENTThe participant is in the onboarding process for bLink, potentially undergoing certification.
(Participants with this status are only visible in the directory of the bLink test environments.)
ACTIVEThe participant is certified and productive for at least one use case.
SUSPENDEDThe participant has been temporarily suspended by SIX or by itself. Requests from/to suspended participants will be rejected by the platform.
INACTIVEThe participant is no longer active.

The image below presents the participant status and flow on bLink.

Directory of Participants Flow

Software​

The software used by a Service User is registered in the directory. This registration includes the product name, manufacturer, product category (i.e. accounting), product description, logos, etc.

The software used by a Service Provider is not registered.

Use cases​

All bLink services are provided in independent modules and version of the use cases.

Herewith bLink enables parallel mode of API's with different versions and new services can be added flexibly. Providers have the possibility to expose their API's using different URL's.

UseCase Item​

In the following sections some examples of the UseCases items are presented.

[
  {
    "name": "ais",
    "version": "v2",
    "scopes": "urn:blink:a2a:ais",
    "status": "ONBOARDING_CERTIFICATION",
    "from": "2019-06-03T14:38:00Z",
    "until": "9999-12-31T21:59:59Z"
  },
  {
    "name": "pss",
    "version": "v2",
    "scopes": "urn:blink:a2a:pss:write",
    "status": "ONBOARDING_CERTIFICATION",
    "from": "2019-06-03T14:38:00Z",
    "until": "9999-12-31T21:59:59Z"
  },
  {
    "name": "openwealth-custody-services",
    "version": "v1",
    "scopes": "urn:blink:ow:cstdy",
    "status": "ONBOARDING_CERTIFICATION",
    "from": "2021-04-01T14:38:00Z",
    "until": "9999-12-31T21:59:59Z"
  },
  {
    "name": "openwealth-customer-management",
    "version": "v1",
    "scopes": "urn:blink:ow:custmgmt urn:blink:ow:custmgmt:write",
    "status": "ONBOARDING_CERTIFICATION",
    "from": "2021-04-01T14:38:00Z",
    "until": "9999-12-31T21:59:59Z"
  }
]

Information about the actual API endpoint at the Service Provider is not part of the directory. bLink uses the URLs just internally for traffic routing, e.g.

https://onlinebanking.service-provider.ch:443/blink/a2a/v1/
https://onlinebanking.service-provider.ch:443/blink/owa/v1/
https://onlinebanking.service-provider.ch:443/blink/owa/custodyservices/v1/

ConsentFlow Item​

ConsentFlow Items enable the usage of multiple/different AuthEndpoints per Consent Flow in a dedicated Item. See example below:

[
  {
    "type": "consent-flow-2",
    "version": "v2",
    "status": "ONBOARDING_CERTIFICATION",
    "from": "2021-04-01T14:38:00Z",
    "until": "9999-12-31T21:59:59Z",
    "endpointInfos": [
      {
        "name": "providerAuthEndpointUrl",
        "url": "https://onlinebanking.service-provider.ch/authserver/oauth/authorize/endpoint"
      }
    ]
  },
  {
    "type": "consent-flow-2-as-a-service",
    "version": "v2",
    "status": "ONBOARDING_CERTIFICATION",
    "from": "2021-04-01T14:38:00Z",
    "until": "9999-12-31T21:59:59Z",
    "endpointInfos": [
      {
        "name": "providerAuthEndpointUrl",
        "url": "https://onlinebanking.service-provider.ch/authserver/oauth/authorize/endpoint"
      }
    ]
  }
]

Directory of Participants examples​

In the following sections some examples of the Directory of Participants are presented.

{
      "status": "ACTIVE",
      "companyName": "ABC Service Provider",
      "companyNameAbbreviation": "ABC",
      "companyUrl": "http://www.abc-service-provider.com",
      "productName": "ABC Bank",
      "productInfoUrl": "http://www.abc-service-provider.com/private",
      "contact": [
        {
          "type": "TECHNICAL",
          "designation": "Gornuk",
          "emailAddress": "gornuk@abc-service-provider.com",
          "phone": "079 069 69 69"
        },
        {
          "type": "BUSINESS",
          "designation": "Gornuk",
          "emailAddress": "gornuk@abc-service-provider.com",
          "phone": "079 069 69 69"
        },
      ],
      "logo": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAuMjMgMjMgNTkuNTMgMzcuMDIiPjx0aXRsZT48L3RpdGxlPjxnIGlkPSJ0ZXh0Ij48dGV4dCBmb250LWZhbWlseT0iTXlyaWFkUHJvLVJlZ3VsYXIsIE15cmlhZCBQcm8iIGZvbnQtc2l6ZT0iOSIgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoNi43MjcwNSAtNDkuNjA5ODYpIj48dHNwYW4gbGV0dGVyLXNwYWNpbmc9Ii0wLjAwNDk5ZW0iPjwvdHNwYW4+PHRzcGFuIHg9IjQuNzQzMTYiIHk9IjAiPjwvdHNwYW4+PHRzcGFuIGxldHRlci1zcGFjaW5nPSItMC4wMDI5OGVtIiB4PSIxMy4zODI4MSIgeT0iMTAuNzk5OCI+PC90c3Bhbj48dHNwYW4gbGV0dGVyLXNwYWNpbmc9Ii0wLjAwNjAyZW0iIHg9IjE3Ljc5Mjk3IiB5PSIxMC43OTk4Ij48L3RzcGFuPjx0c3BhbiB4PSIyMC43MTc3NyIgeT0iMTAuNzk5OCI+PC90c3Bhbj48L3RleHQ+PC9nPjxnIGlkPSJjb2xvdXIiPjxwYXRoIGQ9Ik01NC4yNjY4MSwzMC4wM2E0LjI3NjEsNC4yNzYxLDAsMCwwLTIuMTItLjUzSDQ4LjMzNjg4YTQuNTU5MTksNC41NTkxOSwwLDAsMS0yLjIzMDEtLjU5bC00LjkzMDA1LTIuODJhNC41ODcxLDQuNTg3MSwwLDAsMC0yLjIzLS41OUgzNC41MDY4YTIuMjQ5LDIuMjQ5LDAsMCwxLS41ODAwOC0uMDdsLTMuNjQ5OS0uOTEtMy42Ni45MWEyLjIyNTE1LDIuMjI1MTUsMCwwLDEtLjU2OTk1LjA3aC00LjQ1YTQuNTg3OTEsNC41ODc5MSwwLDAsMC0yLjIzMDEuNTlsLTQuOTIsMi44MmE0LjU5NjIxLDQuNTk2MjEsMCwwLDEtMi4yNC41OUg4LjQwNjgyYTQuMzE0MDgsNC4zMTQwOCwwLDAsMC0yLjEzLjUzYy0zLjc3LDIuMTEtNS4xNCw2LjI1LTMuNzQsMTEuMTRMNS45NzY3NywzOC42YS40OTgzNS40OTgzNSwwLDAsMSwuNDEtLjA5LjQ3NTg0LjQ3NTg0LDAsMCwxLC4zMy4yN2MxLjQ3LDIuOTEsNC4wMSw2LjM3LDcuOTUsNi42OUMxNC4wNTY4NSw0NC4wOCwyMCw1NywyNi42MjY3OSw1OC4yNmE2LjcwMjI2LDYuNzAyMjYsMCwwLDAsMS4yODk5Mi4yNGg0LjcxMDA4YTMuNjU4NSwzLjY1ODUsMCwwLDAsMS4yODk5Mi0uMjRDNDAsNTYsNDYuNDg2NzgsNDQuMDgsNDUuODc2NzksNDUuNDdjMy45NTAwNy0uMzEsNi40OS0zLjc3LDcuOTUwMDctNi42OWEuNDkzNjEuNDkzNjEsMCwwLDEsLjc1LS4xOGwzLjQyOTkzLDIuNTdDNTkuNDA2ODIsMzYuMjgsNTguMDM2ODMsMzIuMTQsNTQuMjY2ODEsMzAuMDNaTTI4LDM4YTQuNzYxLDQuNzYxLDAsMCwxLTUsNSw0Ljc1MDI3LDQuNzUwMjcsMCwwLDEtNS01Yy0uMDEtLjA0LDAsLjA0LDAsMGE0LjY5MjksNC42OTI5LDAsMCwxLDUtNSw0LjY5MjksNC42OTI5LDAsMCwxLDUsNUMyOCwzOC4wMywyOC4wMSwzNy45NiwyOCwzOFptMTQsMGE0Ljc2MSw0Ljc2MSwwLDAsMS01LDUsNC43NTAyNyw0Ljc1MDI3LDAsMCwxLTUtNWMtLjAxLS4wNCwwLC4wNCwwLDBhNC42OTI5LDQuNjkyOSwwLDAsMSw1LTUsNC42OTI5LDQuNjkyOSwwLDAsMSw1LDVDNDIsMzguMDMsNDIuMDEsMzcuOTYsNDIsMzhaIiBmaWxsPSIjZTI2OWEwIj48L3BhdGg+PHBhdGggZD0iTTYuMDA1LDMyLjUzQTQuMzE0MDgsNC4zMTQwOCwwLDAsMSw4LjEzNSwzMmgzLjc5OTkzYTQuNTk2MjEsNC41OTYyMSwwLDAsMCwyLjI0LS41OWw0LjkyLTIuODJhNC41ODc5MSw0LjU4NzkxLDAsMCwxLDIuMjMwMS0uNTloNC40NWEyLjIyNTE1LDIuMjI1MTUsMCwwLDAsLjU2OTk1LS4wN2wzLjY2LS45MSwzLjY0OTkuOTFBMi4yNDksMi4yNDksMCwwLDAsMzQuMjM1LDI4aDQuNDM5OTRhNC41ODcxLDQuNTg3MSwwLDAsMSwyLjIzLjU5TDQ1LjgzNSwzMS40MWE0LjU1OTE5LDQuNTU5MTksMCwwLDAsMi4yMzAxLjU5SDUxLjg3NWE0LjI3NjEsNC4yNzYxLDAsMCwxLDIuMTIuNTMsOC4wOTU3Nyw4LjA5NTc3LDAsMCwxLDQuMTk3OTQsNi4zMTZjLjQyNC0zLjg1OTUtMS4wNDI2Ni03LjA1LTQuMTk3OTQtOC44MTZhNC4yNzYxLDQuMjc2MSwwLDAsMC0yLjEyLS41M0g0OC4wNjUwNmE0LjU1OTE5LDQuNTU5MTksMCwwLDEtMi4yMzAxLS41OWwtNC45MzAwNS0yLjgyYTQuNTg3MSw0LjU4NzEsMCwwLDAtMi4yMy0uNTlIMzQuMjM1YTIuMjQ5LDIuMjQ5LDAsMCwxLS41ODAwOC0uMDdsLTMuNjQ5OS0uOTEtMy42Ni45MWEyLjIyNTE1LDIuMjI1MTUsMCwwLDEtLjU2OTk1LjA3aC00LjQ1YTQuNTg3OTEsNC41ODc5MSwwLDAsMC0yLjIzMDEuNTlsLTQuOTIsMi44MmE0LjU5NjIxLDQuNTk2MjEsMCwwLDEtMi4yNC41OUg4LjEzNWE0LjMxNDA4LDQuMzE0MDgsMCwwLDAtMi4xMy41M2MtMy4xNTUyNywxLjc2Ni00LjYyMTg5LDQuOTU2NDgtNC4xOTc5NCw4LjgxNkE4LjA5NTc3LDguMDk1NzcsMCwwLDEsNi4wMDUsMzIuNTNaIiBmaWxsPSIjZTU4OWI3Ij48L3BhdGg+PHBhdGggZD0iTTQxLjc1NjgsMzguMDgyMTJBNS4xMjg4NSw1LjEyODg1LDAsMCwxLDM2Ljg3ODQsNDMsNS4xMjQxNCw1LjEyNDE0LDAsMCwxLDMyLDM4LjA3MDA5TDM2Ljg3ODQsMzdaIiBmaWxsPSIjZTBlMGUwIj48L3BhdGg+PHBhdGggZD0iTTI3Ljc1NjgsMzguMDgyMTJBNS4xMjg4NSw1LjEyODg1LDAsMCwxLDIyLjg3ODQsNDMsNS4xMjQxNCw1LjEyNDE0LDAsMCwxLDE4LDM4LjA3MDA5TDIyLjg3ODQsMzdaIiBmaWxsPSIjZTBlMGUwIj48L3BhdGg+PHBhdGggZD0iTTM5Ljg5OTc4LDM3LjY3MDE3QTUuMDQ2MDUsNS4wNDYwNSwwLDAsMSwzNS4xMjE1OCw0MmE0LjQxNjUyLDQuNDE2NTIsMCwwLDEtMS4zMTA0Mi0uMjIwNThBNC41ODU2Niw0LjU4NTY2LDAsMCwwLDM2Ljg3ODQyLDQzYTUuMTI4ODQsNS4xMjg4NCwwLDAsMCw0Ljg3ODM2LTQuOTE3OTFaIiBmaWxsPSIjYzljOGM3Ij48L3BhdGg+PHBhdGggZD0iTTIxLjEyMTU4LDQyYTQuNDE2NTIsNC40MTY1MiwwLDAsMS0xLjMxMDQyLS4yMjA1OEE0LjU4NTY2LDQuNTg1NjYsMCwwLDAsMjIuODc4NDIsNDNhNS4xMjg4NCw1LjEyODg0LDAsMCwwLDQuODc4MzYtNC45MTc5MWwtMS44NTctLjQxMTkzQTUuMDQ2MDUsNS4wNDYwNSwwLDAsMSwyMS4xMjE1OCw0MloiIGZpbGw9IiNjOWM4YzciPjwvcGF0aD48cGF0aCBkPSJNNTcuNzM1LDM4LjkxMDYzbC0zLjQyOTkzLTIuNTdhLjQ5MzYxLjQ5MzYxLDAsMCwwLS43NS4xOGMtMS40NjAwOCwyLjkyLTQsNi4zOC03Ljk1MDA3LDYuNjkuNjEtMS4zOS01Ljg3Njc3LDEwLjUzLTExLjk2MDA4LDEyLjc5YTMuNjU5MjEsMy42NTkyMSwwLDAsMS0xLjI4OTkyLjI0SDI3LjY0NDlhNi43MDI2OCw2LjcwMjY4LDAsMCwxLTEuMjg5OTItLjI0Yy02LjYyNjc3LTEuMjYtMTIuNTY5OTUtMTQuMTgwMDUtMTEuOTYwMDgtMTIuNzktMy45Mzk5NC0uMzItNi40OC0zLjc4LTcuOTUtNi42OWEuNDc1ODQuNDc1ODQsMCwwLDAtLjMzLS4yNy40OTgzNS40OTgzNSwwLDAsMC0uNDEuMDlsLTMuNDM5OTQsMi41N2ExMy45Njg3MywxMy45Njg3MywwLDAsMS0uNDU2NzktMi4zMTQzOUExMi4yNDQ2OSwxMi4yNDQ2OSwwLDAsMCwyLjI2NSw0MS40MzA1OWwzLjQzOTk0LTIuNTdhLjQ5ODM1LjQ5ODM1LDAsMCwxLC40MS0uMDkuNDc1ODQuNDc1ODQsMCwwLDEsLjMzLjI3YzEuNDcsMi45MSw0LjAxLDYuMzcsNy45NSw2LjY5LS42MDk4Ni0xLjM5LDUuMzMzMzEsMTEuNTMsMTEuOTYwMDgsMTIuNzlhNi43MDI2OCw2LjcwMjY4LDAsMCwwLDEuMjg5OTIuMjRIMzIuMzU1YTMuNjU5MjEsMy42NTkyMSwwLDAsMCwxLjI4OTkyLS4yNGM2LjA4MzMxLTIuMjYsMTIuNTcwMDctMTQuMTgwMDUsMTEuOTYwMDgtMTIuNzksMy45NTAwNy0uMzEsNi40OS0zLjc3LDcuOTUwMDctNi42OWEuNDkzNjEuNDkzNjEsMCwwLDEsLjc1LS4xOGwzLjQyOTkzLDIuNTdhMTIuMjQ0NjksMTIuMjQ0NjksMCwwLDAsLjQ1Njc5LTQuODM0MzVBMTMuOTY4NzMsMTMuOTY4NzMsMCwwLDEsNTcuNzM1LDM4LjkxMDYzWiIgZmlsbD0iI2JhNWI5MyI+PC9wYXRoPjxwYXRoIGQ9Ik00MS43MzY3OCwzNy4zOGwtNC43NzU1NC0uOTgyMTFhLjY0MDU0LjY0MDU0LDAsMCwwLS4yMDc3LDBMMzIsMzcuMzhhNC44OTU2Miw0Ljg5NTYyLDAsMCwxLDkuNzM2NzgsMFoiIGZpbGw9IiNiYTViOTMiPjwvcGF0aD48cGF0aCBkPSJNMjgsMzcuMzhsLTQuOTA0NjQtLjk4MjExYS42NzU0MS42NzU0MSwwLDAsMC0uMjEzMzIsMEwxOCwzNy4zOGE1LjA0Mzg4LDUuMDQzODgsMCwwLDEsMTAsMFoiIGZpbGw9IiNiYTViOTMiPjwvcGF0aD48L2c+PGcgZGF0YS1uYW1lPSJMYXllciAxIiBpZD0iTGF5ZXJfMSI+PHBhdGggZD0iTTU0LjcyNzU0LDI4LjcxODI2YTUuODQ4MTcsNS44NDgxNywwLDAsMC0yLjg1NzQyLS43MTc3N0g0OC4wNjI1YTMuMDAwNjcsMy4wMDA2NywwLDAsMS0xLjQ4ODI4LS4zOTU1MWwtNC45MjQ4LTIuODEzNDhhNi4wMTMxMiw2LjAxMzEyLDAsMCwwLTIuOTc3NTQtLjc5MUgzNC4yMzA0N2EuODk5Ljg5OSwwLDAsMS0uMjExOTEtLjAyNTM5bC0zLjc3NjM3LS45NDQzNGEuOTY4NzUuOTY4NzUsMCwwLDAtLjQ4NDM3LDBsLTMuNzc2MzcuOTQ0MzRhLjg5OS44OTksMCwwLDEtLjIxMTkxLjAyNTM5SDIxLjMyODEzYTYuMDEzMTIsNi4wMTMxMiwwLDAsMC0yLjk3NzU0Ljc5MUwxMy40MjQ4MSwyNy42MDVhMi45OTQzNywyLjk5NDM3LDAsMCwxLTEuNDg3MzMuMzk1NTFIOC4xMjk4OGE1Ljg0ODE3LDUuODQ4MTcsMCwwLDAtMi44NTc0Mi43MTc3N0MuNzIzNjMsMzEuMjctLjg5NDUzLDM2LjQ4MSwxLjA1MTc2LDQyLjMxNjg5YS45OTk3OC45OTk3OCwwLDAsMCwxLjU0Nzg1LjQ4MzRMNS42NjYsNDAuNTAwNDljMi4zMTUwNiw0LjA3OTIyLDUuMzYyMTgsNi4yODQwNiw4Ljg3Myw2LjQ2NDcyQzE3LjcxMSw1My41NzQ1OCwyMi4yMjg1OCw1OC4xODg3OCwyNS43ODMyLDU5LjY0NmE0Ljg3MzI4LDQuODczMjgsMCwwLDAsMS44NjMyOC4zNTQ0OWg0LjcwN2E0Ljg4NjgxLDQuODg2ODEsMCwwLDAsMS44NjUyMy0uMzU0NDljMy41NTM3Ny0xLjQ1Nzk1LDguMDcwNS02LjA3MjE0LDExLjI0MjEzLTEyLjY4MDc5LDMuNTEwOC0uMTgwNjYsNi41NTgtMi4zODU0NCw4Ljg3MzExLTYuNDY0NzJsMy4wNjY0MSwyLjI5OThhLjk5OTc4Ljk5OTc4LDAsMCwwLDEuNTQ3ODUtLjQ4MzRDNjAuODk0NTMsMzYuNDgxLDU5LjI3NjM3LDMxLjI3LDU0LjcyNzU0LDI4LjcxODI2Wm0yLjcwOSwxMS42MDkzOC0yLjgzNjkxLTIuMTI3YS45OTkwNi45OTkwNiwwLDAsMC0xLjQ5NDE0LjM1MjU0Yy0xLjI5MjI0LDIuNTg0NDctMy40NTcsNS42MDI3Mi02LjcwMDMyLDYuMjk3NjcuNDc4MzktMS4xNzAzNS45MTUxNi0yLjM4OTg5LDEuMjk0MDctMy42NmE0LjAwMDkyLDQuMDAwOTIsMCwwLDAtLjA0Nzg1LTIuMzk2NDhsLS4xMTcxOS0uMzUxNTZhMS45OTI2MSwxLjk5MjYxLDAsMCwxLC40ODQzOC0yLjA0Njg3bDIuMDcwMzEtMi4wNzAzMWExLjAwNDY1LDEuMDA0NjUsMCwwLDEsLjgzNS0uMjg3MTEsMi41MjMyNywyLjUyMzI3LDAsMCwxLDIuMTgxNjQsMS40MDkxOCwxLjAwMDEyLDEuMDAwMTIsMCwwLDAsMS43ODkwNi0uODk0NTMsNC40Nzc2Niw0LjQ3NzY2LDAsMCwwLTMuNzQ4LTIuNTAyOTMsMi45OTgsMi45OTgsMCwwLDAtMi40NzE2OC44NjEzM2wtMi4wNzAzMSwyLjA3MDMxYTMuOTc3NDYsMy45Nzc0NiwwLDAsMC0uOTY2OCw0LjA5Mzc1bC4xMTcxOS4zNTE1NmExLjk5NTYxLDEuOTk1NjEsMCwwLDEsLjAyODMyLDEuMTkxNDFDNDMuMTA2NDUsNDkuNTkwMzMsMzcuNDM1NTUsNTYuMTY0NTUsMzMuNDYsNTcuNzk2MzlhMi45MDY2NiwyLjkwNjY2LDAsMCwxLTEuMTA2NDUuMjA0MWgtNC43MDdhMi45MDE2LDIuOTAxNiwwLDAsMS0xLjEwNTQ3LS4yMDQxYy0zLjk3NjU2LTEuNjMwODYtOS42NDc0Ni04LjIwNTA4LTEyLjMyNDIyLTE3LjE3NzczYTEuOTk1NjEsMS45OTU2MSwwLDAsMSwuMDI4MzItMS4xOTE0MWwuMTE3MTktLjM1MTU2YTMuOTc5MDcsMy45NzkwNywwLDAsMC0uOTY1ODItNC4wOTM3NUwxMS4zMjUyLDMyLjkxMTYyYTMuMDEwODMsMy4wMTA4MywwLDAsMC0yLjQ3MDctLjg2MTMzLDQuNDc5OTEsNC40Nzk5MSwwLDAsMC0zLjc0OSwyLjUwMjkzLDEuMDAwMTIsMS4wMDAxMiwwLDAsMCwxLjc4OTA2Ljg5NDUzLDIuNTIzNTcsMi41MjM1NywwLDAsMSwyLjE4MjYyLTEuNDA5MTguOTk3Ljk5NywwLDAsMSwuODM0LjI4NzExTDExLjk4MTQ1LDM2LjM5NmExLjk5MDEzLDEuOTkwMTMsMCwwLDEsLjQ4NDM4LDIuMDQ2ODhsLS4xMTcxOS4zNTE1NmE0LjAwMDkyLDQuMDAwOTIsMCwwLDAtLjA0Nzg1LDIuMzk2NDhjLjM3ODkxLDEuMjcwMDguODE1NTUsMi40ODk2MiwxLjI5Mzk1LDMuNjYtMy4yNDMyOS0uNjk0OTUtNS40MDgtMy43MTMyLTYuNzAwMi02LjI5NzY3YS45OTkwNi45OTkwNiwwLDAsMC0xLjQ5NDE0LS4zNTI1NGwtMi44MzY5MSwyLjEyN0MxLjU1MTc2LDM1Ljk4MSwyLjg4MDg2LDMyLjM1Myw2LjI1MSwzMC40NjI0YTMuODUyMzYsMy44NTIzNiwwLDAsMSwxLjg3ODkxLS40NjE5MWgzLjgwNzU5YTUuMDAwNzEsNS4wMDA3MSwwLDAsMCwyLjQ4MDQ5LS42NTkxOGw0LjkyNDgtMi44MTM0OGE0LjAxNTE5LDQuMDE1MTksMCwwLDEsMS45ODUzNS0uNTI3MzRoNC40NDE0MWEyLjgyNzA1LDIuODI3MDUsMCwwLDAsLjY5NjI5LS4wODU5NEwzMCwyNS4wMzE3NGwzLjUzNDE4Ljg4MjgxYTIuODI3MDUsMi44MjcwNSwwLDAsMCwuNjk2MjkuMDg1OTRoNC40NDE0MWE0LjAxNTE5LDQuMDE1MTksMCwwLDEsMS45ODUzNS41MjczNGw0LjkyMzgzLDIuODEzNDhhNS4wMDcsNS4wMDcsMCwwLDAsMi40ODE0NS42NTkxOGgzLjgwNzYyYTMuODUyMzYsMy44NTIzNiwwLDAsMSwxLjg3ODkxLjQ2MTkxQzU3LjExOTE0LDMyLjM1Myw1OC40NDgyNCwzNS45ODEsNTcuNDM2NTIsNDAuMzI3NjRaIj48L3BhdGg+PHBhdGggZD0iTTI2LjI5Myw0NS4yOTM0NmEuOTk5NjQuOTk5NjQsMCwwLDAsMCwxLjQxNDA2bDMsM2EuOTk5NjQuOTk5NjQsMCwwLDAsMS40MTQwNiwwbDMtM0EuOTk5ODkuOTk5ODksMCwwLDAsMzIuMjkzLDQ1LjI5MzQ2TDMwLDQ3LjU4NjQzbC0yLjI5My0yLjI5M0EuOTk5NjQuOTk5NjQsMCwwLDAsMjYuMjkzLDQ1LjI5MzQ2WiI+PC9wYXRoPjxwYXRoIGQ9Ik0zNS43MDcsNTAuMjkzNDZhLjk5OTY0Ljk5OTY0LDAsMCwwLTEuNDE0MDYsMCwuOTg5NDkuOTg5NDksMCwwLDAtLjE3NzkyLDEuMTQ2MjRjLTEuNzIyNDEsMS40MDQxNy02LjUwNzY5LDEuNDA0MTctOC4yMzAxLDBhLjk4OTQ5Ljk4OTQ5LDAsMCwwLS4xNzc5Mi0xLjE0NjI0Ljk5OTY0Ljk5OTY0LDAsMCwwLTEuNDE0MDYsMGwtMSwxYS45ODc2Ny45ODc2NywwLDAsMCwxLjE4MTgyLDEuNTY4M0E4LjY2NjIyLDguNjY2MjIsMCwwLDAsMzAsNTQuNTA3MzJhOC42NjYyMiw4LjY2NjIyLDAsMCwwLDUuNTI1MjEtMS42NDU1Ny45OTAyLjk5MDIsMCwwLDAsMS4xODE4Mi0xLjU2ODNaIj48L3BhdGg+PHBhdGggZD0iTTI5LDM4LjAwMDQ5YTYsNiwwLDEsMC02LDZBNi4wMDY1Niw2LjAwNjU2LDAsMCwwLDI5LDM4LjAwMDQ5Wm0tNi00YTMuOTkxNDcsMy45OTE0NywwLDAsMSwzLjc3NTc2LDIuNzM1NDFMMjMuMTk2MjksMzYuMDJjLS4wMzI2NS0uMDA2NDEtLjA2NjE2LjAwMzE3LS4wOTkzNywwQS45NDI1NC45NDI1NCwwLDAsMCwyMywzNi4wMDA0OWEuOTQyNTQuOTQyNTQsMCwwLDAtLjA5NjkyLjAxOTUzYy0uMDMzMi4wMDMxNy0uMDY2NzEtLjAwNjQxLS4wOTkzNywwbC0zLjU3OTQ3LjcxNTg4QTMuOTkxNDcsMy45OTE0NywwLDAsMSwyMywzNC4wMDA0OVpNMTkuMDgxMjQsMzguODA0LDIyLDM4LjIydi43ODA0NmExLDEsMCwwLDAsMiwwVjM4LjIybDIuOTE4NzYuNTgzOTJhNC4wMDAzNSw0LjAwMDM1LDAsMCwxLTcuODM3NTIsMFoiPjwvcGF0aD48cGF0aCBkPSJNMzcsMzIuMDAwNDlhNiw2LDAsMSwwLDYsNkE2LjAwNjU2LDYuMDA2NTYsMCwwLDAsMzcsMzIuMDAwNDlabTAsMmEzLjk5MTQ3LDMuOTkxNDcsMCwwLDEsMy43NzU3NiwyLjczNTQxTDM3LjE5NjI5LDM2LjAyYy0uMDMyNjUtLjAwNjQxLS4wNjYxNi4wMDMxNy0uMDk5MzcsMGEuMjUwMjYuMjUwMjYsMCwwLDAtLjE5Mzg1LDBjLS4wMzMyLjAwMzE3LS4wNjY3MS0uMDA2NDEtLjA5OTM3LDBsLTMuNTc5NDcuNzE1ODhBMy45OTE0NywzLjk5MTQ3LDAsMCwxLDM3LDM0LjAwMDQ5Wm0wLDhBNC4wMDYsNC4wMDYsMCwwLDEsMzMuMDgxMjQsMzguODA0TDM2LDM4LjIydi43ODA0NmExLDEsMCwwLDAsMiwwVjM4LjIybDIuOTE4NzYuNTgzOTJBNC4wMDYsNC4wMDYsMCwwLDEsMzcsNDIuMDAwNDlaIj48L3BhdGg+PC9nPjwvc3ZnPg==",
      "icon": "data:image/svg+xml;base64,PHN2ZyBpZD0iRWJlbmVfMSIgZGF0YS1uYW1lPSJFYmVuZSAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAzMTUuNzUgMTc1LjI1Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2RjZGZlMTt9LmNscy0ye2ZpbGw6IzRmNGU0ZTt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNNjguMjEsNTkuNFY3My41OGMwLDEsMCwyLjE3LS4wNywzLjQ3cy0uMTMsMi42Mi0uMjMsNGguMzhhMTIuNjUsMTIuNjUsMCwwLDEsNC4xMS00LjU0QTEwLjU0LDEwLjU0LDAsMCwxLDc4LjIsNzVxNiwwLDkuNTYsNS41NlQ5MS4zLDk2LjM2cTAsMTAuMzgtMy41NCwxNlQ3OCwxMTguMDlhMTAuOTMsMTAuOTMsMCwwLDEtNS41Ny0xLjMsMTMuNjQsMTMuNjQsMCwwLDEtNC4xMS00aC0uNjFsLTEuNiw0LjQ5SDU3LjkyVjU5LjRabTYuNTYsMjQuMjRhNS4xMiw1LjEyLDAsMCwwLTUuMDcsMywyMS4zOCwyMS4zOCwwLDAsMC0xLjQ5LDguNjF2MS44M3EwLDYuMjYsMS41Myw5LjM0YTUuMjQsNS4yNCwwLDAsMCw1LjEsMy4wOHE2LDAsNi0xMy4xOFE4MC43OSw4My42NSw3NC43Nyw4My42NFoiLz48cGF0aCBjbGFzcz0iY2xzLTIiIGQ9Ik0xMDEuNzEsMTE3LjMyVjU5LjI0aDEwLjc1VjEwOC4xaDE2Ljc3djkuMjJaIi8+PHBhdGggY2xhc3M9ImNscy0yIiBkPSJNMTQ4LjM3LDc1LjYzdjQxLjY5SDEzOFY3NS42M1oiLz48cGF0aCBjbGFzcz0iY2xzLTIiIGQ9Ik0xNzkuNjksNzQuODdhMTEuMDgsMTEuMDgsMCwwLDEsOC44OCwzLjc4cTMuMjQsMy43NiwzLjI0LDExLjI0djI3LjQzSDE4MS40NFY5Mi43OGExNS44NywxNS44NywwLDAsMC0xLjEtNi43LDMuOTIsMy45MiwwLDAsMC0zLjg1LTIuMjksNS4yOSw1LjI5LDAsMCwwLTUuMjYsMy4yYy0xLDIuMTMtMS40NSw1LjYyLTEuNDUsMTAuNDR2MTkuODlIMTU5LjQ5Vjc1LjYzaDguMDhMMTY4Ljc5LDgxaC42MWExMC40NSwxMC40NSwwLDAsMSw0LjIzLTQuNTdBMTIuMTMsMTIuMTMsMCwwLDEsMTc5LjY5LDc0Ljg3WiIvPjxwYXRoIGNsYXNzPSJjbHMtMiIgZD0iTTIxMy4wNyw1OS40Vjg0Ljg2cTAsNS0uNDYsOS45aC4yM2MxLjIyLTIuMjMsMi4zOS00LjE5LDMuNTEtNS44Nmw5LjE1LTEzLjI3aDExLjM1TDIyNC4yOCw5M2wxMy4xOCwyNC4zMUgyMjZsLTguNzctMTcuMDctNC4xOSwzLjgxdjEzLjI2SDIwMi43OFY1OS40WiIvPjxwYXRoIGNsYXNzPSJjbHMtMSIgZD0iTTE0My43NSw1NS44M2E1LjgyLDUuODIsMCwwLDEtNC4wNy0xLjY0Yy0yLjMzLTIuMjYtNC40LTQuMzMtNi4zMi02LjMxYTUuODksNS44OSwwLDAsMSwuMDYtOC4zNGMzLjU0LTMuNTcsNy4xMi03LjEyLDEwLjQ2LTEwLjQzYTUuMzIsNS4zMiwwLDAsMSw0LjItMS42Myw1LjU3LDUuNTcsMCwwLDEsNC4zNCwxLjc4bDIsMiwzLjc5LDMuNzlhNi4yLDYuMiwwLDAsMSwxLjkxLDQuNjEsNi4xMSw2LjExLDAsMCwxLTIuMjUsNC40NGwtLjM1LjMxYy0uMi4xNy0uMzkuMzUtLjYuNTJsLTIuMjQtMi42OWMuMTctLjE0LjM1LS4yOS41My0uNDZsLjM4LS4zM2EyLjY1LDIuNjUsMCwwLDAsMS0xLjkyLDIuNjksMi42OSwwLDAsMC0uODgtMkwxNTIsMzMuNzhsLTItMmEyLjA5LDIuMDksMCwwLDAtMS43NC0uNzdsLS4xNiwwLS4xNiwwYTEuODEsMS44MSwwLDAsMC0xLjU1LjYzQzE0MywzNC45LDEzOS40MywzOC40NSwxMzUuOSw0MmEyLjM5LDIuMzksMCwwLDAsMCwzLjQ1YzEuOSwxLjk1LDMuOTQsNCw2LjI1LDYuMjRhMi4zOSwyLjM5LDAsMCwwLDMsLjE3LDEzLjIyLDEzLjIyLDAsMCwwLDEuMzctMS4yN2wuNDEtLjQxLDIuNDcsMi40OEwxNDksNTNhMTcsMTcsMCwwLDEtMS43NSwxLjYxQTUuODQsNS44NCwwLDAsMSwxNDMuNzUsNTUuODNaIi8+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMTQyLjU0LDY5LjE1aC0uMzhhNS41NSw1LjU1LDAsMCwxLTQuMzQtMS43OWMtLjY3LS42OC0xLjM1LTEuMzYtMi0yLTEuMjctMS4yNy0yLjU0LTIuNTMtMy44LTMuOGE2LDYsMCwwLDEsLjM0LTkuMDVsLjM1LS4zMS42LS41MiwyLjI0LDIuNjktLjUzLjQ2LS4zOC4zM2EyLjY1LDIuNjUsMCwwLDAtMSwxLjkyLDIuNzEsMi43MSwwLDAsMCwuODgsMmwzLjgsMy43OSwyLDJhMiwyLDAsMCwwLDEuNzMuNzdoLjMyQTEuODIsMS44MiwwLDAsMCwxNDMuOSw2NWMzLjM0LTMuMzEsNi45MS02Ljg1LDEwLjQ0LTEwLjQxYTIuMzgsMi4zOCwwLDAsMCwwLTMuNDRjLTEuOS0yLTMuOTQtNC02LjI1LTYuMjRhMi4zOCwyLjM4LDAsMCwwLTMuMDUtLjE4QTEzLjI5LDEzLjI5LDAsMCwwLDE0My43LDQ2bC0uNDEuNDFMMTQwLjgyLDQ0bC4zOS0uMzlBMTUuODcsMTUuODcsMCwwLDEsMTQzLDQyYTUuODcsNS44NywwLDAsMSw3LjYxLjQ1YzIuMzMsMi4yNyw0LjQsNC4zMyw2LjMyLDYuMzFhNS44OCw1Ljg4LDAsMCwxLS4wNiw4LjM1Yy0zLjU0LDMuNTYtNy4xMiw3LjExLTEwLjQ2LDEwLjQyQTUuMzQsNS4zNCwwLDAsMSwxNDIuNTQsNjkuMTVaIi8+PC9zdmc+",
      "registrationDate": "2024-06-14",
      "lastModified": "2024-06-14T22:59:03.949157+02:00",
      "useCases": [
        {
          "name": "ais",
          "version": "v4",
          "status": "ONBOARDING_CERTIFICATION",
          "from": "2022-05-26T01:49:48Z",
          "until": "2022-05-26T01:49:48Z",
          "scopes": "urn:blink:xs2a:ais",
          "properties": {}
        }
      ],
      "consentFlows": [
        {
          "type": "consent-flow-2",
          "version": "v2",
          "status": "ONBOARDING_CERTIFICATION",
          "from": "2022-05-26T01:49:48Z",
          "until": "2022-05-26T01:49:48Z",
          "endpointInfos": [
            {
              "name": "authorizationUrl",
              "url": "http://localhost:8082/serviceprovider/api/v2/oauth/authorize"
            }
          ]
        }
      ],
      "features": {},
      "providerId": "CIDX9999999961"
    }

Diagnostics - Healthchecks​

The Diagnostics endpoint can be used to check the availability of the bLink system. An empty request will be sent to bLink and responds with a timestamp and confirmation about receipt.

Routing​

The routing endpoints provide Service Users with visibility into which Service Providers they can or cannot interact with. This includes both formally instructed restrictions and a comprehensive list of routing limitations, as maintained by bLink based on available information.

GET/routinginstructions – Instructed Restrictions​

Returns all formally instructed routing blocks that apply to the requesting Service User. These instructions are submitted by Service Providers who have contractually decided not to allow connections from specific Service Users.

This endpoint allows Service Users to query whether such contractual restrictions have been applied to them.

Use when a Service User needs to verify if routing has been explicitly restricted by a Service Provider through a formal instruction.

GET/routing-information – Routing Overview​

Returns a comprehensive overview of the routing status for the requesting Service User, including:

  • permittedConnections: List of Service Providers the Service User is currently allowed to connect to.
  • blockedConnections: List of Service Providers the Service User is restricted from, including:
    • providerId: The identifier of the blocked Service Provider.
    • restrictionType: Reason for the restriction:
      • BLOCKING_INSTRUCTION: Based on a formal instruction submitted by the Service Provider.
      • BLOCKED_BY_PROVIDER: The Service Provider has blocked the Service User in their own environment.
      • FRIENDS_AND_FAMILY: Temporary limitation during a verification or onboarding phase.
    • description: Human-readable explanation of the restriction.

Use for a complete snapshot of routing permissions and known restrictions relevant to the Service User.

note

The GET/routing-information endpoint is environment-specific and reflects routing restrictions that are manually maintained by bLink. The data depends on inputs provided by Service Providers. As bLink typically does not have visibility into internal blocking decisions made by Service Providers, this list may not reflect all actual restrictions in real time. Routing configurations are officially captured on production, and mirrored to XP and XE on a best-effort basis.

Last updated on