Set up checkout for Adapty Mail

Each email Adapty Mail sends contains a unique checkout link for that recipient. When they click, they land on a web checkout funnel that identifies them by profile, presents your offer, and processes payment. Checkout funnels live in Web Paywalls inside Adapty Mail and are edited in the bundled web paywall builder.

Requirements

  • A web payment provider with your subscription products configured. Generate with AI supports Stripe only and connects in the builder. Use your own hosted paywall accepts any provider — Stripe, Paddle, PayPal, or other — since payment is handled on your side.

You don’t need a separate account for the web paywall builder. It’s bundled with Adapty Mail: a workspace is provisioned automatically the first time you log in, and you’re signed into the editor using your Adapty credentials. This is independent of any web paywall you may have configured on the main Adapty dashboard’s paywall page — Adapty Mail’s web paywalls are separate entities, managed entirely from Adapty Mail.

Set up your checkout funnel

In Adapty Mail, go to Web Paywalls → Create. You have two paths:

  • Generate with AI: Adapty Mail’s bundled web paywall builder generates the funnel for you. Stripe only — for Paddle or PayPal, use the second option.
  • Use your own hosted paywall: Plug in a paywall you already host, on any payment provider.

Generate with AI

The Create page shows a Prerequisites panel at the top with inline action buttons that walk you through each precondition — brand readiness, builder login, Stripe connection, products, and a final review-and-publish step. Work through it; the panel refreshes as each step completes.

Prerequisites panel on the Web Paywall Create page with checklist items and inline action buttons

When prerequisites are green, click Generate to open the generation dialog. Two choices to make:

  • Environment: Pick Production or Sandbox. Sandbox uses your Stripe test-mode products and is the safe default for dev and local environments — its account is isolated from production, so test transactions never affect live data.
  • Plans: Pick up to 3 Stripe plans. Each plan is a product + price combination. The paywall presents these as the offers at checkout. If you pick fewer than 3, the paywall lays out only the plans you selected.
Web paywall generation dialog with Environment toggle and Stripe plan selector

Click Generate to run the build. When it finishes, open the editor in the builder to review the result and publish. Then, click Save.

The paywall must be published before it can serve checkout traffic. Unpublished paywalls return an error when users click email checkout links.

For payment provider details inside the builder (Stripe accounts, test vs live mode, product setup), see Web paywall configuration.

Use your own hosted paywall

  1. On the Create page, select Enter URL manually.

  2. Paste your hosted paywall URL. It must include {email} and {external_profile_id} placeholders as query parameters — Adapty Mail fills these in per recipient so the page knows who the visitor is. Example:

    https://example.com/paywall?email={email}&profile={external_profile_id}
  3. Save.

This path works with any payment provider — Adapty Mail only handles the redirect and parameter substitution; payment and personalization happen entirely on your side.

What the checkout looks like

When a user clicks a checkout link, they land on the Main conversion page. After they attempt payment, they see either Payment success or Payment failed — only one is shown per attempt.

Main conversion page A full-page sales presentation. AI generates the copy and images for each section:

SectionWhat AI generates
HeadlineBold, benefit-driven headline
SubheadlineSupporting value proposition
Offer badgeUrgency badge (no invented prices — uses vague promo language)
CTA buttonAction-oriented text, 2–5 words
Benefits3–6 emoji + text benefit cards
Features3–8 feature descriptions with title and subtitle
PlansPlan selection title and offer timer text
Social proofCommunity proof text and 3–5 realistic user reviews
FAQ3–6 common questions and answers
GuaranteeMoney-back or satisfaction guarantee text

Payment success A celebratory message with next steps and an AI-generated image.

Payment failed A friendly message prompting the user to try again. The checkout state is preserved.

How personalization works

Every email contains a unique checkout URL with the recipient’s customer_user_id and email address embedded as parameters:

https://your-funnel.com/?cid={{customer_user_id}}&email={{email}}

Adapty generates these URLs automatically when sending each email — no configuration in the web paywall builder is required. When the user clicks, the builder reads the parameters to identify them. When a purchase completes, Adapty matches the revenue to the specific email that drove the conversion. This data appears in Campaign analytics.

Troubleshooting

IssueSolution
Checkout link doesn’t openVerify the paywall is published in the web paywall builder
User not identified at checkoutConfirm Adapty.identify() was called with the correct user ID before the email was sent
Purchase not attributed to emailCheck that the cid parameter is present in the checkout URL — contact support if parameters are missing