diff --git a/.github/workflows/ci_e2e_tests_pos_web.yaml b/.github/workflows/ci_e2e_tests_pos_web.yaml
new file mode 100644
index 000000000..335127254
--- /dev/null
+++ b/.github/workflows/ci_e2e_tests_pos_web.yaml
@@ -0,0 +1,190 @@
+name: 🧪 POS - E2E Tests
+
+permissions:
+  contents: read
+
+on:
+  # Run on the PR. We don't build in CI — Vercel builds the POS preview (project
+  # "pos-demo", root dapps/pos-app) for the branch, reachable at the stable
+  # branch alias pos-demo-git-<branch>-reown-com.vercel.app. That deployment
+  # serves the app's /api/* serverless functions (the payment proxy in
+  # dapps/pos-app/api/), which a static build does not — so this covers ALL
+  # flows, including the payment ones.
+  pull_request:
+    # Include ready_for_review so the run fires when a draft PR is promoted to
+    # ready (the job `if:` below skips runs while it's still a draft).
+    types: [opened, synchronize, reopened, ready_for_review]
+    paths:
+      - 'dapps/pos-app/**'
+      - '.github/workflows/ci_e2e_tests_pos_web.yaml'
+  # Manual run against an explicit preview URL (e.g. a specific deployment, or a
+  # branch whose alias is truncated — see the length guard below).
+  workflow_dispatch:
+    inputs:
+      preview_url:
+        description: 'Preview URL (e.g. https://pos-demo-git-<branch>-reown-com.vercel.app)'
+        required: true
+        type: string
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  e2e:
+    name: Maestro POS App E2E Tests (Web · preview)
+    # Skip while the PR is a draft; runs once it's marked ready for review.
+    # workflow_dispatch is unaffected.
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Resolve POS preview URL
+        id: target
+        env:
+          EVENT: ${{ github.event_name }}
+          DISPATCH_URL: ${{ inputs.preview_url }}
+          HEAD_REF: ${{ github.head_ref }}
+        run: |
+          set -euo pipefail
+          if [ "$EVENT" = "workflow_dispatch" ]; then
+            base="${DISPATCH_URL%/}"
+          else
+            # Vercel's git branch alias: lowercase the branch, replace runs of
+            # non-alphanumerics with "-", trim. e.g. feature/e2e-maestro-tests ->
+            # pos-demo-git-feature-e2e-maestro-tests-reown-com.vercel.app
+            slug="$(printf '%s' "$HEAD_REF" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//')"
+            label="pos-demo-git-${slug}-reown-com"
+            # A DNS label maxes at 63 chars; past that Vercel truncates and adds a
+            # hash, so the name-based alias no longer matches. Fail loud and point
+            # at workflow_dispatch rather than test the wrong URL.
+            if [ "${#label}" -gt 63 ]; then
+              echo "Vercel alias label >63 chars ('$label'); branch-name construction won't match. Re-run via workflow_dispatch with the exact preview_url." >&2
+              exit 1
+            fi
+            base="https://${label}.vercel.app"
+          fi
+          echo "app_url=$base" >> "$GITHUB_OUTPUT"
+          echo "Testing against: $base"
+
+      - name: Checkout flows (matching the PR commit)
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+
+      - name: Install xvfb
+        run: sudo apt-get update && sudo apt-get install -y xvfb
+
+      - name: Wait for preview to be reachable
+        env:
+          APP_URL: ${{ steps.target.outputs.app_url }}
+        run: |
+          # The branch alias serves the latest ready deployment for the branch;
+          # give Vercel time to finish building this push.
+          for i in $(seq 1 60); do
+            curl -fsS -o /dev/null "$APP_URL" && { echo "Preview reachable"; exit 0; }
+            echo "  ...waiting for preview ($i/60)"; sleep 10
+          done
+          echo "Preview not reachable after ~10m: $APP_URL"; exit 1
+
+      - name: Install Maestro
+        run: |
+          curl -Ls "https://get.maestro.mobile.dev" | bash
+          echo "$HOME/.maestro/bin" >> $GITHUB_PATH
+
+      - name: Run Maestro E2E Tests (Web)
+        id: maestro
+        env:
+          APP_URL: ${{ steps.target.outputs.app_url }}
+        run: |
+          mkdir -p maestro-artifacts maestro-artifacts/reports
+          set +e
+          # Run each flow in its OWN maestro process. Maestro web treats the
+          # browser as a single "device" and reuses it (plus localStorage) across
+          # flows within one `maestro test <dir>` call, so a flow that mutates
+          # persisted state leaks into later flows. A process per flow gives each
+          # a fresh browser and full isolation. Each flow retries once to absorb
+          # transient cold-start flakes.
+          overall_exit=0
+          : > maestro-output.log
+          for flow in dapps/pos-app/e2e/*.yaml; do
+            name="$(basename "$flow" .yaml)"
+            flow_exit=0
+            for attempt in 1 2; do
+              echo "=== ${name}: attempt ${attempt}/2 (web) ===" | tee -a maestro-output.log
+              xvfb-run -a "$HOME/.maestro/bin/maestro" test \
+                --headless \
+                --env APP_URL="$APP_URL" \
+                --format junit \
+                --output "maestro-artifacts/reports/${name}.xml" \
+                --test-output-dir "maestro-artifacts/${name}" \
+                --debug-output "${RUNNER_TEMP}/maestro-debug/${name}" \
+                "$flow" >"${RUNNER_TEMP}/${name}-attempt-${attempt}.log" 2>&1
+              flow_exit=$?
+              cat "${RUNNER_TEMP}/${name}-attempt-${attempt}.log" >> maestro-output.log
+              [ "$flow_exit" -eq 0 ] && break
+              if [ "$flow_exit" -gt 128 ]; then
+                echo "${name} killed by signal (exit $flow_exit) — not retrying" | tee -a maestro-output.log
+                break
+              fi
+              echo "${name} attempt ${attempt} failed (exit $flow_exit)" | tee -a maestro-output.log
+            done
+            [ "$flow_exit" -ne 0 ] && overall_exit="$flow_exit"
+          done
+          find "${RUNNER_TEMP}/maestro-debug" -type f \( -name '*.png' -o -name '*.jpg' \) -exec cp {} maestro-artifacts/ \; 2>/dev/null || true
+          echo "=== Overall Maestro exit: ${overall_exit} ==="
+          exit "$overall_exit"
+
+      - name: Upload Test Results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: maestro-web-test-results
+          path: |
+            maestro-artifacts/reports/*.xml
+            maestro-output.log
+            maestro-artifacts/**/*.png
+            maestro-artifacts/**/*.jpg
+          if-no-files-found: warn
+          retention-days: 14
+
+      - name: Send Slack notification
+        if: failure()
+        uses: slackapi/slack-github-action@b0fa283ad8fea605de13dc3f449259339835fc52 # v2.1.0
+        with:
+          webhook: ${{ secrets.SLACK_WEBHOOK_URL }}
+          webhook-type: incoming-webhook
+          payload: |
+            {
+              "text": "POS App E2E Test Report (Web · preview)",
+              "blocks": [
+                {
+                  "type": "header",
+                  "text": { "type": "plain_text", "text": "🧪 POS App E2E Test Report (Web · preview)" }
+                },
+                {
+                  "type": "section",
+                  "fields": [
+                    { "type": "mrkdwn", "text": "*Branch:*\n`${{ github.head_ref || github.ref_name }}`" },
+                    { "type": "mrkdwn", "text": "*Trigger:*\n`${{ github.event_name }}`" }
+                  ]
+                },
+                {
+                  "type": "section",
+                  "fields": [
+                    { "type": "mrkdwn", "text": "*E2E Tests:*\n`${{ steps.maestro.outcome == 'success' && '✅ Passed' || '❌ Failed' }}`" },
+                    { "type": "mrkdwn", "text": "*Overall Status:*\n`${{ job.status == 'success' && '✅ Success' || '❌ Failed' }}`" }
+                  ]
+                },
+                {
+                  "type": "actions",
+                  "elements": [
+                    {
+                      "type": "button",
+                      "text": { "type": "plain_text", "text": "View Workflow Run" },
+                      "url": "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                    }
+                  ]
+                }
+              ]
+            }
diff --git a/.github/workflows/ci_e2e_walletkit.yaml b/.github/workflows/ci_e2e_walletkit.yaml
index 4da6d2ad7..8b1783199 100644
--- a/.github/workflows/ci_e2e_walletkit.yaml
+++ b/.github/workflows/ci_e2e_walletkit.yaml
@@ -1,4 +1,4 @@
-name: CI E2E WalletKit
+name: 🧪 WalletKit - E2E Tests
 # The "(skip-metrics)" suffix is consumed by the E2E KPI metrics job (WalletConnect/actions)
 # to exclude those runs from stats. Don't change/remove it.
 # The platform label mirrors which jobs actually run (see each job's `if:`):
diff --git a/.github/workflows/release-appkit.yaml b/.github/workflows/release-appkit.yaml
index d027ca8e5..4a1a58b19 100644
--- a/.github/workflows/release-appkit.yaml
+++ b/.github/workflows/release-appkit.yaml
@@ -1,4 +1,4 @@
-name: Release AppKit
+name: 🚀 Release AppKit
 run-name: "AppKit - ${{ inputs.platform == 'both' && '🍎 iOS & 🤖 Android' || inputs.platform == 'ios' && '🍎 iOS' || '🤖 Android' }} (${{ inputs.release-type }})"
 
 permissions:
diff --git a/.github/workflows/release-merchant-pos.yaml b/.github/workflows/release-merchant-pos.yaml
index 368f7b945..644a56dfc 100644
--- a/.github/workflows/release-merchant-pos.yaml
+++ b/.github/workflows/release-merchant-pos.yaml
@@ -1,4 +1,4 @@
-name: Release Merchant POS
+name: 🚀 Release Merchant POS
 
 permissions:
   contents: read
diff --git a/.github/workflows/release-pos-poc.yaml b/.github/workflows/release-pos-poc.yaml
index 82f339571..c7f1e2211 100644
--- a/.github/workflows/release-pos-poc.yaml
+++ b/.github/workflows/release-pos-poc.yaml
@@ -1,4 +1,4 @@
-name: Release Mobile POS (PoC)
+name: 🚀 Release Mobile POS (PoC)
 run-name: "Mobile POS (PoC) - ${{ inputs.platform == 'both' && '🍎 iOS & 🤖 Android' || inputs.platform == 'ios' && '🍎 iOS' || '🤖 Android' }}"
 
 permissions:
diff --git a/.github/workflows/release-pos.yaml b/.github/workflows/release-pos.yaml
index 7e29f133a..943ab2676 100644
--- a/.github/workflows/release-pos.yaml
+++ b/.github/workflows/release-pos.yaml
@@ -1,4 +1,4 @@
-name: Release Mobile POS
+name: 🚀 Release Mobile POS
 run-name: "Mobile POS - ${{ inputs.platform == 'both' && '🍎 iOS & 🤖 Android' || inputs.platform == 'ios' && '🍎 iOS' || '🤖 Android' }}"
 
 permissions:
diff --git a/.github/workflows/release-walletkit.yaml b/.github/workflows/release-walletkit.yaml
index 279ff45e7..634500b46 100644
--- a/.github/workflows/release-walletkit.yaml
+++ b/.github/workflows/release-walletkit.yaml
@@ -1,4 +1,4 @@
-name: Release WalletKit
+name: 🚀 Release WalletKit
 run-name: "WalletKit - ${{ inputs.platform == 'both' && '🍎 iOS & 🤖 Android' || inputs.platform == 'ios' && '🍎 iOS' || '🤖 Android' }} (${{ inputs.release-type }})"
 
 permissions:
diff --git a/dapps/pos-app/app.json b/dapps/pos-app/app.json
index 9389e33dc..4ea862f52 100644
--- a/dapps/pos-app/app.json
+++ b/dapps/pos-app/app.json
@@ -41,7 +41,7 @@
         "android.permission.BLUETOOTH_ADVERTISE",
         "android.permission.USB_PERMISSION"
       ],
