Wallet-only checkout

When showOnlyWalletMethods is true, the widget can hide the card form, custom fields, and in-iframe pay button, plus the host “OR” divider — so customers only see Apple Pay and/or Google Pay when at least one is available. If configuration is invalid, no wallet is available, readiness times out, or a wallet payment fails, the widget falls back to the full UI (card form, fields, submit, and “OR” divider). User cancellation of the wallet sheet does not expand the form; only failures and fallbacks do.

Where things render

UI	Location
Apple Pay / Google Pay buttons	Host page, above the iframe
”OR” divider	Host page, between wallets and iframe
Card form, fields, submit	Inside the iframe

Config

{
  showOnlyWalletMethods: true,
  applePayEnabled: true,
  applePayOptions: { applePayMerchantId: 'merchant.xxx' },
  googlePayEnabled: true,
  googlePayOptions: { googlePayMerchantId: 'merchant.xxx' },
  // productId, sessionId, amount, environment, ...
}

At least one wallet must be fully configured for wallet-only mode to be considered.

Decision flow

Wants wallet-only: showOnlyWalletMethods === true and Apple or Google fully configured.
Wait for PS_WALLET_READINESS from the parent SDK (or 5s timeout → full UI).
At least one configured wallet must report true in readiness; otherwise full UI.
Wallet payment error forces full UI until config changes or a new session resets state.

Events

Event	Payload	Notes
`WALLET_FORM_LAYOUT`	`{ showOrDivider: boolean }`	Host toggles “OR” divider
`HEIGHT_CHANGE`	`{ height: number }`	Iframe auto-resize
`ERROR` with `NO_CARD_FORM`	—	`submitPayment()` blocked while card hidden

PS_WALLET_READINESS is an internal parent↔iframe message (not in public EVENT_TYPES).

External pay button

With wallet-only + hidePaymentButton: true, payment is triggered by wallet buttons only. submitPayment() returns NO_CARD_FORM until fallback expands the card UI.

Live demo

Try wallet-only mode in the sandbox playground: https://payment.paysight.io/demo?preset=both-wallets — toggle showOnlyWalletMethods in the host controls.

Paysight Guides

Zero to Hero

Shopify Checkout

Integration Guides

Where things render

Config

Decision flow

Events

External pay button

Live demo

​Where things render

​Config

​Decision flow

​Events

​External pay button

​Live demo

​Related

Where things render

Config

Decision flow

Events

External pay button

Live demo

Related