Skip to main content
The Checkout element is the most advanced component in FunnelFox. It’s designed to reduce payment friction and maximize conversion rates by handling the complete payment flow from card collection to subscription creation.
Checkout element configuration

Use cases

Add Checkout to your funnel for:
  • First-time purchases - Initial subscription or one-time payment.
  • Trials - Free or paid trial activation.
  • Offers - Introductory or promotional discounts (coupons) applied to the first charge to boost conversion.
For upsells and additional purchases after the initial payment, use the Purchase action on buttons instead.

Create Checkout

To set up a Checkout, you need at least one configured payment provider. Learn about payment integrations.
Click + Add in the Visual editor, then select Paywall Elements > Checkout and follow the steps below.

1. Product selection

You can skip this step if you’re creating a funnel for a single product.
Each Checkout element handles payment for one product only. To accept payments for multiple products based on user selection:
  1. Add Options or Plan picker elements earlier in the funnel.
  2. Add one Checkout element for each product you sell.
  3. Go to the Element tab for your Checkout and set Visible to Conditional.
  4. Click + Add condition and select an answer from Plan pickers or Options leading to this Checkout.
  5. Repeat for each product you want to sell.
Learn about conditional element visibility.

2. Payment provider

  1. Go to the Element tab for the Checkout.
  2. Toggle on the payment providers you’ve integrated and configure the following:
  • Stripe
  • Solidgate
  • Paddle
  • Billing
  • Paypal
  • When payment succeeds: Navigation action to trigger when payment is completed.
  • When payment fails or is declined: Navigation action to trigger when payment fails due to a decline or error (including 3DS).
  • When payment is cancelled by user: Navigation action to trigger when user clicks the cancel button (if available).
  • Entitlement: Access level ID for subscription manager.
  • Account: Your Stripe account. Learn about multiple Stripe accounts in FunnelFox.
  • Product type: Defines the payment flow depending on what you sell
    • One-off product (for one-time payments)
    • Subscription
    • Subscription + discount
    • Free trial -> Subscription
    • Paid trial -> Subscription
  • Upgrade subscription:
    • No: Successful payment creates a new customer with the purchased subscription.
    • Yes: Use for upsells. Successful payment seamlessly upgrades the customer’s subscription plan to this one.
  • Stripe Tax: Enables tax calculations. Learn about Stripe Tax.
  • Allow promo codes: Enables promo code settings. Learn about promo codes setup.
  • Subscription: Define the Stripe subscription to sell.
  • Subscription/Intro discount: Define the Stripe coupon to apply.
  • Custom purchase value: Replaces the real price value in analytics & marketing tracking events. Use for value-based optimization where you can send a predicted LTV.
    • The real price value of the purchased product is sent if this field is empty.
Learn more about Stripe integration in FunnelFox.

3. Payment method

Once you enable a payment provider, you will see payment methods to set up:
  • Stripe
  • Solidgate
  • Paddle
  • Billing
  • Paypal
  1. Toggle on the payment methods you need in the Element tab:
  • Apple Pay
  • Google Pay
  • Card
  • PayPal
  1. Optionally, customize how the payment method looks:
  • Caption
  • Bullet list
  • Button prefix
  • Custom icon
  • Footer text
  • Total label
  1. Optionally, set Use as a fallback to Yes if you want to show this method only when other methods aren’t available. For example, you can choose to display only Card if Apple Pay fails to render.

4. Layout

Go to the Styles tab of your Checkout. Beyond the overall element layout in the Container section, you can also customize the appearance of the Accordion (payment methods list), Button, Errors, and Coupon Input (if enabled).
Set both the Text Color and Background of the Accordion so that input fields for payment details remain clearly visible to users.

Subscription configuration

Regardless of which you integrated with FunnelFox, all subscriptions in your funnels are configured through the Element tab of the Checkout. While editing the Payment Provider Settings section, you can configure:

Free trial

Start the subscription at no charge for a fixed period, then proceed with paid subscription.
  • Stripe
  • Solidgate
  • Paddle
  • Billing
  • Paypal
You can configure a free trial for any subscription created in Stripe:
  1. Select Free trial -> Subscription in the Product type.
  2. Set the number of days in the Trial period.
  3. Select the product to sell in the Subscription.