-      "versionCode": 27
+      "versionCode": 28
     },
     "web": {
       "output": "static",
diff --git a/dapps/pos-app/app/amount.tsx b/dapps/pos-app/app/amount.tsx
index 602532600..89eae986c 100644
--- a/dapps/pos-app/app/amount.tsx
+++ b/dapps/pos-app/app/amount.tsx
@@ -70,6 +70,7 @@ export default function AmountScreen() {
         ]}
       >
         <BigAmountInput
+          testID="amount-display"
           value={watchAmount}
           currency={currency.symbol}
           symbolPosition={currency.symbolPosition}
@@ -121,6 +122,7 @@ export default function AmountScreen() {
         )}
       />
       <Button
+        testID="charge-button"
         onPress={handleSubmit(onSubmit)}
         disabled={!isValid}
         style={[
diff --git a/dapps/pos-app/app/index.tsx b/dapps/pos-app/app/index.tsx
index b2fb66465..8b5b544d6 100644
--- a/dapps/pos-app/app/index.tsx
+++ b/dapps/pos-app/app/index.tsx
@@ -43,6 +43,7 @@ export default function HomeScreen() {
   return (
     <View style={styles.container}>
       <Button
+        testID="start-payment-button"
         onPress={handleStartPayment}
         style={[
           styles.actionButton,
@@ -59,6 +60,7 @@ export default function HomeScreen() {
         <ThemedText fontSize={18}>Start payment</ThemedText>
       </Button>
       <Button
+        testID="activity-button"
         onPress={handleActivityPress}
         style={[
           styles.actionButton,
@@ -75,6 +77,7 @@ export default function HomeScreen() {
         <ThemedText fontSize={18}>Activity</ThemedText>
       </Button>
       <Button
+        testID="settings-button"
         onPress={handleSettingsPress}
         style={[
           styles.actionButton,
diff --git a/dapps/pos-app/app/scan.tsx b/dapps/pos-app/app/scan.tsx
index 7513e1c87..ee5a1bfe8 100644
--- a/dapps/pos-app/app/scan.tsx
+++ b/dapps/pos-app/app/scan.tsx
@@ -101,7 +101,10 @@ export default function ScanScreen() {
   );
 
   const handleOnClosePress = () => {
-    if (paymentId && paymentStatusData?.status === "requires_action") {
+    // Before the first status poll resolves, `paymentStatusData` is undefined
+    // but the payment is already open at the gateway — cancel it then too.
+    const status = paymentStatusData?.status;
+    if (paymentId && (status === undefined || status === "requires_action")) {
       cancelPayment(paymentId).catch((error) => {
         addLog("error", "Failed to cancel payment", "scan", "cancelPayment", {
           paymentId,
@@ -276,6 +279,7 @@ export default function ScanScreen() {
       )}
       {!isProcessing && (
         <Button
+          testID="cancel-button"
           onPress={handleOnClosePress}
           style={[
             styles.closeButton,
diff --git a/dapps/pos-app/app/settings.tsx b/dapps/pos-app/app/settings.tsx
index 362913546..f055b5e42 100644
--- a/dapps/pos-app/app/settings.tsx
+++ b/dapps/pos-app/app/settings.tsx
@@ -265,6 +265,7 @@ export default function SettingsScreen() {
         showsVerticalScrollIndicator={false}
       >
         <SettingsItem
+          testID="settings-theme"
           title="Theme"
           value={THEME_LABELS[themeMode]}
           onPress={() => setActiveSheet("theme")}
@@ -272,24 +273,28 @@ export default function SettingsScreen() {
         />
 
         <SettingsItem
+          testID="settings-wallet-theme"
           title="Wallet theme"
           value={currentVariant?.name ?? "None"}
           onPress={() => setActiveSheet("walletTheme")}
         />
 
         <SettingsItem
+          testID="settings-currency"
           title="Currency"
           value={`${currentCurrency.name} (${currentCurrency.symbol})`}
           onPress={() => setActiveSheet("currency")}
         />
 
         <SettingsItem
+          testID="settings-merchant-id"
           title="Merchant ID"
           value={merchantIdInput || undefined}
           onPress={() => setActiveSheet("merchantId")}
         />
 
         <SettingsItem
+          testID="settings-customer-api-key"
           title="Customer API key"
           value="**********"
           onPress={() => setActiveSheet("customerApiKey")}
@@ -336,9 +341,17 @@ export default function SettingsScreen() {
           </Card>
         )}
 
-        <SettingsItem title="Test printer" onPress={handleTestPrinterPress} />
+        <SettingsItem
+          testID="settings-test-printer"
+          title="Test printer"
+          onPress={handleTestPrinterPress}
+        />
 
-        <SettingsItem title="View logs" onPress={() => router.push("/logs")} />
+        <SettingsItem
+          testID="settings-view-logs"
+          title="View logs"
+          onPress={() => router.push("/logs")}
+        />
 
         <ThemedText
           fontSize={12}
@@ -413,6 +426,7 @@ export default function SettingsScreen() {
             ]}
           />
           <Button
+            testID="settings-merchant-save"
             onPress={handleMerchantIdSave}
             disabled={isMerchantIdConfirmDisabled}
             style={[
@@ -467,6 +481,7 @@ export default function SettingsScreen() {
             ]}
           />
           <Button
+            testID="settings-customer-save"
             onPress={handleCustomerApiKeySave}
             disabled={isCustomerApiKeyConfirmDisabled}
             style={[
diff --git a/dapps/pos-app/components/button.tsx b/dapps/pos-app/components/button.tsx
index 7b630676a..751204127 100644
--- a/dapps/pos-app/components/button.tsx
+++ b/dapps/pos-app/components/button.tsx
@@ -7,6 +7,7 @@ interface Props {
   style?: StyleProp<ViewStyle>;
   onPress: () => void;
   disabled?: boolean;
+  testID?: string;
 }
 
 export const Button: React.FC<Props> = ({
@@ -14,9 +15,15 @@ export const Button: React.FC<Props> = ({
   style,
   onPress,
   disabled,
+  testID,
 }) => {
   return (
-    <PressableScale style={style} onPress={onPress} enabled={!disabled}>
+    <PressableScale
+      style={style}
+      onPress={onPress}
+      enabled={!disabled}
+      testID={testID}
+    >
       {children}
     </PressableScale>
   );
diff --git a/dapps/pos-app/components/framed-modal.web.tsx b/dapps/pos-app/components/framed-modal.web.tsx
index af2fa3b0e..c9ac7ac16 100644
--- a/dapps/pos-app/components/framed-modal.web.tsx
+++ b/dapps/pos-app/components/framed-modal.web.tsx
@@ -176,10 +176,17 @@ export function FramedModal({
 
   if (!isRendered) return null;
 
+  // While the close animation plays the modal is still mounted; without this,
+  // its full-screen overlay swallows clicks meant for the screen underneath.
+  const pointerEvents = visible ? "auto" : "none";
+
   // If we have a container ref (desktop web), use portal into the frame
   if (frameContainer) {
     const modalContent = (
-      <Animated.View style={[styles.container, containerAnimatedStyle]}>
+      <Animated.View
+        pointerEvents={pointerEvents}
+        style={[styles.container, containerAnimatedStyle]}
+      >
         {children}
       </Animated.View>
     );
@@ -187,7 +194,10 @@ export function FramedModal({
   }
 
   const modalContent = (
-    <Animated.View style={[mobileWebContainer, containerAnimatedStyle]}>
+    <Animated.View
+      pointerEvents={pointerEvents}
+      style={[mobileWebContainer, containerAnimatedStyle]}
+    >
       {children}
     </Animated.View>
   );
diff --git a/dapps/pos-app/components/numeric-keyboard.tsx b/dapps/pos-app/components/numeric-keyboard.tsx
index fc442177c..d4962a8bc 100644
--- a/dapps/pos-app/components/numeric-keyboard.tsx
+++ b/dapps/pos-app/components/numeric-keyboard.tsx
@@ -55,7 +55,10 @@ function NumericKeyboardBase({ onKeyPress, style }: NumericKeyboardProps) {
                 />
               ) : (
                 <ThemedText
-                  testID={`key-${key}`}
+                  // The "." key gets a dedicated id ("key-decimal") instead of
+                  // "key-." because Maestro treats id selectors as regex, where
+                  // "." is a wildcard that would match any "key-X".
+                  testID={key === "." ? "key-decimal" : `key-${key}`}
                   style={[styles.keyText, { color: Theme["text-primary"] }]}
                 >
                   {key}
diff --git a/dapps/pos-app/components/radio-list.tsx b/dapps/pos-app/components/radio-list.tsx
index 5c81b113e..7ccc51747 100644
--- a/dapps/pos-app/components/radio-list.tsx
+++ b/dapps/pos-app/components/radio-list.tsx
@@ -32,6 +32,7 @@ export function RadioList<T extends string = string>({
         return (
           <Pressable
             key={option.value}
+            testID={`option-${option.value}`}
             onPress={() => onChange(option.value)}
             style={[
               styles.item,
diff --git a/dapps/pos-app/components/settings-item.tsx b/dapps/pos-app/components/settings-item.tsx
index e6ac9deba..86b59b2d7 100644
--- a/dapps/pos-app/components/settings-item.tsx
+++ b/dapps/pos-app/components/settings-item.tsx
@@ -12,6 +12,7 @@ interface SettingsItemProps {
   onPress: () => void;
   showCaret?: boolean;
   disabled?: boolean;
+  testID?: string;
 }
 
 export function SettingsItem({
@@ -20,6 +21,7 @@ export function SettingsItem({
   onPress,
   showCaret,
   disabled,
+  testID,
 }: SettingsItemProps) {
   const Theme = useTheme();
   const [assets] = useAssets([require("@/assets/images/caret-up-down.png")]);
@@ -29,6 +31,7 @@ export function SettingsItem({
     <Button
       onPress={onPress}
       disabled={disabled}
+      testID={testID}
       style={[
         styles.container,
         { backgroundColor: Theme["foreground-primary"] },
diff --git a/dapps/pos-app/e2e/README.md b/dapps/pos-app/e2e/README.md
new file mode 100644
index 000000000..893f27ae0
--- /dev/null
+++ b/dapps/pos-app/e2e/README.md
@@ -0,0 +1,111 @@
+# E2E Tests with Maestro (Web)
+
+This directory contains end-to-end tests using [Maestro](https://maestro.mobile.dev/).
+They run against the **web build** of the POS app (`react-native-web`) driven by
+Maestro's Chromium web driver — no Android/iOS build or emulator required.
+
+**CI** (`.github/workflows/ci_e2e_tests_pos_web.yaml`) triggers on the
+`deployment_status` event: when Vercel reports a successful `pos-demo`
+deployment for a commit, the workflow runs the flows against that deployment's
+URL (no build in CI; a manual `workflow_dispatch` against an explicit URL is
+also available). This matters because the payment flows need the app's `/api/*`
+serverless functions (the payment proxy in `dapps/pos-app/api/`), which only
+exist on a Vercel deployment — a static `serve -s dist` build does **not**
+serve them.
+
+- Non-payment flows (`invalid-amount`, `keypad`) work against any static server
+  (`serve -s dist`).
+- Payment flows (`payment-flow`, `payment-cancel`) require the `/api` proxy →
+  run against `vercel dev` or a Vercel preview URL.
+
+## Prerequisites
+
+1. Install Maestro CLI:
+   ```bash
+   curl -Ls "https://get.maestro.mobile.dev" | bash
+   ```
+   You also need Google Chrome / Chromium installed.
+
+2. Build and serve the web app (from `dapps/pos-app`):
+   ```bash
+   npm run web:build
+   # canvaskit.wasm is emitted at dist/ root, but the bundle requests it from the
+   # JS dir — place a copy there so a plain static server can find it:
+   mkdir -p dist/_expo/static/js/web
+   cp dist/canvaskit.wasm dist/_expo/static/js/web/canvaskit.wasm
+   npx serve -s dist -l 8081
+   ```
+   To run the **payment** flows locally you need the `/api` proxy too — use
+   `npx vercel dev --listen 8081` instead of `serve` (serves the static build
+   *and* the serverless functions; requires Vercel login + the pay-API env).
+
+3. Configure a merchant so payment flows can reach the amount/scan screens. The
+   amount-based flows need `EXPO_PUBLIC_DEFAULT_MERCHANT_ID` and
+   `EXPO_PUBLIC_DEFAULT_CUSTOMER_API_KEY` in `.env` **at build time** (they are
+   seeded into the settings store on first load; without them "Start payment"
+   redirects to Settings). `payment-flow.yaml` additionally needs *valid* creds +
+   network to mint a real gateway QR — in CI these are baked into the tested
+   deployment from the Vercel `pos-demo` project's environment variables at
+   build time (configured in the Vercel dashboard, not in this repo).
+
+## Running Tests
+
+The flow headers are parametrized as `url: ${APP_URL}`; pass the served URL via
+`--env`:
+
+```bash
+# All flows
+maestro test --env APP_URL=http://localhost:8081 e2e/
+
+# A single flow
+maestro test --env APP_URL=http://localhost:8081 e2e/keypad.yaml
+
+# Filter by tag (payment | amount)
+maestro test --include-tags amount --env APP_URL=http://localhost:8081 e2e/
+```
+
+Add `--headless` to run without a visible browser window (as CI does under xvfb).
+
+## Test Files
+
+| File | Tags | Description |
+|------|------|-------------|
+| `payment-flow.yaml` | `payment` | Start payment → enter $0.01 → charge → wait for QR → tap QR copies the payment link. Needs valid merchant creds + network. |
+| `payment-cancel.yaml` | `payment` | Same prelude as `payment-flow`, then cancel returns to a fresh amount screen (and cancels the payment at the gateway). |
+| `invalid-amount.yaml` | `amount` | Charge button stays "Enter amount"/disabled at empty/`0`; enables once a non-zero amount is entered. |
+| `keypad.yaml` | `amount` | Keypad decimal handling (single decimal, max 2 fractional digits) and backspace. |
+
+Shared steps live in `common/*.yaml` (the `$0.01`→QR prelude, run via `runFlow`).
+Flows there are **not** picked up as standalone tests — neither by CI's
+`e2e/*.yaml` glob nor by `maestro test e2e/`.
+
+## Adding New Tests
+
+1. Create a new `.yaml` file in this directory.
+2. Start with the web header:
+   ```yaml
+   url: ${APP_URL}
+   name: <description>
+   tags:
+     - <tag>
+   ---
+   - launchApp:
+       clearState: true
+   ```
+3. Prefer `testID`-based selectors (`id: "..."`) over visible text.
+
+### Web element-matching notes
+
+- `react-native-web` renders `testID` as `data-testid`; Maestro matches it via `id:`.
+- Maestro treats `id:`/`text:` selectors as **regex**. Avoid `.` / `$` / `(` `)` in
+  raw selectors — the decimal key therefore has the id `key-decimal` (not `key-.`),
+  and amount assertions escape the symbol, e.g. `text: "Charge \\$0.01"` and
+  `text: "Euro \\(€\\)"`.
+- Keypad ids: `key-0`…`key-9`, `key-decimal`, `key-erase`.
+- `startRecording`/`stopRecording` are not supported on web — don't use them.
+
+## Notes
+
+- Tests require a configured merchant (see Prerequisites).
+- Payment simulation (wallet connect + pay + success screen) is not yet
+  implemented (pending backend support).
diff --git a/dapps/pos-app/e2e/common/create-payment-qr.yaml b/dapps/pos-app/e2e/common/create-payment-qr.yaml
new file mode 100644
index 000000000..f4bee77f0
--- /dev/null
+++ b/dapps/pos-app/e2e/common/create-payment-qr.yaml
@@ -0,0 +1,37 @@
+# Subflow (not run standalone — lives under common/ so the CI *.yaml glob and
+# `maestro test e2e/` skip it): from the Home screen, start a $0.01 sale and
+# wait for the payment gateway QR. Needs a valid merchant
+# (EXPO_PUBLIC_DEFAULT_MERCHANT_ID + EXPO_PUBLIC_DEFAULT_CUSTOMER_API_KEY,
+# baked into the deployment from the Vercel pos-demo project env) and network
+# so the gateway returns a real payment QR. Without a merchant, "Start payment"
+# redirects to Settings instead of the amount screen.
+#
+# Maestro requires every flow file (incl. runFlow subflows) to open with a
+# config section; the url is inherited from the calling flow at runtime.
+url: ${APP_URL}
+---
+# Home -> start a new sale
+- tapOn:
+    id: "start-payment-button"
+
+# Enter $0.01 on the keypad
+- tapOn:
+    id: "key-0"
+- tapOn:
+    id: "key-decimal"
+- tapOn:
+    id: "key-0"
+- tapOn:
+    id: "key-1"
+
+# The charge button reflects the amount and is enabled
+- assertVisible:
+    text: "Charge \\$0.01"
+- tapOn:
+    id: "charge-button"
+
+# Wait for the payment gateway QR (backend round-trip)
+- extendedWaitUntil:
+    visible:
+      id: "pos-qr-code"
+    timeout: 20000
diff --git a/dapps/pos-app/e2e/invalid-amount.yaml b/dapps/pos-app/e2e/invalid-amount.yaml
new file mode 100644
index 000000000..e321d4a82
--- /dev/null
+++ b/dapps/pos-app/e2e/invalid-amount.yaml
@@ -0,0 +1,34 @@
+url: ${APP_URL}
+name: POS Amount — charge disabled until a non-zero amount is entered
+tags:
+  - amount
+---
+# Requires a configured merchant (see common/create-payment-qr.yaml) so
+# "Start payment" reaches the amount screen.
+- launchApp:
+    clearState: true
+
+- tapOn:
+    id: "start-payment-button"
+
+# Empty amount: the charge button shows the placeholder label
+- assertVisible:
+    text: "Enter amount"
+
+# Entering "0" is still invalid (amount required)
+- tapOn:
+    id: "key-0"
+- assertVisible:
+    text: "Enter amount"
+
+# Tapping the disabled charge button must NOT navigate away — keypad still shown
+- tapOn:
+    id: "charge-button"
+- assertVisible:
+    id: "key-1"
+
+# A non-zero amount enables the charge button (0 -> 5 replaces the leading zero)
+- tapOn:
+    id: "key-5"
+- assertVisible:
+    text: "Charge \\$5.00"
diff --git a/dapps/pos-app/e2e/keypad.yaml b/dapps/pos-app/e2e/keypad.yaml
new file mode 100644
index 000000000..4d5494ece
--- /dev/null
+++ b/dapps/pos-app/e2e/keypad.yaml
@@ -0,0 +1,44 @@
+url: ${APP_URL}
+name: POS Keypad — decimal handling and backspace
+tags:
+  - amount
+---
+# Requires a configured merchant (see common/create-payment-qr.yaml) so
+# "Start payment" reaches the amount screen.
+- launchApp:
+    clearState: true
+
+- tapOn:
+    id: "start-payment-button"
+
+# "12" -> $12.00
+- tapOn:
+    id: "key-1"
+- tapOn:
+    id: "key-2"
+- assertVisible:
+    text: "Charge \\$12.00"
+
+# "12.34" -> $12.34
+- tapOn:
+    id: "key-decimal"
+- tapOn:
+    id: "key-3"
+- tapOn:
+    id: "key-4"
+- assertVisible:
+    text: "Charge \\$12.34"
+
+# A second decimal point and a 3rd fractional digit are both ignored
+- tapOn:
+    id: "key-decimal"
+- tapOn:
+    id: "key-5"
+- assertVisible:
+    text: "Charge \\$12.34"
+
+# Backspace removes the last character: "12.3" -> $12.30
+- tapOn:
+    id: "key-erase"
+- assertVisible:
+    text: "Charge \\$12.30"
diff --git a/dapps/pos-app/e2e/payment-cancel.yaml b/dapps/pos-app/e2e/payment-cancel.yaml
new file mode 100644
index 000000000..4790ebef2
--- /dev/null
+++ b/dapps/pos-app/e2e/payment-cancel.yaml
@@ -0,0 +1,18 @@
+url: ${APP_URL}
+name: POS Payment — create a $0.01 payment, load the QR, then cancel
+tags:
+  - payment
+---
+- launchApp:
+    clearState: true
+
+# Start a $0.01 sale and wait for the gateway QR (see the subflow for the
+# merchant-credential requirements).
+- runFlow: common/create-payment-qr.yaml
+
+# Cancel returns to a fresh amount screen (empty amount -> "Enter amount")
+# and cancels the open payment at the gateway.
+- tapOn:
+    id: "cancel-button"
+- assertVisible:
+    text: "Enter amount"
diff --git a/dapps/pos-app/e2e/payment-flow.yaml b/dapps/pos-app/e2e/payment-flow.yaml
new file mode 100644
index 000000000..190566232
--- /dev/null
+++ b/dapps/pos-app/e2e/payment-flow.yaml
@@ -0,0 +1,21 @@
+url: ${APP_URL}
+name: POS Payment — create a sale and show the payment QR
+tags:
+  - payment
+---
+- launchApp:
+    clearState: true
+
+# Start a $0.01 sale and wait for the gateway QR (see the subflow for the
+# merchant-credential requirements).
+- runFlow: common/create-payment-qr.yaml
+
+# The scan screen shows the amount ("$0.01", uppercased)
+- assertVisible:
+    text: "\\$0.01"
+
+# Tapping the QR copies the payment link to the clipboard
+- tapOn:
+    id: "pos-qr-code"
+- assertVisible:
+    text: "Payment link copied"