Get a list of payment providers

In each market where Pay by Bank is being used, you can use the API to get a list of available providers, such as banks, who can facilitate this type of payment. To get a list of payment providers in the country where the payment is being made, use GET /providers.

If your client selects a provider, you can use the name of the provider to initiate a payment experience that connects directly to the chosen provider. No further providers will be presented during the checkout if you choose this approach.

You must include the two-character ISO code for the country in the request parameters.

Curl

curl --request GET \
  --url 'https://api-mock.payments.jpmorgan.com/tsapi/paybybank/v2/providers?market=GB' \
  --header 'Accept: application/json'

The successful response includes a list of providers. Within the providers object, you can see:

name - the correct name of the provider. You must use this if you want to specify the provider in your request to initiate the transaction.
accessType - the mechanism by which you can access the provider.
authenticationUserType - whether a user authenticates toward the bank as a person or a business.
capabilities - what this provider is capable of, in terms of financial data it can aggregate and if it can execute payments.
credentialsType - the type of credentials used when connecting to this provider - such as PASSWORD or THIRD_PARTY_APP.
currency - the default currency for the provider.
displayName - the exact wording for how the provder's name should be displayed.

200 response showing providers in the UK

Json

{
  "providers": [
    {
      "accessType": "OPEN_BANKING",
      "authenticationUserType": "BUSINESS",
      "authenticationFlow": "REDIRECT",
      "capabilities": [
        "CREDIT_CARDS",
        "CHECKING_ACCOUNTS",
        "SAVINGS_ACCOUNTS",
        "IDENTITY_DATA",
        "TRANSFERS"
      ],
      "pisCapabilities": [
        "FASTER_PAYMENTS"
      ],
      "credentialsType": "THIRD_PARTY_APP",
      "currency": "GBP",
      "displayName": "HSBC Kinetic",
      "fields": [],
      "financialInstitutionId": "a2f21124a09643ac97943e48dc3ee8cf",
      "financialInstitutionName": "HSBC Kinetic",
      "groupDisplayName": "HSBC",
      "images": {
        "icon": "https://www.jpmorgan.com/content/dam/jpmorgan/images/logos/jpm-logo-brown-062322.svg"
      },
      "market": "GB",
      "multiFactor": false,
      "name": "uk-hsbc-kinetic-ob",
      "passwordHelpText": "",
      "popular": false,
      "status": "ENABLED",
      "transactional": true,
      "type": "BANK",
      "financialServices": [
        {
          "segment": "BUSINESS",
          "shortName": "HSBC Kinetic Online"
        }
      ],
      "hasAuthenticationOptions": false,
      "healthStatus": {
        "providerLogin": {
          "status": "HEALTHY"
        }
      }
    }
  ]
}