Begin with a low, introductory payment for a limited period, then proceed with full-price subscription.
  • Stripe
  • Solidgate
  • Paddle
  • Billing
  • Paypal
Before configuring a paid trial, you need:
  • Subscription product created in Stripe.
  • One-time product created in Stripe that will represent the charge for the paid trial in Checkout configuration.
To configure a paid trial:
  1. Select Paid trial -> Subscription in the Product type.
  2. Set the number of days in the Trial period.
  3. Select the product to sell in the Subscription. This is the full-price subscription to be charged after the trial.
  4. Select the one-time product to sell in the Trial price. This is the one-time item to define the paid trial.

Offers

Introductory or promotional discounts (coupons) applied to the first charge to boost conversion.
  • Stripe
  • Solidgate
  • Paddle
  • Billing
  • Paypal
You can configure an intro or promo offer for any subscription created in Stripe.Additionally, you need to create a Stripe coupon to be applied to the first charge.
Unlike paid trial configuration for Stripe, a coupon allows you to apply a percentage discount to any subscription using the same coupon.
Select how you want to implement your offer:
With intro discount:
  • You select a Stripe coupon to be applied to a specific subscription.
  • Customers won’t have to input promo codes manually.
  1. Select Subscription + Intro discount in the Product type.
  2. Select the product to sell in the Subscription.
  3. Select the coupon to reduce the first charge in the Intro Discount.
This option enables a promo code input field for your Checkout, allowing customers to enter a code manually.You will need to create a promotional code for your Stripe coupon.Once you have a Stripe promo code:
  1. Set Allow Promo codes to Yes.
  2. Set Show Manual Input to Yes.
This option allows you to apply a promo code through a URL query parameter so your customers won’t have to enter it manually.You will need to create a promotional code for your Stripe coupon.Once you have a Stripe promo code:
  1. Set Allow Promo codes to Yes.
  1. Add the promo code as a query parameter to the link leading customers to the funnel, for example, promo_code=SEPT2025
If you accidentally use a promo code and intro discount at the same time, only the promo code will be applied.

Upsell

Present a higher-value plan or add-on to customers.
  • Stripe
  • Solidgate
  • Paddle
  • Billing
  • Paypal
Stripe allows you to upsell both one-time products and subscription upgrades. Customers don’t need to provide their payment details again and will be charged with just one click.
You can configure an upsell for any one-time product created in Stripe:
  1. Add a Button element to your upsell screen.
  2. Set up the On Press section of the Element tab:
  • Action: Purchase
  • Payment Provider: Stripe
  1. Set up the one-time product to upsell:
  • Product type: One-off product
  • Product: Select the product to upsell
You can configure an upsell for any subscription created in Stripe. Customers will be charged for the price difference between the initial and final plan:
  1. Add a Button element to your upsell screen.
  2. Set up the On Press section of the Element tab:
  • Action: Purchase
  • Payment Provider: Stripe
  1. Set up the subscription to upsell:
  • Product type: Subscription
  • Upgrade subscription: Yes
  • New subscription: Select the subscription to upsell

Event triggers

When a user interacts with a Checkout, the following events are triggered:
  • checkout_presented: Each time the checkout element is shown.
  • checkout_impression: When the user sees the checkout for the first time. Triggers only once per user session.
  • checkout_screen_presented: When the user sees a screen with a checkout element.
For long paywall screens, checkout_screen_presented might be triggered without checkout_presented if the user leaves the funnel before reaching the Checkout element.
  • purchase_started: User enters payment details and taps Buy or taps a one-click purchase button for Apple Pay/Google Pay/PayPal.
  • purchase_completed_success: User successfully completes a purchase.
  • purchase_completed_fail: User fails to complete a purchase (e.g., due to wrong card details or insufficient funds).
  • user_email_collected: User enters a valid email (if Email input field is available on the checkout).
Learn more about events and their parameters.

Testing

Use test cards credentials to check how your Checkout works: No real charges occur while testing in Preview mode.

Troubleshooting

Go to the Styles tab of your Checkout. Set Text Color and Background in the Accordion section so payment input fields are clearly readable (high contrast) in your design.

Next steps

I