@funnelsgrove/cli 0.1.222 → 0.1.223

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.222",
+      "repositoryCliVersion": "0.1.223",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.214",
+        "bundleVersion": "2.0.215",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "a0575e85660e8b1d5b51e1527740e02c267fb4b632aa10d9f17fa83324a8ccf7"
+            "sha256": "ce781cf22929d6e1ff1c74c04d12ad9c2be06e1b1171e62da09ec7b277d3867f"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "f7ed68bd91966f1fc77fab35315eff8f04987d4d2f841319722cd4f720e458ef"
+            "sha256": "2a8e04f9a0e36ea5248dbade1259f8328bbea8e67c7a7e7d33ef1ff9094809fb"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.221",
+      "repositoryCliVersion": "0.1.222",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.213",
+        "bundleVersion": "2.0.214",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "6d52d046a03cb15f2afa953368a3d866627fb4aafe86dbc5117af5771496e042"
+            "sha256": "a0575e85660e8b1d5b51e1527740e02c267fb4b632aa10d9f17fa83324a8ccf7"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "792aaaade69fd128bcfdfd8c518949f2b3eb37daf0fcbbdb7fd668d6dcb57ed3"
+            "sha256": "f7ed68bd91966f1fc77fab35315eff8f04987d4d2f841319722cd4f720e458ef"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.220",
+      "repositoryCliVersion": "0.1.221",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.212",
+        "bundleVersion": "2.0.213",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "2b4c4ec4a30095449ecf0671a26ee947389afab54fcda33e3061e9204bd6975c"
+            "sha256": "6d52d046a03cb15f2afa953368a3d866627fb4aafe86dbc5117af5771496e042"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "b70d42f119a2cecfd327e8e401411c17faa5f0287d7e061106530b6e44021bb0"
+            "sha256": "792aaaade69fd128bcfdfd8c518949f2b3eb37daf0fcbbdb7fd668d6dcb57ed3"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.219",
+      "repositoryCliVersion": "0.1.220",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.211",
+        "bundleVersion": "2.0.212",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bcbadffb5cafecb2fb5cf8e0efc1ce89e50ad7831cd74fb6e44366e5af304f1a"
+            "sha256": "2b4c4ec4a30095449ecf0671a26ee947389afab54fcda33e3061e9204bd6975c"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "a74eb797c82d67a1e2c74ee691cf0314b87082ec3000f20e17423e6f4ee60a90"
+            "sha256": "b70d42f119a2cecfd327e8e401411c17faa5f0287d7e061106530b6e44021bb0"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.218",
+      "repositoryCliVersion": "0.1.219",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.210",
+        "bundleVersion": "2.0.211",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "11c5cdb7ae1da4cae896c452caa410e8857e6a9982c7d9122ea6fdf4fc23d5ad"
+            "sha256": "bcbadffb5cafecb2fb5cf8e0efc1ce89e50ad7831cd74fb6e44366e5af304f1a"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "017e44038e149219fa6125df53982b86d26d3936f857c2b35565d11e95a6115d"
+            "sha256": "a74eb797c82d67a1e2c74ee691cf0314b87082ec3000f20e17423e6f4ee60a90"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.217",
+      "repositoryCliVersion": "0.1.218",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.209",
+        "bundleVersion": "2.0.210",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "02b64360dc55d9612312a7939e514218c05351341a2c982d02d3b651c664cd18"
+            "sha256": "11c5cdb7ae1da4cae896c452caa410e8857e6a9982c7d9122ea6fdf4fc23d5ad"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "99c2ea35a5ad3a71bcf6991d4c0674ee931920b775d72dc21bcabb80a515ae8e"
+            "sha256": "017e44038e149219fa6125df53982b86d26d3936f857c2b35565d11e95a6115d"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.216",
+      "repositoryCliVersion": "0.1.217",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.208",
+        "bundleVersion": "2.0.209",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -919,7 +919,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "80572cc42bc4163ba6d992a5de642dc88ca875ef4890570dc50a940dca56df6d"
+            "sha256": "67b8a8bbe575019cf8708c1e03f76c6661ce96ca1dc658cafe486256945f6826"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "d5ea6b1a344b082154ba26cc36a03894e3a69e462a41bdaed7ad9abb40b0a60a"
+            "sha256": "02b64360dc55d9612312a7939e514218c05351341a2c982d02d3b651c664cd18"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "0da7798f3b34a25c95b3efc85727647dbb4bdc818f22f4f395f0472175c67a20"
+            "sha256": "99c2ea35a5ad3a71bcf6991d4c0674ee931920b775d72dc21bcabb80a515ae8e"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.222",
+  "version": "0.1.223",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.214",
+  "bundleVersion": "2.0.215",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "a0575e85660e8b1d5b51e1527740e02c267fb4b632aa10d9f17fa83324a8ccf7"
+      "sha256": "ce781cf22929d6e1ff1c74c04d12ad9c2be06e1b1171e62da09ec7b277d3867f"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "f7ed68bd91966f1fc77fab35315eff8f04987d4d2f841319722cd4f720e458ef"
+      "sha256": "2a8e04f9a0e36ea5248dbade1259f8328bbea8e67c7a7e7d33ef1ff9094809fb"
     }
   ]
 }

