Payments Academy
Step Entry
Step 1 Banking as a service is the platform that makes embedded finance possible
Step 2 The API layer is the product
Step 3 Ledgering is the discipline that makes banking as a service work
Step 4 Reconciliation in banking as a service has an extra layer
Step 5 Control is the sponsor bank's non-negotiable requirement
0:00 / 4:09 Step 1 of 6

Banking as a service in practice: the API layer, ledgering and control

Embedded finance and ISO 20022 data analytics, Lesson 2 of 7, Narration 4:09, D15 Advanced and emerging payments

ReconciliationIdempotencyValue date

What you will learn

Your objective. By the end of this lesson, you will be able to explain banking as a service in practice: the API layer, ledgering and control and apply it to a real banking scenario.

Why it matters. For a business analyst, banking as a service is an API and a ledger specification.

Chapter objective: Embedded payments, banking as a service, and what richer ISO 20022 data makes possible

Key learning points

  • Banking as a service platform
  • API idempotency
  • BaaS ledger
  • BaaS reconciliation
  • Brand onboarding due diligence
  • BaaS acceptance criteria

Key terms

Reconciliation: The process of comparing records from two sources, such as a bank statement and an internal ledger, to confirm they agree.

Idempotency: The property that repeating the same request has the same effect as sending it once. In payments, an idempotency key lets a client safely retry a request after a timeout without creating a duplicate...

Value date: The date on which funds become available to the beneficiary and on which interest starts to accrue. It is the date used for settlement and for nostro posting.

Accounting ledger showing Banking as a service in practice: the API layer, ledgering and control.

Practise this lesson

Exercise

Write the request and the expected response for the API call described in this lesson.

Use the API resources, operations and fields named in this lesson.

  1. What to do. Write the JSON request with the required fields, the success response, and one error response with its error code.

Correct result. A correct request has all mandatory fields, a valid idempotency key, and the right resource and operation. The success response confirms acceptance, and the error response names the field or rule that failed.

Why. An API contract is a promise between two systems. If the request is wrong, the API must reject it cleanly, not fail silently.

Check your understanding

Practice question

Which of the following best describes banking as a service in practice: the API layer, ledgering and control?

Takeaway and next step

What to remember

The brand never sees the payment rails, and the customer never sees the bank.

Call the API described in this lesson with a valid request, then with a missing field, and compare the responses.

Open the API Playground →

Builds on "Embedded finance: payments inside another company's product".

Transcript and full text

Show transcript

Banking as a service is the platform that makes embedded finance possible. It is a set of APIs provided by a regulated entity, usually an electronic money institution or a sponsor bank, that lets a non-financial company offer accounts, cards and payments. The APIs cover account creation, balance enquiry, payment initiation, payment status, card issuance, and transaction history. The brand calls the APIs, the provider executes the payments, and the sponsor bank holds the money. The brand never sees the payment rails, and the customer never sees the bank. The API layer is the product. It must be well documented, versioned, and tested, because the brand's developers build against it, and a breaking change will break every brand. The API must support idempotency, so a retried request does not create a duplicate payment. It must support webhooks, so the brand is told when a payment settles or fails, without polling. It must support pagination, so a transaction history with ten thousand entries can be retrieved in pages. And it must be secure, with OAuth 2.0 for authentication and mutual TLS for the connection. The API specification is the contract between the provider and the brand. Ledgering is the discipline that makes banking as a service work. Every payment must be recorded in a ledger, with a debit and a credit, a value date, and a reference. The ledger must balance at all times, and the balance must be reconcilable to the sponsor bank's account. The ledger is the source of truth for the customer's balance, and if the ledger is wrong, the balance is wrong, and the customer will see money that is not there, or will not see money that is. The requirements must state the ledger structure, the posting rules, and the reconciliation. Reconciliation in banking as a service has an extra layer, because there are two ledgers: the provider's ledger, which records what the brand's customers did, and the sponsor bank's ledger, which records what the bank did. The two must agree, and the reconciliation must run daily, with breaks investigated the same day. A break where the provider's ledger shows a payment the bank did not make is a serious defect, because the customer has been told the payment was made. The reconciliation must be automated, and the breaks must be visible to the operations team. Control is the sponsor bank's non-negotiable requirement. The bank must be able to see every payment in real time, must be able to stop a payment before it is sent, must be able to freeze an account, and must be able to audit the provider's systems. The bank must also be able to take over the operation if the provider fails, which means the bank must hold the data, the ledger, and the customer records, not just the money. A sponsor bank that cannot take over is a sponsor bank that is dependent on a single provider, and that is a concentration risk. The onboarding of a brand is a due diligence exercise. The provider must assess the brand's business model, its customer base, its risk appetite, and its compliance capability. A brand that serves high-risk customers, or that operates in a high-risk jurisdiction, will be rejected, or will be accepted with limits. The onboarding must be documented, and the risk assessment must be reviewed annually, because the brand's business changes, and the risk changes with it. The requirements must state the onboarding checklist, the risk criteria, and the review frequency. For a business analyst, banking as a service is an API and a ledger specification. The API specification must state every endpoint, every field, every error code, and every webhook. The ledger specification must state every posting rule, every reconciliation, and every control. The acceptance criteria must include a test where a payment is made through the API, the ledger is checked, the reconciliation is run, and the sponsor bank's view is verified. Last reviewed 7 November 2026. Further reading: the European Banking Authority opinion on banking as a service; the Financial Conduct Authority guidance on banking as a service; the Bank for International Settlements work on embedded finance; the OpenAPI specification documentation.

