Skip to content
XSIS
Talk to an engineer

Integrations

Open banking APIs

Open banking: account data and payments through bank APIs

Account information and payment initiation through regulated bank APIs and aggregators, with consent and token handling.

Blueprint

Open banking: data and payments with the customer’s consentThe customer grants consent, the connector holds the tokens, and every call to the bank is authorised and logged. When consent expires or is withdrawn, the app asks the customer again instead of failing quietly.PeopleCustomerServiceYour app orplatformTreasury, lending oraccountingXSISOpen bankingconnectorConsent, tokens anddata normalisationBankBank APIs oraggregatorAccount informationand payment initiationERPERP or ledgerCash position andreconciliation12REST/JSON3OAuth 2.0 · FAPIREST4REST/JSON · webhook5REST/JSON6HTTP 401 · 4037

Open banking: data and payments with the customer’s consent

The customer grants consent, the connector holds the tokens, and every call to the bank is authorised and logged. When consent expires or is withdrawn, the app asks the customer again instead of failing quietly.

  • Primary flow
  • Asynchronous
  • Exception path

The flow, step by step

  1. From Customer to Your app or platform: Grants consent (primary flow).
  2. From Your app or platform to Open banking connector: Account and payment requests, over REST/JSON (primary flow).
  3. From Open banking connector to Bank APIs or aggregator: Authorised API calls, over OAuth 2.0 · FAPI · REST (primary flow).
  4. From Bank APIs or aggregator to Open banking connector: Balances, transactions and payment status, over REST/JSON · webhook (asynchronous).
  5. From Open banking connector to ERP or ledger: Normalised transactions, over REST/JSON (primary flow).
  6. From Bank APIs or aggregator to Open banking connector: Consent expired or withdrawn, over HTTP 401 · 403 (exception path).
  7. From Open banking connector to Your app or platform: Customer asked to renew consent (exception path).

Overview

Open banking lets an application read a customer’s accounts and start payments through regulated bank APIs, with the customer’s consent. It powers account aggregation, affordability checks for lending, pay-by-bank checkouts and treasury views across banks.

The reference design puts an open banking connector between your application and the banks, either directly or through a licensed aggregator. The connector runs the consent journey, holds the tokens securely, calls the bank APIs under standards such as Berlin Group NextGenPSD2 or the UK Open Banking Standard, and turns each bank’s data into one consistent model.

Consent is not permanent, and the design plans for it. When consent expires or is withdrawn, the customer is asked to renew it instead of the application quietly losing data. Every call is authorised, logged and tied to the consent that allowed it.

How the flow works

  1. 01

    The customer grants consent

    The customer chooses their bank, sees what is being shared and for how long, and authenticates with the bank, which redirects back to your application.

  2. 02

    Your application asks

    Your application requests balances, transactions or a payment through the connector’s API, never through the bank directly.

  3. 03

    The connector calls the bank

    The connector uses the stored tokens to make authorised calls to the bank’s API or the aggregator, following the security profile the bank requires.

  4. 04

    Data and status come back

    Balances, transactions and payment status return as responses or webhooks, and the connector normalises them into one model across banks.

  5. 05

    Use the data

    Normalised transactions feed your product, your risk models or your ERP for cash positions and reconciliation.

When something fails

Consent expires or is withdrawn

The bank refuses the call. The connector marks the consent as no longer valid and your application asks the customer to renew it, explaining why.

A payment is rejected

The bank’s status and reason come back through the API or a webhook, and the customer and your operations team see the outcome straight away.

A bank limits access

Banks limit how often data can be fetched without the customer present. The connector schedules refreshes within those limits and backs off when a bank signals it.

A bank API is unavailable

Calls are retried with increasing delays, the last good data is shown with its age, and an alert is raised if the outage continues.

Standards and systems

Banking standards and channels
  • PSD2
  • Berlin Group NextGenPSD2
  • UK Open Banking Standard
  • FAPI
Integration
  • REST
  • Webhooks
Identity and access
  • OAuth 2.0
  • OpenID Connect

Questions and answers

Should we connect to banks directly or through an aggregator?

An aggregator gives you many banks through one API and handles each bank’s differences, at a per-call or per-connection cost. Direct connections give more control and can suit a small number of important banks. Many products start with an aggregator and add direct connections later. We compare the options against the banks and countries you need.

Link to this question
Do we need a licence to use open banking?

Account information and payment initiation are regulated activities in many countries. Either your company holds the authorisation, or you work through a licensed provider that holds it. Which applies depends on your country and use case, and your legal and compliance advisers should confirm it. We build the integration for whichever route you take.

Link to this question
Which banks and countries are covered?

Coverage depends on the region’s rules and the banks’ APIs. The European Union and the United Kingdom have broad coverage under PSD2 and the UK Open Banking Standard. Elsewhere coverage varies, and aggregators fill some of the gaps. We check coverage for the banks your customers use before you commit to a design.

Link to this question
Does open banking replace host-to-host bank connections?

Not for most corporate treasury work. Host-to-host channels handle bulk payment files and full statements for your own accounts. Open banking suits customer-facing products, real-time balances and single payments. Many businesses use both: host-to-host for their own payment runs and open banking for their customers.

Link to this question
How is open banking data protected?

Tokens and consent records are encrypted at rest, only the connector can use them, and every call is logged with the consent behind it. We collect only the data the purpose needs and set how long it is kept. Data protection rules such as GDPR apply to this data, and we design with your data protection officer.

Link to this question

Tell us what you need to build or connect.

Describe the systems, the timeline and the constraints. The right engineers take it from there.

  • Our team will call you within 24 hours during your preferred time slot
  • Our team is available 24/7