Skip to content

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. Run the security and resilience tests the bank asks for. Output: a penetration test report and failover results where the questionnaire requests them.
  9. 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.
  10. 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.

PhaseDuration (estimate)RolesOutput
Integration inventory and flow map1-2 weeksQA lead, engineering lead, bank implementation contactIntegration inventory, payment flow map
Test data and test build2-3 weeksQA engineers, automation engineerTest data set, API contract test suite
Sandbox execution: API, events, files, limits2-4 weeksQA engineers, backend engineerWebhook report, file validation suite, limit checks
Reconciliation dry run1-2 weeksQA engineer, finance operationsReconciliation scenarios, break log
Security and resilience tests1-3 weeks, in parallelSecurity tester, platform engineerPenetration test report, failover results
Fix, retest, evidence pack1-2 weeksQA lead, compliance leadDefect 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.

Questions

How to choose a sponsor bank

A United States fintech company can compare sponsor banks on what their integration supports before signing: a sandbox that returns realistic errors and returns, documented settlement and statement file formats, cut-off times, programme limits written into the agreement, notice periods for application programming interface changes, and the test evidence the bank's third-party risk team expects before launch.

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.