{"schemaVersion":"2.0.0","defaultLanguage":"en","languages":["en"],"launchScreenId":"article_screen_uMPaRbMH5Lj0yM1mag1y","screens":{"article_screen_uMPaRbMH5Lj0yM1mag1y":{"id":"article_screen_uMPaRbMH5Lj0yM1mag1y","name":"Payment methods on your paywall: embedded vs redirect, cards & wallets","tags":["article"],"screenType":"FlexibleLayout","position":{"x":0,"y":0},"content":{"canvas":{"background":{"kind":"solid","content":{"color":"#F7F8FA"}},"insets":{"top":0,"end":0,"bottom":0,"start":0},"webViewBackgroundColor":"#F7F8FA"},"animated":false,"offlineFirst":true,"flexibleLayout":{"scrollable":true,"insets":{"top":48,"end":32,"bottom":56,"start":32},"sections":[{"id":"intro","order":0,"kind":"Text","label":"Payment methods on your paywall: embedded vs redirect, cards & wallets","layout":{"heightKind":"auto"},"textContent":{"title":{"translations":{"en":"Payment methods on your paywall: embedded vs redirect, cards & wallets"},"kind":"static","appearance":{"align":"start","fontSize":30,"fontWeight":800,"lineHeight":36,"color":"#101828"}},"subtitle":{"translations":{"en":"Step 2 of launch: understand how each paywall type shows payment, and do the one required step (in Segmently's Stripe settings) that turns on Apple Pay and Google Pay."},"kind":"static","appearance":{"align":"start","fontSize":17,"fontWeight":400,"lineHeight":26,"color":"#475467"}}}},{"id":"paywall-payment-methods-where-this-fits","order":1,"kind":"Text","label":"Where this fits in your launch","layout":{"heightKind":"auto","margin":{"top":28}},"textContent":{"title":{"translations":{"en":"Where this fits in your launch"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"Getting to a funnel you can run ads against follows a fixed order: (1) connect Stripe, (2) create and attach a paywall product, (3) set up email passing, (4 - optional) wire ad-pixel events, then (5) publish and test. This is part of step 2. Before you read on, your Stripe account must already be connected (step 1) and you should have at least one paywall product created and attached to your paywall. The next required step after this one is email passing (step 3), so the right customer record and receipt follow each sale. This article does not ask you to pick a payment method anywhere in Segmently - it explains what each paywall already does and the single required setting, in Segmently's Stripe integration settings, that unlocks wallets."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-three-types","order":2,"kind":"Text","label":"The three paywall types and how payment appears","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"The three paywall types and how payment appears"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"Segmently offers three paywall types, and the payment surface differs by type. Native Paywall: products attach as subscription rows you pick in the editor, and payment is collected with an embedded Stripe Payment Element right inside the funnel. Flexible-layout paywall: you assemble the screen from sections, attaching products through a product-catalog section and/or a custom-embed section - and a custom-embed section is always rendered inside an iframe at runtime. (The flexible-layout editor shows an iframe toggle on a custom-embed section, but that toggle is not honored at runtime for flexible-layout custom embeds: they always run inside an iframe regardless. So for wallet-sensitive paywalls, use a web-embed paywall with iframe rendering off, not a flexible-layout custom-embed.) Web-embed paywall: you bring your own HTML and attach products to your own buy controls, and a single toggle - 'Render in iframe (full isolation)' - governs the surface. Turn that toggle ON and the HTML runs in a legacy, fully isolated iframe; turn it OFF and the HTML runs in a Shadow DOM that shares the host window - this is the recommended, wallet-safe embedded surface and the one that includes the modern paid subscription flow. In short - the payment surface is set by which paywall type you chose plus, for a web-embed paywall, this iframe toggle - not by a single global on/off switch."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-three-types-image","order":3,"kind":"Media","label":"A paywall screen open in the Segmently editor","layout":{"heightKind":"fixed","heightValue":360,"padding":{"top":8,"end":0,"bottom":8,"start":0},"cornerRadius":{"uniform":12}},"mediaContent":{"kind":"Image","content":{"image":{"translations":{"en":{"original":"https://api.segmently.ai/assets/projects/arswew63RwQr6V4Ekb1Z/cli-assets/images/20260630153319_open-paywall-editor-editor-context/origin.png","name":"A paywall screen open in the Segmently editor"}},"appearance":{}}},"appearance":{"scaleMode":"scaleAspectFit","cornerRadii":{"uniform":12}}}},{"id":"paywall-payment-methods-embedded-vs-redirect","order":4,"kind":"Text","label":"Embedded vs redirect","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"Embedded vs redirect"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"There are two ways a shopper can pay. Embedded means the Stripe Payment Element - card fields plus any available wallets - appears inside your funnel and the buyer never leaves your page. Redirect means the buyer is sent to a Stripe-hosted checkout page to pay, then returned to your funnel. A native paid subscription is collected through the embedded path. A web-embed paywall is also an embedded surface as long as you turn its 'Render in iframe (full isolation)' toggle off: that Shadow DOM mode includes the modern paid subscription flow and preserves the synchronous wallet gesture chain, so it is the recommended wallet-safe embedded surface. The surfaces that do not carry the embedded subscription path are the legacy iframe-on web-embed and the flexible-layout custom-embed section (always an iframe at runtime, even though the editor shows a toggle that is not honored there). What about redirect? Redirect is not a property of the paywall type at all - it is a per-paywall checkoutMode setting, and when it is set to 'redirect' the buyer is always sent to Stripe-hosted Checkout, a choice that is checked first regardless of paywall type. So the practical takeaway: the surface a buyer sees follows from three things - your paywall type, the web-embed iframe toggle, and the checkoutMode setting - not from one global toggle and not from paywall type alone."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-embedded-vs-redirect-image","order":5,"kind":"Media","label":"Products and subscription controls on a paywall screen","layout":{"heightKind":"fixed","heightValue":360,"padding":{"top":8,"end":0,"bottom":8,"start":0},"cornerRadius":{"uniform":12}},"mediaContent":{"kind":"Image","content":{"image":{"translations":{"en":{"original":"https://api.segmently.ai/assets/projects/arswew63RwQr6V4Ekb1Z/cli-assets/images/20260630153321_open-subscription-controls-subscription-controls/origin.png","name":"Products and subscription controls on a paywall screen"}},"appearance":{}}},"appearance":{"scaleMode":"scaleAspectFit","cornerRadii":{"uniform":12}}}},{"id":"paywall-payment-methods-cards-always-work","order":6,"kind":"Text","label":"Cards work out of the box (required: nothing)","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"Cards work out of the box"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"Card payments are available the moment your Stripe account is connected - this step is required, but you have already done it in step 1, so there is no extra setup. Every shopper can always pay by card on your paywall. Wallets and Link, covered next, are added on top of cards when they are available; cards remain the dependable baseline that works on every device."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-wallets-required-domain","order":7,"kind":"Text","label":"Apple Pay and Google Pay (required: register your domain in Segmently's Stripe settings)","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"Apple Pay and Google Pay"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"Apple Pay and Google Pay appear automatically when the shopper's device supports them - you do not toggle the methods themselves. There is one required, one-time step: register your domain as a payment method domain on your connected Stripe account - and that domain must be the connected custom domain your funnel runs on, not a generic published web address. Segmently gives you a control for this - open your Stripe integration settings and use the Apple Pay Domains section to add your connected custom domain (do it for the same mode, test or live, that you will run). Once it shows as active, wallets can appear; until then, shoppers fall back to card. This pairs naturally with connecting a custom domain (step 5), which is required to publish in the first place: as a regular (non-admin) customer you cannot publish your funnel until an active custom domain is connected, and that same https custom domain is what you register here for wallets. A local preview address does not qualify."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-wallets-required-domain-image","order":8,"kind":"Media","label":"Register your custom domain under Apple Pay Domains, per Stripe mode, to enable wallet checkout","layout":{"heightKind":"fixed","heightValue":360,"padding":{"top":8,"end":0,"bottom":8,"start":0},"cornerRadius":{"uniform":12}},"mediaContent":{"kind":"Image","content":{"image":{"translations":{"en":{"original":"https://api.segmently.ai/assets/projects/arswew63RwQr6V4Ekb1Z/cli-assets/images/20260630172512_apple-pay-domains-panel/origin.png","name":"Register your custom domain under Apple Pay Domains, per Stripe mode, to enable wallet checkout"}},"appearance":{}}},"appearance":{"scaleMode":"scaleAspectFit","cornerRadii":{"uniform":12}}}},{"id":"paywall-payment-methods-link","order":9,"kind":"Text","label":"Link (required: nothing)","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"Link"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"Link is Stripe's accelerated checkout that remembers a shopper's saved card and details across Stripe-powered sites. It is offered automatically in the embedded Payment Element when Stripe decides it is relevant - there is nothing for you to set up and nothing to enable in Segmently. Which methods show, and the order they appear in, is decided by Stripe based on the shopper and their device; it is not a setting you configure."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-email-required","order":10,"kind":"Text","label":"Email is a hard prerequisite for subscriptions","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"Email is a hard prerequisite for subscriptions"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"No matter which paywall type or payment method a shopper picks, a subscription will not start without the buyer's email. The runtime guards on this: if no customer email is available when a subscription purchase begins, the purchase is rejected before it ever reaches Stripe. That is why email passing (step 3) is not optional polish - it is a hard prerequisite for every paid subscription paywall. Set it up before you go live: collect the email on a screen before the paywall, store it in a variable, and select that variable as the email source for your web placement. See the collect-email-before-paywall article for the exact steps."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-ownership-split","order":11,"kind":"Text","label":"What you control in Segmently vs in Stripe","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"What you control in Segmently vs in Stripe"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"Keep the split clear so you set things up in the right place. In Segmently you choose the paywall type, attach your products, and register your published domain for Apple Pay and Google Pay (in your Stripe integration settings, the Apple Pay Domains section). There is no payment-method picker, because which methods show is not a Segmently setting. On the Stripe Dashboard you control which methods are eligible on your account - for example enabling extra regional methods you want to accept. So: paywall layout, product attachment, and wallet domain registration = Segmently; the menu of eligible payment methods = Stripe. If a method you expect is missing, check that your domain is registered (Segmently) and that the method is enabled on your Stripe account."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-wallet-safe-conclusion","order":12,"kind":"Text","label":"Bottom line: where wallet-safe custom paywalls live","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"Bottom line: where wallet-safe custom paywalls live"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"If you are building a custom paywall and want Apple Pay and Google Pay to work, the safe choice is clear: use a web-embed paywall with 'Render in iframe (full isolation)' turned off, so the HTML runs in Shadow DOM. That is the only custom surface that preserves the synchronous wallet gesture chain and carries the modern paid subscription flow. The two surfaces that break wallets are the iframe-on web-embed (legacy isolation) and the flexible-layout custom-embed section (always an iframe at runtime) - keep wallet-sensitive paywalls off both of them."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}},{"id":"paywall-payment-methods-next","order":13,"kind":"Text","label":"Next: set up email passing","layout":{"heightKind":"auto","margin":{"top":20}},"textContent":{"title":{"translations":{"en":"Next: set up email passing"},"kind":"static","appearance":{"align":"start","fontSize":21,"fontWeight":750,"lineHeight":28,"color":"#101828"}},"subtitle":{"translations":{"en":"With your paywall type understood, your products attached, and your wallet domain registered in your Stripe integration settings, you are ready for step 3: collecting and passing the buyer's email before the paywall so each sale ties to the right customer record and receipt. If you still need to review your products, open the paywall products article; to continue the launch, move on to collecting email before the paywall."},"kind":"static","appearance":{"align":"start","fontSize":16,"fontWeight":400,"lineHeight":25,"color":"#344054"}}}}]}}}},"metadata":{"kind":"article","projectId":"arswew63RwQr6V4Ekb1Z","articleId":"uMPaRbMH5Lj0yM1mag1y","alias":"paywall-payment-methods","articlePresentation":{"version":1,"profiles":{"standard":{"containerMaxWidth":1120,"contentInsets":{"top":48,"end":32,"bottom":56,"start":32},"sectionPaddingScale":1,"textScale":1},"laptop":{"containerMaxWidth":960,"contentInsets":{"top":44,"end":40,"bottom":52,"start":40},"sectionPaddingScale":0.96,"textScale":0.96},"tablet":{"containerMaxWidth":760,"contentInsets":{"top":36,"end":28,"bottom":44,"start":28},"sectionPaddingScale":0.9,"textScale":0.92,"titleTextScale":0.9},"phone":{"containerMaxWidth":"100%","contentInsets":{"top":28,"end":16,"bottom":36,"start":16},"sectionPaddingScale":0.82,"textScale":0.88,"titleTextScale":0.82}}}},"webViewDefaultBackgroundColor":"#F7F8FA","projectAnalytics":{"consentManagement":{"enabled":true,"bannerText":"We use cookies to improve your experience and analyze site usage.","privacyPolicyUrl":"","defaultConsent":"denied"},"integrations":[{"platform":"segmently_internal","name":"Segmently Analytics","enabled":true,"config":{"mode":"http"},"createdAt":"2026-05-26T13:53:00.398Z","updatedAt":"2026-05-26T13:53:00.398Z","id":"int_mpmp3jsm_aij2kz"}]}}