Type Alias EmbeddedRowSelectionBehavior

EmbeddedRowSelectionBehavior:
    | { type: "default" }
    | { type: "immediateAction"; onSelectPaymentOption?: () => void }

Describes how the EmbeddedPaymentElement handles payment method row selections:

  • In the default case, the payment method option row enters a selected state.
  • In the immediateAction case, onSelectPaymentOption is called.

Type declaration

  • { type: "default" }
    • type: "default"

      When a payment method option is selected, the customer taps a button to continue or confirm payment. This is the default recommended integration.

  • { type: "immediateAction"; onSelectPaymentOption?: () => void }
    • type: "immediateAction"

      When a payment method option is selected, onSelectPaymentOption is triggered. You can implement this function to immediately perform an action such as going back to the checkout screen or confirming the payment. Note that certain payment options like Apple Pay and saved payment methods are disabled in this mode if you set EmbeddedPaymentElementConfiguration.formSheetAction to continue

    • OptionalonSelectPaymentOption?: () => void