package/template_docs/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/runtime` `0.14.0` first, then `@funnelsgrove/analytics` `0.1.100`, then `@funnelsgrove/payments` `0.15.3`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.222`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.14.0` first, then `@funnelsgrove/analytics` `0.1.100`, then `@funnelsgrove/payments` `0.15.3`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.223`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_docs/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.214",
+  "bundleVersion": "2.0.215",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.214",
+  "bundleVersion": "2.0.215",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "a0575e85660e8b1d5b51e1527740e02c267fb4b632aa10d9f17fa83324a8ccf7"
+      "sha256": "ce781cf22929d6e1ff1c74c04d12ad9c2be06e1b1171e62da09ec7b277d3867f"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "f7ed68bd91966f1fc77fab35315eff8f04987d4d2f841319722cd4f720e458ef"
+      "sha256": "2a8e04f9a0e36ea5248dbade1259f8328bbea8e67c7a7e7d33ef1ff9094809fb"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "f77bc83454f96af7db47c471bdcbc2de8595415da74f7437a4031a6845ecb1b6",
+  "sourceTreeHash": "fb01fa3ef0d1f67a7a7e70d2d7cc717c0f2366a4ed3f547f409657a2488e7310",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.214",
+  "docsBundleVersion": "2.0.215",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "44f5ec072a1245f479208b885a155d52516423f5921d27cf28d6adf1979fa3db",
+      "sha256": "0db2e36b42be59f683accb268c9801e13859454047611fb964979bc57a3fbc42",
       "mode": "100644"
     },
     {
@@ -101,7 +101,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "a0575e85660e8b1d5b51e1527740e02c267fb4b632aa10d9f17fa83324a8ccf7",
+      "sha256": "ce781cf22929d6e1ff1c74c04d12ad9c2be06e1b1171e62da09ec7b277d3867f",
       "mode": "100644"
     },
     {
@@ -236,7 +236,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "f7ed68bd91966f1fc77fab35315eff8f04987d4d2f841319722cd4f720e458ef",
+      "sha256": "2a8e04f9a0e36ea5248dbade1259f8328bbea8e67c7a7e7d33ef1ff9094809fb",
       "mode": "100644"
     },
     {
@@ -486,7 +486,7 @@
     },
     {
       "path": "src/steps/content/step-32-paywall.content.ts",
-      "sha256": "f13a4cd4216465aa2610607a833af5889c31aa9f7e4894f4af578dad481057ed",
+      "sha256": "509ae6f98854ff024e14a1c53e04f583c2f29fa4cc409f432eba7fe845e3d320",
       "mode": "100644"
     },
     {
@@ -506,7 +506,7 @@
     },
     {
       "path": "src/steps/editor/step-32-paywall.editor.ts",
-      "sha256": "4d40f9d4b11d02a0b6aad3c57ec874610535695b13e66b04364b900316cc2108",
+      "sha256": "9f6d5d126b456dc59ffe6f9f374b7e3325dd43f80edf8906b6715bb97eae3744",
       "mode": "100644"
     },
     {
@@ -551,7 +551,7 @@
     },
     {
       "path": "src/steps/step-32-paywall.tsx",
-      "sha256": "53dc726a59f037bfb78a9fbb7961d70daf067a7f53e5fea99ce4c252b138b8c4",
+      "sha256": "283a035dacfb9b4d56f269c1176ac84d8519a69b67eb11e0d392ada4535e2f62",
       "mode": "100644"
     },
     {

package/template_scaffold/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/runtime` `0.14.0` first, then `@funnelsgrove/analytics` `0.1.100`, then `@funnelsgrove/payments` `0.15.3`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.222`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.14.0` first, then `@funnelsgrove/analytics` `0.1.100`, then `@funnelsgrove/payments` `0.15.3`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.223`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_scaffold/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.214",
+  "bundleVersion": "2.0.215",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/src/steps/content/step-32-paywall.content.ts

@@ -41,6 +41,10 @@ type StepPaywallLocaleContent = {
     customerEmailLabel: string;
     customerEmailPlaceholder: string;
     customerEmailInvalidMessage: string;
+    emailPromptTitle: string;
+    emailPromptDescription: string;
+    emailPromptSubmitLabel: string;
+    emailPromptCancelLabel: string;
     countdownLabel: string;
     satisfactionPercent: string;
     satisfactionLabel: string;
@@ -135,6 +139,10 @@ export const stepPaywallContent = {
         customerEmailLabel: 'Email',
         customerEmailPlaceholder: 'Enter your email',
         customerEmailInvalidMessage: 'Enter a valid email address to continue.',
+        emailPromptTitle: 'Update your email',
+        emailPromptDescription: 'Stripe could not use this email. Enter a different address to continue with payment.',
+        emailPromptSubmitLabel: 'Continue',
+        emailPromptCancelLabel: 'Cancel',
         countdownLabel: 'Discount expires in',
         satisfactionPercent: '91%',
         satisfactionLabel: 'of users are satisfied with the plan and stay with us after its completion',

package/template_scaffold/src/steps/editor/step-32-paywall.editor.ts

@@ -179,6 +179,30 @@ export const stepPaywallEditor: readonly StepEditorSection[] = [
         kind: 'text',
         path: 'checkout.customerEmailInvalidMessage',
       },
+      {
+        id: 'checkout.emailPromptTitle',
+        label: 'Email prompt title',
+        kind: 'text',
+        path: 'checkout.emailPromptTitle',
+      },
+      {
+        id: 'checkout.emailPromptDescription',
+        label: 'Email prompt description',
+        kind: 'textarea',
+        path: 'checkout.emailPromptDescription',
+      },
+      {
+        id: 'checkout.emailPromptSubmitLabel',
+        label: 'Email prompt submit label',
+        kind: 'text',
+        path: 'checkout.emailPromptSubmitLabel',
+      },
+      {
+        id: 'checkout.emailPromptCancelLabel',
+        label: 'Email prompt cancel label',
+        kind: 'text',
+        path: 'checkout.emailPromptCancelLabel',
+      },
       {
         id: 'checkout.countdownLabel',
         label: 'Checkout countdown label',

package/template_scaffold/src/steps/step-32-paywall.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useEffect, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState, type FormEvent } from 'react';
 import Image from 'next/image';
 import { checkoutRuntimeConfig } from '@/runtime/checkout-runtime-config';
 import {
@@ -72,6 +72,7 @@ type StoryOption = {
 };
 
 const PAYWALL_WALLET_SURFACE_ID = 'paywall-primary';
+const STRIPE_INVALID_EMAIL_ERROR = 'Enter a valid email address to continue.';
 
 type PaywallWalletAvailabilityState = Partial<Record<string, boolean>>;
 
@@ -210,6 +211,10 @@ function StepPaywallRuntime({
   const [activeStoryIndex, setActiveStoryIndex] = useState(0);
   const [openFaqIds, setOpenFaqIds] = useState<string[]>([]);
   const [checkoutEmail, setCheckoutEmail] = useState(user.email);
+  const [checkoutEmailNeedsReview, setCheckoutEmailNeedsReview] = useState(false);
+  const [checkoutEmailPromptOpen, setCheckoutEmailPromptOpen] = useState(false);
+  const [checkoutEmailPromptDraft, setCheckoutEmailPromptDraft] = useState('');
+  const [checkoutEmailPromptError, setCheckoutEmailPromptError] = useState<string | null>(null);
   const [paywallWalletAvailability, setPaywallWalletAvailability] =
     useState<PaywallWalletAvailabilityState>({});
   const paywallStepRef = useRef<HTMLDivElement | null>(null);
@@ -366,13 +371,29 @@ function StepPaywallRuntime({
     () => typeof window === 'undefined' ? '' : window.location.href,
     [],
   );
+  const openCheckoutEmailPrompt = useCallback((showInvalidError: boolean) => {
+    setCheckoutEmailPromptDraft(checkoutEmail.trim() || user.email.trim());
+    setCheckoutEmailPromptError(
+      showInvalidError ? content.checkout.customerEmailInvalidMessage : null,
+    );
+    setCheckoutEmailPromptOpen(true);
+  }, [checkoutEmail, content.checkout.customerEmailInvalidMessage, user.email]);
+  const handleStripeCheckoutError = useCallback((message: string | null) => {
+    setError(message);
+    if (message !== STRIPE_INVALID_EMAIL_ERROR) {
+      return;
+    }
+
+    setCheckoutEmailNeedsReview(true);
+    openCheckoutEmailPrompt(true);
+  }, [openCheckoutEmailPrompt]);
   const checkoutSession = useStripeSubscriptionCheckoutSession({
     analyticsMetadata: checkoutAnalyticsMetadata,
     checkoutMode,
     couponId: checkoutPromoActive ? selectedDisplayPlan?.couponId ?? null : null,
     customerEmail: checkoutEmail || user.email,
     displayPlan: selectedDisplayPlan,
-    onError: setError,
+    onError: handleStripeCheckoutError,
     plan: checkoutProvider === 'stripe' ? selectedPlan : null,
     returnUrl: successReturnUrl,
     runtimeConfig: activeCheckoutRuntimeConfig,
@@ -491,6 +512,7 @@ function StepPaywallRuntime({
       !discountStateReady ||
       checkoutProvider !== 'stripe' ||
       checkoutDisabled ||
+      checkoutEmailNeedsReview ||
       checkoutCardClientSecret ||
       checkoutCardLoading
     ) {
@@ -500,6 +522,7 @@ function StepPaywallRuntime({
     void prepareCardCheckout({ checkoutStartSource: 'checkout_render' });
   }, [
     checkoutDisabled,
+    checkoutEmailNeedsReview,
     checkoutProvider,
     checkoutCardClientSecret,
     checkoutCardLoading,
@@ -577,6 +600,11 @@ function StepPaywallRuntime({
       return;
     }
 
+    if (checkoutProvider === 'stripe' && checkoutEmailNeedsReview) {
+      openCheckoutEmailPrompt(true);
+      return;
+    }
+
     if (checkoutProvider === 'solidgate') {
       setSolidgateAttemptKey(crypto.randomUUID());
       setCheckoutDialogOpen(true);
@@ -604,6 +632,11 @@ function StepPaywallRuntime({
   };
 
   const preparePaywallWalletCheckout = async (): Promise<string | null> => {
+    if (checkoutEmailNeedsReview) {
+      openCheckoutEmailPrompt(true);
+      return null;
+    }
+
     const normalizedEmail = checkoutEmail.trim() || user.email.trim();
     if (!normalizedEmail) {
       setCheckoutDialogOpen(true);
@@ -627,7 +660,13 @@ function StepPaywallRuntime({
 
   const commitCheckoutEmail = async (draftEmail: string): Promise<string> => {
     const normalizedEmail = draftEmail.trim();
-    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(normalizedEmail)) {
+    if (
+      !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(normalizedEmail)
+      || (
+        checkoutEmailNeedsReview
+        && normalizedEmail.toLowerCase() === checkoutEmail.trim().toLowerCase()
+      )
+    ) {
       throw new Error(content.checkout.customerEmailInvalidMessage);
     }
 
@@ -654,6 +693,30 @@ function StepPaywallRuntime({
     return syncedEmail;
   };
 
+  const submitCheckoutEmail = async (event: FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+
+    try {
+      await commitCheckoutEmail(checkoutEmailPromptDraft);
+      setCheckoutEmailNeedsReview(false);
+      setCheckoutEmailPromptOpen(false);
+      setCheckoutEmailPromptError(null);
+      checkoutSession.setError(null);
+      setError(null);
+    } catch (submitError) {
+      setCheckoutEmailPromptError(
+        submitError instanceof Error && submitError.message
+          ? submitError.message
+          : content.checkout.customerEmailInvalidMessage,
+      );
+    }
+  };
+
+  const cancelCheckoutEmailPrompt = () => {
+    setCheckoutEmailPromptOpen(false);
+    setCheckoutEmailPromptError(null);
+  };
+
   const closeCheckoutDialog = () => {
     setCheckoutDialogOpen(false);
     setSolidgateAttemptKey(null);
@@ -700,6 +763,42 @@ function StepPaywallRuntime({
 
   return (
     <>
+      {checkoutProvider === 'stripe' && checkoutEmailPromptOpen ? (
+        <div className='paywall-v2-email-prompt-backdrop' role='presentation'>
+          <form
+            className='paywall-v2-email-prompt'
+            role='dialog'
+            aria-modal='true'
+            aria-labelledby='paywall-v2-email-prompt-title'
+            onSubmit={(event) => void submitCheckoutEmail(event)}
+          >
+            <h2 id='paywall-v2-email-prompt-title'>{content.checkout.emailPromptTitle}</h2>
+            <p>{content.checkout.emailPromptDescription}</p>
+            <label>
+              <span>{content.checkout.customerEmailLabel}</span>
+              <input
+                type='email'
+                inputMode='email'
+                autoComplete='email'
+                value={checkoutEmailPromptDraft}
+                onChange={(event) => setCheckoutEmailPromptDraft(event.currentTarget.value)}
+                placeholder={content.checkout.customerEmailPlaceholder}
+                autoFocus
+              />
+            </label>
+            {checkoutEmailPromptError ? (
+              <p className='paywall-v2-email-prompt-error'>{checkoutEmailPromptError}</p>
+            ) : null}
+            <div className='paywall-v2-email-prompt-actions'>
+              <button type='button' onClick={cancelCheckoutEmailPrompt}>
+                {content.checkout.emailPromptCancelLabel}
+              </button>
+              <button type='submit'>{content.checkout.emailPromptSubmitLabel}</button>
+            </div>
+          </form>
+        </div>
+      ) : null}
+
       {checkoutProvider === 'solidgate' &&
       checkoutDialogOpen &&
       solidgateAttemptKey &&
@@ -1012,14 +1111,14 @@ function StepPaywallRuntime({
               onAvailabilityChange={(availability) =>
                 handleWalletSurfaceAvailabilityChange(PAYWALL_WALLET_SURFACE_ID, availability)
               }
-              onError={setError}
+              onError={handleStripeCheckoutError}
               onSuccess={handleCheckoutCompleted}
               onUnavailableClick={openCardCheckoutFromUnavailableWallet}
               resolveMethodClassName={resolvePaywallWalletMethodClassName}
               resolveMethodWrapperClassName={resolvePaywallWalletMethodWrapperClassName}
               summaryLabel={checkoutSummaryLabel}
               surfaceId={PAYWALL_WALLET_SURFACE_ID}
-              suspended={checkoutDialogReady || specialOfferDialogOpen}
+              suspended={checkoutDialogReady || checkoutEmailPromptOpen || specialOfferDialogOpen}
             />
           ) : null}
           <button
@@ -1900,6 +1999,96 @@ const stepPaywallStyles = `
   color: #d33;
 }
 
+.paywall-v2-email-prompt-backdrop {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 20px;
+  background: rgb(13 17 32 / 42%);
+}
+
+.paywall-v2-email-prompt {
+  box-sizing: border-box;
+  width: min(100%, 360px);
+  border-radius: 20px;
+  background: var(--color-surface, #fff);
+  padding: 22px;
+  box-shadow: 0 18px 48px rgb(19 27 47 / 26%);
+  color: var(--color-text, #111827);
+}
+
+.paywall-v2-email-prompt h2,
+.paywall-v2-email-prompt p {
+  margin: 0;
+}
+
+.paywall-v2-email-prompt h2 {
+  font-size: 22px;
+  font-weight: 800;
+  line-height: 1.15;
+}
+
+.paywall-v2-email-prompt > p {
+  margin-top: 10px;
+  color: var(--color-text, #4b5563);
+  font-size: 15px;
+  font-weight: 500;
+  line-height: 1.45;
+}
+
+.paywall-v2-email-prompt label {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  margin-top: 18px;
+  font-size: 13px;
+  font-weight: 700;
+}
+
+.paywall-v2-email-prompt input {
+  box-sizing: border-box;
+  min-height: 48px;
+  border: 1px solid var(--color-border, rgb(31 16 0 / 18%));
+  border-radius: 12px;
+  background: var(--color-surface, #fff);
+  padding: 0 14px;
+  color: var(--color-text, #111827);
+  font: inherit;
+}
+
+.paywall-v2-email-prompt-error {
+  margin-top: 10px !important;
+  color: var(--color-danger, #b42318);
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 1.35;
+}
+
+.paywall-v2-email-prompt-actions {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 10px;
+  margin-top: 18px;
+}
+
+.paywall-v2-email-prompt-actions button {
+  min-height: 44px;
+  border: 0;
+  border-radius: 12px;
+  background: var(--color-bg, #eef1f6);
+  color: var(--color-text, #111827);
+  font-weight: 700;
+  cursor: pointer;
+}
+
+.paywall-v2-email-prompt-actions button[type='submit'] {
+  background: var(--color-button);
+  color: var(--color-button-text);
+}
+
 @media (prefers-reduced-motion: reduce) {
   .paywall-v2-vibe-cta:not(:disabled),
   .paywall-v2-vibe-cta:not(:disabled)::after {