Class StripeClientAdapter

constructor

• new StripeClientAdapter(config: StripeClientAdapterConfig): StripeClientAdapter

  Parameters

  • config: StripeClientAdapterConfig

  Returns StripeClientAdapter

ReadonlypspName

confirm

• confirm(handle: MountedFieldsHandle): Promise<ConfirmResult>

  Confirm-on-client shape (§4a): Stripe finalizes here, including inline 3DS (redirect: "if_required" keeps card flows in an iframe/modal — no navigation). Never returns a clientToken.

  Parameters

  • handle: MountedFieldsHandle

  Returns Promise<ConfirmResult>

handleRedirectReturn

• handleRedirectReturn(
      location: RedirectReturnLocation,
  ): Promise<ConfirmResult | null>

  Return-trip completion for redirect methods (iDEAL, bank redirects): Stripe lands the customer on returnUrl with payment_intent_client_secret (or setup_intent_client_secret) + redirect_status in the query string. Resolves the actual outcome from the intent itself — redirect_status alone is a hint, not the source of truth. Returns null when the URL carries no Stripe return params, so callers can probe every adapter safely.

  Parameters

  • location: RedirectReturnLocation

  Returns Promise<ConfirmResult | null>

listPaymentMethodCapabilities

• listPaymentMethodCapabilities(): PaymentMethodCapability[]

  Returns PaymentMethodCapability[]

loadSdk

• loadSdk(): Promise<void>

  Dynamic script/SDK load — only pulled in if this PSP is active.

  Returns Promise<void>

mount

• mount(
      container: HTMLElement,
      options: MountOptions,
  ): Promise<MountedFieldsHandle>

  Renders the PSP's hosted fields into container.

  Layout slot convention (split-field PSPs like Paysafe): when the host has placed elements carrying data-payfanout-field="<fieldName>" inside the container, the adapter mounts each hosted field INTO its slot — the host fully owns the layout (grid, rows, spacing). Without slots, the adapter falls back to its own stacked containers. Single-element PSPs (Stripe's Payment Element) control layout via MountOptions.fieldOptions instead.

  Parameters

  • container: HTMLElement
  • options: MountOptions

  Returns Promise<MountedFieldsHandle>

unmount

• unmount(handle: MountedFieldsHandle): void

  Parameters

  • handle: MountedFieldsHandle

  Returns void