support pre-collected consent - #977

Summary & motivation

Summary

Adds TypeScript declarations for passing pre-collected Financial Connections Consent evidence through:

• collectBankAccountForPayment
• collectBankAccountForSetup
• collectFinancialConnectionsAccounts
• collectBankAccountToken

This introduces a shared PreCollectedConsent interface:

interface PreCollectedConsent {
  consent: string;
  collectedAt: number;
}

Motivation

Approved merchants can render Stripe-issued consent text in their own UI, collect affirmative customer acceptance, and provide the Consent ID and acceptance timestamp when launching Financial Connections.

The corresponding Stripe.js runtime support validates and forwards this evidence only when the private-preview beta is active. Server-side merchant eligibility and evidence validation remain authoritative, so providing preCollectedConsent does not guarantee that Stripe will omit its consent pane.

Testing & documentation

The additions to tests/types/src/valid.ts verify that all four supported methods accept preCollectedConsent.