Banking as a service is the platform that makes embedded finance possible. It is a set of APIs provided by a regulated entity, usually an electronic money institution or a sponsor bank, that lets a non-financial company offer accounts, cards and payments. The APIs cover account creation, balance enquiry, payment initiation, payment status, card issuance, and transaction history. The brand calls the APIs, the provider executes the payments, and the sponsor bank holds the money. The brand never sees the payment rails, and the customer never sees the bank.

The API layer is the product. It must be well documented, versioned, and tested, because the brand's developers build against it, and a breaking change will break every brand. The API must support idempotency, so a retried request does not create a duplicate payment. It must support webhooks, so the brand is told when a payment settles or fails, without polling. It must support pagination, so a transaction history with ten thousand entries can be retrieved in pages. And it must be secure, with OAuth 2.0 for authentication and mutual TLS for the connection. The API specification is the contract between the provider and the brand.

Ledgering is the discipline that makes banking as a service work. Every payment must be recorded in a ledger, with a debit and a credit, a value date, and a reference. The ledger must balance at all times, and the balance must be reconcilable to the sponsor bank's account. The ledger is the source of truth for the customer's balance, and if the ledger is wrong, the balance is wrong, and the customer will see money that is not there, or will not see money that is. The requirements must state the ledger structure, the posting rules, and the reconciliation.

Reconciliation in banking as a service has an extra layer, because there are two ledgers: the provider's ledger, which records what the brand's customers did, and the sponsor bank's ledger, which records what the bank did. The two must agree, and the reconciliation must run daily, with breaks investigated the same day. A break where the provider's ledger shows a payment the bank did not make is a serious defect, because the customer has been told the payment was made. The reconciliation must be automated, and the breaks must be visible to the operations team.

Control is the sponsor bank's non-negotiable requirement. The bank must be able to see every payment in real time, must be able to stop a payment before it is sent, must be able to freeze an account, and must be able to audit the provider's systems. The bank must also be able to take over the operation if the provider fails, which means the bank must hold the data, the ledger, and the customer records, not just the money. A sponsor bank that cannot take over is a sponsor bank that is dependent on a single provider, and that is a concentration risk.

The onboarding of a brand is a due diligence exercise. The provider must assess the brand's business model, its customer base, its risk appetite, and its compliance capability. A brand that serves high-risk customers, or that operates in a high-risk jurisdiction, will be rejected, or will be accepted with limits. The onboarding must be documented, and the risk assessment must be reviewed annually, because the brand's business changes, and the risk changes with it. The requirements must state the onboarding checklist, the risk criteria, and the review frequency.

For a business analyst, banking as a service is an API and a ledger specification. The API specification must state every endpoint, every field, every error code, and every webhook. The ledger specification must state every posting rule, every reconciliation, and every control. The acceptance criteria must include a test where a payment is made through the API, the ledger is checked, the reconciliation is run, and the sponsor bank's view is verified. Last reviewed 7 November 2026. Further reading: the European Banking Authority opinion on banking as a service; the Financial Conduct Authority guidance on banking as a service; the Bank for International Settlements work on embedded finance; the OpenAPI specification documentation.

Full lesson text (all scenes)

Completing a lesson updates your progress dashboard on the homepage.

Scene timestamps are estimated by allocating the narration text proportionally across the real audio length. The audio playback position is the source of truth: pause freezes the visual, seeking restores the correct scene, replay restarts the scene animation.