Request: {
"debtor_name": "Northgate Trading Ltd",
"debtor_account": "GB29NWBK60161331926819",
"debtor_agent_bic": "NWBKGB2L",
"creditor_name": "Tanaka Trading Pte Ltd",
"creditor_address": {
"street": "1 Harbourfront Avenue",
"town": "Singapore",
"postcode": "098633",
"country": "SG"
},
"creditor_account": {
"bank_name": "DBS Bank Ltd, Singapore",
"bank_code": "7171",
"branch_code": "001",
"account_number": "1234567",
"note": "Singapore has no IBAN. Singapore accounts are identified by bank code + branch code + account number, not by IBAN."
},
"creResponse: {
"payment_id": "PAY-20261105-8841",
"status": "ACCP",
"status_description": "Accepted for processing: technical validation and customer profile checks passed. Settlement has not started.",
"uetr": "4f8a2c1e-7b3d-4e9a-8c2f-1a5d6e7f8b90",
"end_to_end_id": "INV-8841",
"value_date": "2026-11-05",
"created_at": "2026-11-05T09:12:00Z",
"request_id": "REQ-20261105-0001",
"estimated_charges": {
"amount": 42.0,
"currency": "USD",
"breakdown": [
{
"description": "First correspondent charge",
"amount": 20.0
},
{
"description": "SecoCreates a new customer credit transfer instruction. The caller supplies debtor, creditor, amount, currency and value date, and the API returns a payment identification that can be used to track the payment. The response
PSD2 and Open Banking
What you will learn
Your objective. By the end of this lesson, you will be able to explain PSD2 and open banking. The European Union's second Payment Services Directive, known as PSD2, changed the relationship between banks and their customers by giving customers the right to share their account data with third parties.
Why it matters. For a BA, open banking work means understanding the regulatory requirements, the consent model, the API specifications, and the liability rules, because when a third party initiates a payment that goes wrong, the question of who is responsible must have a clear answer.
Chapter objective: Learner explains API banking and open banking, including consent, authentication, and third-party access, and writes API requirements for a payment initiation use case. Learner demonstrates this skill using realistic banking examples, explaining each step clearly and using correct terminology throughout.
Key learning points
- European Union's second Payment Services Directive
- Account Information Service Provider aggregates account data
- Strong customer authentication
- Exemptions for low-value and low-risk payments
- Business impact
Key terms
Open banking: A system where banks share customer account data and payment services with licensed third parties through secure APIs, with customer consent.
PSD2: Payment Services Directive 2, a European Union law that opened banking to third party providers, required strong customer authentication, and set rules for payment services.
SCA: Strong customer authentication, a requirement under PSD2 that a payer must authenticate a payment with at least two of three factors, namely knowledge, possession and inherence.
API request and response viewer showing PSD2 and Open Banking.
Practise this lesson
Exercise
Scenario: you are testing a payment initiation API. A corporate customer sends a POST request to initiate a EUR 25,000 SEPA credit transfer. Validate the request: check the headers, the JSON body, and the business rules. Identify every error in the request, explain what is wrong, and write the corrected request and the expected response.
The request as sent: POST /v1/payments, headers: Authorization Bearer token-abc123, Content-Type application/json, Idempotency-Key empty, X-Request-ID req-001. JSON body: debtorAccount IBAN DE89370400440532013000, creditorAccount IBAN FR1420041010050500013M02606, instructedAmount currency EUR amount 25000, creditorName Loire Vins SARL, remittanceInformation INV-5520, requestedExecutionDate 2026-11-10, chargeBearer SLEV. Expected response: 202 Accepted with a payment ID, a status of ACCP, and a link to the status endpoint.
- What to do. Validate the request in three passes: headers, JSON body, business rules. List every error with the field, the rule it breaks, and the corrected value. Then write the corrected request and the expected 202 response.
Correct result. Header errors: Idempotency-Key is empty, but every POST that changes something requires an Idempotency-Key header, so set it to a unique value such as idem-20261110-001. JSON body errors: instructedAmount amount is 25000 as a number, but the API expects the amount as a string with two decimal places, so correct it to "25000.00". The creditorName is present, which is correct. The requestedExecutionDate 2026-11-10 is a valid date. Business rule errors: the debtor account IBAN DE89370400440532013000 is a valid German IBAN format, so that is correct. The creditor account IBAN FR1420041010050500013M02606 is a valid French IBAN format, so that is correct. The charge bearer SLEV is valid. The request can be accepted after correcting the Idempotency-Key and the amount format. Corrected request: POST /v1/payments, headers Authorization Bearer token-abc123, Content-Type application/json, Idempotency-Key idem-20261110-001, X-Request-ID req-001. Body: debtorAccount IBAN DE89370400440532013000, creditorAccount IBAN FR1420041010050500013M02606, instructedAmount currency EUR amount "25000.00", creditorName Loire Vins SARL, remittanceInformation INV-5520, requestedExecutionDate 2026-11-10, chargeBearer SLEV. Expected response: 202 Accepted, body paymentId PAY-20261110-001, status ACCP, status link /v1/payments/PAY-20261110-001/status, creation date and time 2026-11-10T09:00:00. Worked reasoning: a 202 Accepted means the request was accepted for processing, not that the payment settled. The payment status ACCP means accepted for processing; the final status ACCC (beneficiary credited) comes later via the status endpoint or a webhook. The Idempotency-Key is critical because if the customer retries the request, the same key returns the original response instead of creating a duplicate payment.
Why. Hint 1: validate headers first, because a missing Idempotency-Key is a request error that must be fixed before the body is checked. Hint 2: check the amount format against the API specification; a number where a string is expected is a schema error. Hint 3: a 202 response means accepted, not settled; the payment status must be checked separately. The worked explanation shows the API validation discipline: headers, body and business rules are three separate passes, and the response must be checked against the expected status code and body.
Check your understanding
Practice question
A bank exposes a payment status API. A corporate customer polls it every second for a payment that settles in two days. What should the bank offer instead, and why?
Takeaway and next step
What to remember
For a BA, open banking work means understanding the regulatory requirements, the consent model, the API specifications, and the liability rules, because when a third party initiates a payment that goes wrong, the question of who is responsible must have a clear answer.
Call the API described in this lesson with a valid request, then with a missing field, and compare the responses.
The introduction to PSD2 and open banking. The deep dive is ch65, Open Banking, PSD2 and PSD3.
Transcript and full text
Show transcript
The European Union's second Payment Services Directive, known as PSD2, changed the relationship between banks and their customers by giving customers the right to share their account data with third parties. Under PSD2, a bank must allow licensed third party providers to access a customer's account, with the customer's explicit consent, through secure APIs. There are two main types of provider. An Account Information Service Provider aggregates account data from several banks so the customer can see all their finances in one place. A Payment Initiation Service Provider lets a customer pay directly from their bank account from inside another app, such as an online shop, without entering card details. The bank remains responsible for the account and for strong customer authentication, but it no longer controls the whole customer experience. Strong customer authentication, or SCA, is the security rule that sits at the centre of PSD2. It requires two out of three factors for electronic payments. Something the customer knows, such as a password, something they have, such as a phone, and something they are, such as a fingerprint. This is why paying online in Europe now usually involves a push notification to a banking app or a biometric check. There are exemptions for low value and low risk payments, and the rules are complex, but the principle is clear. A single password is no longer enough. A BA working on payment journeys must design the SCA flow into the experience, including what happens when authentication fails, when a customer has no smartphone, and when a payment is exempt. Open banking has spread beyond Europe, with similar regimes in the United Kingdom, Australia, Brazil, India and elsewhere, each with its own rules and timelines. The business impact is significant, because banks lose their monopoly on the customer interface, and fintech companies can build services on top of bank accounts. For banks, the response has been to build good APIs, to offer their own aggregation and initiation services, and to monetise premium API access. For a BA, open banking work means understanding the regulatory requirements, the consent model, the API specifications, and the liability rules, because when a third party initiates a payment that goes wrong, the question of who is responsible must have a clear answer. A worked example shows PSD2 in practice. A customer of Bank A wants to pay a merchant using a payment initiation service provider, a PISP, rather than logging into Bank A's own app. The customer selects the PISP at checkout, is redirected to Bank A to authenticate with strong customer authentication, and consents to the payment. The PISP calls Bank A's payment initiation API with the customer's consent, and Bank A executes the payment. The customer never gives their Bank A password to the PISP, and the PISP never sees the customer's account balance. The payment settles as a normal credit transfer, and the merchant is credited. The PISP is regulated, it must be licensed, and it must carry professional indemnity insurance. For a business analyst, the requirement is to define the consent flow, the authentication steps, the API calls, and the liability if the payment goes wrong: the PISP is liable if it initiates a payment the customer did not consent to, and the bank is liable if it executes a payment without a valid consent. A failure scenario tests the consent. A customer consents to a payment of EUR 100 to a merchant, but the PISP initiates a payment of EUR 1,000. Bank A's API must reject the payment, because the amount does not match the consent, and must return a 422 error with a code indicating the consent mismatch. The bank must also log the attempt and notify the customer. If the bank executes the payment without checking the consent, it has breached its PSD2 obligations and is liable for the loss. The consent check is not optional: it is the control that prevents a PISP from initiating payments the customer did not agree to. PSD3, which is agreed but not yet law as of 7 November 2026, strengthens these controls further, but PSD2 remains the law in force. Last reviewed 7 November 2026. Further reading: PSD2 Directive (EU) 2015/2366; Berlin Group NextGenPSD2 API framework; European Banking Authority regulatory technical standards on strong customer authentication. Take a customer who uses a budgeting app that shows accounts from three banks. The customer consents in the app, is redirected to each bank to authenticate, and the app receives an access token for each bank. The app then calls each bank's account information API every morning and shows the customer a single view of their money. When the customer wants to pay a bill from the app, the app calls the payment initiation API, the customer authenticates with the bank, and the payment is made. The bank never sees the budgeting app's interface, and the app never sees the customer's bank password. That separation is the point of PSD2, and it is what makes the whole model work. Consent failures are the most sensitive part of open banking. Suppose a third party initiates a payment that the customer did not authorise, because the third party's system was compromised. The customer complains to the bank, the bank says the payment came through a licensed third party, and the third party says it acted on the customer's instruction. The liability rules must answer who pays, and the answer depends on the country, the type of provider, and whether strong customer authentication was performed. A BA must capture the liability matrix in requirements, the consent record that proves what the customer agreed to, and the dispute process that resolves it, because a payment that goes wrong through a third party is still the bank's problem to explain. Open banking requirements are regulatory requirements first and product requirements second. The BA must know the consent model: what the customer consents to, how long the consent lasts, how it is revoked, and what happens to data already shared. The BA must know the SCA exemptions: low value, recurring, trusted beneficiary, and when each one applies. And the BA must know the performance rules, because regulators set response times for bank APIs and fine banks that are too slow. A BA who treats open banking as a product feature without the regulatory layer will build something that fails its first compliance review.
The European Union's second Payment Services Directive, known as PSD2, changed the relationship between banks and their customers by giving customers the right to share their account data with third parties. Under PSD2, a bank must allow licensed third party providers to access a customer's account, with the customer's explicit consent, through secure APIs. There are two main types of provider. An Account Information Service Provider aggregates account data from several banks so the customer can see all their finances in one place. A Payment Initiation Service Provider lets a customer pay directly from their bank account from inside another app, such as an online shop, without entering card details. The bank remains responsible for the account and for strong customer authentication, but it no longer controls the whole customer experience.
Strong customer authentication, or SCA, is the security rule that sits at the centre of PSD2. It requires two out of three factors for electronic payments. Something the customer knows, such as a password, something they have, such as a phone, and something they are, such as a fingerprint. This is why paying online in Europe now usually involves a push notification to a banking app or a biometric check. There are exemptions for low value and low risk payments, and the rules are complex, but the principle is clear. A single password is no longer enough. A BA working on payment journeys must design the SCA flow into the experience, including what happens when authentication fails, when a customer has no smartphone, and when a payment is exempt.
Open banking has spread beyond Europe, with similar regimes in the United Kingdom, Australia, Brazil, India and elsewhere, each with its own rules and timelines. The business impact is significant, because banks lose their monopoly on the customer interface, and fintech companies can build services on top of bank accounts. For banks, the response has been to build good APIs, to offer their own aggregation and initiation services, and to monetise premium API access. For a BA, open banking work means understanding the regulatory requirements, the consent model, the API specifications, and the liability rules, because when a third party initiates a payment that goes wrong, the question of who is responsible must have a clear answer.
A worked example shows PSD2 in practice. A customer of Bank A wants to pay a merchant using a payment initiation service provider, a PISP, rather than logging into Bank A's own app. The customer selects the PISP at checkout, is redirected to Bank A to authenticate with strong customer authentication, and consents to the payment. The PISP calls Bank A's payment initiation API with the customer's consent, and Bank A executes the payment. The customer never gives their Bank A password to the PISP, and the PISP never sees the customer's account balance. The payment settles as a normal credit transfer, and the merchant is credited. The PISP is regulated, it must be licensed, and it must carry professional indemnity insurance. For a business analyst, the requirement is to define the consent flow, the authentication steps, the API calls, and the liability if the payment goes wrong: the PISP is liable if it initiates a payment the customer did not consent to, and the bank is liable if it executes a payment without a valid consent.
A failure scenario tests the consent. A customer consents to a payment of EUR 100 to a merchant, but the PISP initiates a payment of EUR 1,000. Bank A's API must reject the payment, because the amount does not match the consent, and must return a 422 error with a code indicating the consent mismatch. The bank must also log the attempt and notify the customer. If the bank executes the payment without checking the consent, it has breached its PSD2 obligations and is liable for the loss. The consent check is not optional: it is the control that prevents a PISP from initiating payments the customer did not agree to. PSD3, which is agreed but not yet law as of 7 November 2026, strengthens these controls further, but PSD2 remains the law in force. Last reviewed 7 November 2026. Further reading: PSD2 Directive (EU) 2015/2366; Berlin Group NextGenPSD2 API framework; European Banking Authority regulatory technical standards on strong customer authentication.
Take a customer who uses a budgeting app that shows accounts from three banks. The customer consents in the app, is redirected to each bank to authenticate, and the app receives an access token for each bank. The app then calls each bank's account information API every morning and shows the customer a single view of their money. When the customer wants to pay a bill from the app, the app calls the payment initiation API, the customer authenticates with the bank, and the payment is made. The bank never sees the budgeting app's interface, and the app never sees the customer's bank password. That separation is the point of PSD2, and it is what makes the whole model work.
Consent failures are the most sensitive part of open banking. Suppose a third party initiates a payment that the customer did not authorise, because the third party's system was compromised. The customer complains to the bank, the bank says the payment came through a licensed third party, and the third party says it acted on the customer's instruction. The liability rules must answer who pays, and the answer depends on the country, the type of provider, and whether strong customer authentication was performed. A BA must capture the liability matrix in requirements, the consent record that proves what the customer agreed to, and the dispute process that resolves it, because a payment that goes wrong through a third party is still the bank's problem to explain.
Open banking requirements are regulatory requirements first and product requirements second. The BA must know the consent model: what the customer consents to, how long the consent lasts, how it is revoked, and what happens to data already shared. The BA must know the SCA exemptions: low value, recurring, trusted beneficiary, and when each one applies. And the BA must know the performance rules, because regulators set response times for bank APIs and fine banks that are too slow. A BA who treats open banking as a product feature without the regulatory layer will build something that fails its first compliance review.
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.