Skip to main content

Open banking bank preselection

Use bank preselection when you want to show bank-specific buttons in your own checkout, such as "Pay with Revolut", while still sending the customer through a Radom open banking checkout session.

Radom exposes provider-neutral bank identifiers. Do not display or store underlying provider names in your product, and do not rely on provider-specific bank IDs. Bank availability can change, so refresh the catalogue periodically instead of hardcoding a permanent list.

List available banks​

Call the bank catalogue endpoint for the market and currency you want to support:

curl "https://api.radom.com/open_banking/banks?market=DE&currency=EUR&search=Revolut" \
  -H "Authorization: Bearer <api-key>"

Each bank returns a Radom id, display name, supported markets, currencies, capabilities, and payment schemes.

Create a checkout session with a selected bank​

Pass the Radom bank id as gateway.openBanking.bankId when creating the checkout session:

{
  "gateway": {
    "openBanking": {
      "email": "customer@example.com",
      "bankId": "ob_..."
    }
  }
}

If the same bank is available in multiple markets, also pass gateway.openBanking.market:

{
  "gateway": {
    "openBanking": {
      "email": "customer@example.com",
      "bankId": "ob_...",
      "market": "DE"
    }
  }
}

If bankId is omitted, checkout session creation behaves as before and the customer chooses their bank during the hosted flow.

Country-specific banks​

Some banks operate in multiple countries and may have different local availability or payment schemes. Use the catalogue response to decide whether a single bank button should be shown globally or separately per country. When in doubt, collect the customer's country first and pass market alongside bankId.

Error handling​

If a selected bank is no longer available for the requested market, currency, or checkout configuration, Radom returns a validation error and no checkout session is created. Refresh the catalogue and ask the customer to choose another bank.