Skip to main content

How to configure the Payment Element?

Payment Element is Stripe's integrated payment component that enables direct transaction processing within your paywall interface.

L
Written by Leanid Yuryeu
Updated over 2 weeks ago

Configuration Steps:

  • Access Paywall Editor:

    • Open the paywall editing interface

    • Select the Web platform option

    • Navigate to Paywall Settings

    • Click "Customize"

    • Choose "StripePaymentElement" from the Payment Method Kind dropdown

    • Select your Stripe environment (test or live)

    Important: Ensure all Stripe elements (products, prices, coupons) match this environment.

  • Stripe Payment Method Configuration attachment:
    *Connect a specific Stripe Payment Method Configuration (PMC) to your onboarding paywall using this option.

    • Create the configuration in Stripe

    • Paste its ID in the designated field

    • Choose View Kind (Payment Element Behavior)
      *This setting applies only when using StripePaymentElement and controls how the payment flow behaves after the user clicks the Buy button.

      • Options:

        • ClickAndPay: The system attempts to complete the payment immediately using the first available method from your configured priority list (set in Customize Stripe Parameters → options.paymentMethodOrder).
          The payment widget will be shown automatically in the following cases:

          • The first method in priority is Card

          • The user cancels Apple Pay or Google Pay

          • A payment error occurs with the initial method

        • ShowWidget
          Always displays the full Stripe Payment Element widget, allowing the user to manually select their preferred payment method.

          Tip:

          Use ClickAndPay to prioritize speed and frictionless payments.

          Use ShowWidget to provide full flexibility and control to the user.

  • Error Message Styling:

    • Customize error message appearance (color, font, etc.)

    • Applies to both Payment Element and Express Checkout

  • Widget Styling:

    • Adjust visual elements (background, buttons, spacing)

  • Advanced Parameters:

    • Click "Customize Stripe Parameters"

    • Appearance Field: Enter valid JSON for Payment Element styling
      Warning: JSON is not validated - ensure proper formatting

    • Options Configuration: Provide JSON for element behavior/layout
      Includes: layout, defaultValues, paymentMethodOrder, etc.
      Warning: Invalid JSON may disrupt functionality


Did this answer your question?