QA before a partner bank integration goes live
Before a United States or European Union fintech programme goes live with a new partner bank, map every money flow and limit, test the bank's application programming interface, events, files, and limits in its sandbox, reconcile a dry run against bank statements, retest fixed defects, and send the bank a test evidence pack mapped to its due diligence questionnaire.
A new partner bank, a due diligence questionnaire, and a launch date
The trigger is a signed term sheet with a bank. Its third-party risk team sends a due diligence questionnaire, its implementation team shares an API specification, file layouts, and sandbox credentials, and a launch date is set. The fintech company is launching its first programme or moving one from a bank that is exiting. The CTO, the compliance lead, and the founder who promised the date to investors own the outcome. Products include accounts, corporate cards, earned wage access, and loans built on a partner bank or a Banking-as-a-Service platform. Reviews of a live programme are covered in the sponsor bank compliance audit scenario.
In the United States, the bank runs sponsor bank due diligence as part of its third-party risk management, which the federal banking agencies address in the Interagency Guidance on Third-Party Relationships (88 FR 37920, 9 June 2023). Due diligence includes assessing the third party's ability to perform the activity as expected and to conduct it in a safe and sound manner. When technology is a major component of the relationship, the guidance calls it an effective practice to review both parties' information systems to identify gaps in service-level expectations and interoperability issues (section C.2.h). The agencies published proposed replacement guidance (91 FR 58536) on 15 September 2026, with comments due by 16 November 2026. Status verified on 2026-09-16: the 2023 guidance still applies, and the proposal keeps information security and cybersecurity capabilities among the factors due diligence may assess.
In the European Union, the partner is often an e-money or payment institution. Where the fintech company or its platform provides information and communication technology (ICT) services to that institution, DORA Article 28(4)(d) requires the institution, before it enters the contractual arrangement, to undertake all due diligence on the prospective ICT third-party service provider (Regulation (EU) 2022/2554).
What happens when the integration is not tested before launch
- Due diligence stalls on missing test results. Under the 2023 guidance, a bank may consider reviewing SOC reports (section C.2.f), results of vulnerability and penetration tests can provide valuable information (C.2.g), and a bank may review the results of operational resilience and business continuity testing (C.2.i). When a bank cannot obtain requested information, the guidance lists alternatives such as additional controls on the third party or using a different third party, which for the fintech company can mean lower starting limits or a lost launch slot.
- The bank's own order delays onboarding. The FDIC consent order against Lineage Bank (FDIC-23-0041b, dated 30 January 2024) required due diligence on each proposed fintech partner, including a written assessment of the readiness of management information systems for processing its transactions (paragraph 19(e)). The bank had to refrain from onboarding any new fintech partners until its formal onboarding process had been submitted to the FDIC Regional Director for review and comment, approved by the board, and implemented (paragraph 21). Under an order like this, integration test results are the evidence behind the bank's written assessment of systems readiness.
- Return files post to the wrong balances. The new bank sends ACH returns in a different file layout from the previous bank, and the parser skips entries with an unrecognised addenda format. End users spend credits that the bank reversed, and the programme reserve covers the loss. For a consumer account, a computational or bookkeeping error made by the financial institution relating to an electronic fund transfer is an error under Regulation E (12 CFR 1005.11(a)(1)(iv)). After a consumer's notice of error, the financial institution shall investigate promptly and, except as otherwise provided in paragraph (c), determine whether an error occurred within 10 business days (1005.11(c)(1)).
- Limit values differ from the previous bank. The new programme agreement lowers a daily limit, the batch upload channel still applies the old value, and the bank finds the breach in its own monitoring.
- Migrated balances do not match. A cutover without an item-level comparison of balances and pending card holds leaves differences that nobody can explain to the new bank at go-live.
The testing sequence before go-live
- Collect the bank's integration terms. Gather the API specification, event list, file layouts, cut-off times, and every limit and gate in the programme agreement. Output: an integration inventory with a source document for each item.
- Map the money flows. Trace each flow from end-user request to bank core posting, with failure paths and the party posting each entry. Output: a payment flow map.
- Prepare synthetic test data. Create synthetic end users, sandbox KYC outcomes, and test cards, and keep production account data out of every test environment. Output: a test data set and an environment access list.
- Test the API contract. Check every request, response, and error code against the bank's specification. Output: an API contract test suite that runs in CI.
- Test events and files. Replay duplicate, out-of-order, delayed, and unsigned events, and parse every return, statement, and settlement file layout the bank sends. Output: a webhook delivery, ordering, and retry test report and a payment file format validation suite.
- Test limits and gates per channel. Send values below, at, and above each limit through every channel, and confirm no money moves before KYC approval. Output: programme control and limit checks.
- Run a reconciliation dry run. Match several business days of sandbox activity item by item against bank statement files, with injected returns. Output: reconciliation test scenarios with a break log.
- Run the security and resilience tests the bank asks for. Output: a penetration test report and failover results where the questionnaire requests them.
- Fix, retest, and decide. Retest every defect that affects a balance, a limit, or a customer message. Output: a defect log with financial impact per defect and retest status.
- Assemble the evidence. Map scope, environments, API versions, run dates, results, and open defects to the bank's questionnaire. Output: a partner bank due diligence test evidence pack.
Timeline and scope
Durations are typical engineering estimates for one programme on one bank, not company statistics; the bank's review time comes on top.
| Phase | Duration (estimate) | Roles | Output |
|---|---|---|---|
| Integration inventory and flow map | 1-2 weeks | QA lead, engineering lead, bank implementation contact | Integration inventory, payment flow map |
| Test data and test build | 2-3 weeks | QA engineers, automation engineer | Test data set, API contract test suite |
| Sandbox execution: API, events, files, limits | 2-4 weeks | QA engineers, backend engineer | Webhook report, file validation suite, limit checks |
| Reconciliation dry run | 1-2 weeks | QA engineer, finance operations | Reconciliation scenarios, break log |
| Security and resilience tests | 1-3 weeks, in parallel | Security tester, platform engineer | Penetration test report, failover results |
| Fix, retest, evidence pack | 1-2 weeks | QA lead, compliance lead | Defect log, due diligence test evidence pack |
Scope grows with each payment rail in the programme, since ACH, wires, instant payments, and card issuing each bring their own message formats and return rules. A migration from another bank adds balance comparison, card reissue, and a cutover rehearsal. A programme in both the United States and the European Union needs a second evidence set. Consumer accounts add Regulation E error resolution timers, and a bank with only a scheduled certification environment moves execution onto its calendar.
How we help before launch
We test partner bank integrations for fintech companies and platforms, and our output goes into the bank's due diligence. The bank decides whether and when the programme launches.
- BaaS and partner bank integration testing covers steps 4 to 6 and 10: the API contract test suite; the webhook delivery, ordering, and retry test report; programme control and limit checks; and the partner bank due diligence test evidence pack.
- Ledger reconciliation testing covers step 7 with reconciliation test scenarios against bank, processor, and scheme files.
- Payment rails testing covers bank files in step 5 with return, reject, and recall test cases. Card issuing testing adds a card lifecycle test suite for a card programme.
- Data migration testing covers a move from a previous bank with a balance and transaction history comparison report and cutover and rollback rehearsal results.
- Security testing covers step 8 with a web, API, and mobile penetration test report, and operational resilience testing adds failover and recovery time results.
Related
Services
Standards
Guides
- How to test webhook delivery from BaaS and payment providers
- How to test ledger reconciliation against settlement files and bank statements
- How to test Nacha return codes: ACH return entries, time frames, and ledger effects
- How to reconcile camt.053 statements: format, batch entries, reversals, and MT940 mapping
- How to test payment idempotency
Questions
How to choose a sponsor bank
Scope testing before your partner bank launch
Send the bank's integration documents, your launch date, and the rails and card products in the programme, and we return a test sequence with the evidence each phase produces.