onExit

onExit fires when the shopper leaves a launched surface without completing it: the wallet sheet is dismissed without authorizing, or the bank-linking modal is closed. It is the dedicated channel for “shopper dismissed something”, distinct from an error. Emitted by applePay, googlePay, bank (Plaid mode), and checkout (when its active sub-method is one of those). Every other element omits the key from its event map; subscribing is a TypeScript error and a runtime no-op (with a console warning).

`onExit` is not an error

onError is reserved for genuine failures (validation, tokenization, network, vendor errors). Shopper abandonment fires onExit only. Wallets and bank deliberately suppress the corresponding onError envelope when the underlying provider reports a cancellation or exit.

Payload

Wallets:

type WalletExitPayload = { elementType: 'applePay' | 'googlePay' };

Bank (Plaid mode):

type BankExitPayload = {
  elementType: 'bank';
  bankMode: 'plaid';
  plaidMetadata: PlaidLinkOnExitMetadata; // always populated
  plaidError?: PlaidLinkError;             // populated when the shopper exited after an in-flow error
};

Checkout:

type CheckoutExitPayload =
  | { elementType: 'checkout'; paymentMethod: 'applePay' | 'googlePay' }
  | { elementType: 'checkout'; paymentMethod: 'bank'; bankMode: 'plaid';
      plaidMetadata: PlaidLinkOnExitMetadata; plaidError?: PlaidLinkError };

Example (wallet)

applePay.on('onExit', () => {
  showPaymentMethodPicker();
});

Example (bank)

plaidMetadata is always populated when the shopper leaves the linking modal. plaidError is populated only when they exited after hitting an in-flow error (for example, an invalid-credentials attempt):

bank.on('onExit', (event) => {
  if (event.bankMode === 'plaid') {
    if (event.plaidError) {
      analytics.track('bank_exit_with_error', {
        institution: event.plaidMetadata.institution?.name,
      });
    } else {
      analytics.track('bank_modal_dismissed', {
        institution: event.plaidMetadata.institution?.name,
      });
    }
  }
});

When plaidError is present, the SDK additionally fires onError with code: 'plaid_link_failed' (deduplicated so consumers do not see multiple envelopes for the same underlying failure). Subscribing only to onExit still gives you the full context via plaidError.

Example (Checkout)

checkout.on('onExit', (event) => {
  if (event.paymentMethod === 'bank') {
    // event.bankMode is 'plaid', event.plaidMetadata is available.
    analytics.track('bank_modal_dismissed_in_checkout');
  } else {
    // event.paymentMethod is 'applePay' or 'googlePay'.
    analytics.track('wallet_sheet_dismissed', { method: event.paymentMethod });
  }
});

Elements that do not emit `onExit`

card, standalone inputs (email, phone, fullName, address elements, custom elements), and submitButton never fire onExit. Their event maps omit the key.

Get started

Elements

Options

Events

Theming

Guides

`onExit` is not an error

Payload

Example (wallet)

Example (bank)

Example (Checkout)

Elements that do not emit `onExit`

See also

​onExit is not an error

​Payload

​Example (wallet)

​Example (bank)

​Example (Checkout)

​Elements that do not emit onExit

​See also

`onExit` is not an error

Payload

Example (wallet)

Example (bank)

Example (Checkout)

Elements that do not emit `onExit`

See also