Command

PePersonal JEJust Electrolyte RTRelease Timer TtTacTile CSClearSource AtAthletic

TacTile›Launch TacTile›Backend & Infrastructure›Billing & Payments·18 in this wave

Approve: Billing & PaymentsTo do · blocker Apply requireTier middleware to all Pro-only routesTo do Wire UI feature gates with the Gate componentTo do Add billing route testsDone Confirm pricing-page numbers match Stripe productsTo do Confirm STRIPE_WEBHOOK_SIGNING_SECRET set in prodDone Test Stripe test vs live key separationDone Decide: remove in-app checkout links, or get Apple's external-purchase entitlementTo do Implement the upgrade-path decision on iOS and AndroidTo do Build the Android subscription and billing surfaceTo do Pre-downgrade confirmation modalDone Billing tests: pin the survivors #694 lists under "Not covered", and the Stripe cancel in account deletionDone Show current subscription state in /settings/subscriptionDone Build invoice history pageTo do Wire dunning email on invoice.payment_failedDone Annual vs monthly pricing toggleTo do Tighten Stripe replay tolerance from 300s to 60sDone Dunning email says custom domains "may be paused" after several days, but billing suspends them on the first failed invoiceTo do

Wave

Billing & Payments

Depends on Auth and Backend API. Revenue path — the paywall blocker lives here.

TacTile › Launch TacTile › Backend & Infrastructure › Billing & Payments

8/18 done10 open1 open blocker

Selected taskclear

Dunning email says custom domains "may be paused" after several days, but billing suspends them on the first failed invoice

To doOwner · Vivt_c6f76355

packages/email/src/templates/payment-failed.ts:16 promises a grace period that apps/api/tactile-api/src/routes/billing.ts does not give. Found while verifying PR #694 (t_ffcae83e).

No dependencies in this wave — nothing gates it, and nothing waits on it.

Show the prompt

You are Viv, the agent for the TacTile lane of Command.

Open the lane and work there:

```bash
cd ~/Command/tactile && claude
```

Read that lane's CLAUDE.md and lane.json before you touch anything — they
carry your identity, your scope, and the hazards specific to this lane.
Read state from the hub (https://internal.tactile.to) or ask. Never guess at it.

## The task

**Dunning email says custom domains "may be paused" after several days, but billing suspends them on the first failed invoice** · to do

packages/email/src/templates/payment-failed.ts:16 promises a grace period that apps/api/tactile-api/src/routes/billing.ts does not give. Found while verifying PR #694 (t_ffcae83e).

Where it sits: TacTile › Launch TacTile › Backend &amp; Infrastructure › Billing & Payments

## The brief on file

[2026-10-15 · Viv] FILED from PR #694 (r28/billing-route-tests, draft), "Two things I found and did not endorse", item 2. Searched the live hub on 15 Oct for "dunning", "may be paused" and "payment-failed": only done tasks (t_b2ab9345, t_ea1c6f31) mention them.

MISMATCH. packages/email/src/templates/payment-failed.ts:16 tells the customer: "If the payment fails for several days, your custom domain may be paused". apps/api/tactile-api/src/routes/billing.ts onPaymentFailed suspends the account's custom domains as soon as the invoice's account resolves, on the FIRST invoice.payment_failed event, and the subscription path (billing.ts ~line 487) suspends on past_due and unpaid. The tests in #694 pin the code's behaviour (billing-webhook.test.ts, describe "invoice.payment_failed" case (a)); they do not endorse it.

TWO WAYS TO FIX, pick one:
(A) Recommended: change the email copy to match what happens ("your custom domain is paused until the payment goes through"). One template, one string, no behaviour change, no migration. Update the template test and the "(a)" assertion on the mail text if it quotes the sentence.
(B) Add a grace period before suspending (for example suspend only on subscription status unpaid, or N days after the first failure). That is a product and customer-visible change to billing: write the six-line block for Matthew, do not build it unasked.

DONE WHEN: the email copy and the suspension timing say the same thing, shown by the template test plus the invoice.payment_failed test in apps/api/tactile-api/tests/routes/billing-webhook.test.ts. Land it after #694 merges, or branch off r28/billing-route-tests. No deploy, no production mail.

## How to work this

- Do the work, don't just plan it. If the fix is obvious and safe, make it.
- Surface anything needing Matthew's sign-off instead of deciding it yourself.
- Short replies. Lead with the answer, then stop.
- Finish by saying what changed, what you verified, and what you'd do next.

To doIn progressDoneBlockedPick a wave on the left · tap a task to expand it

Lanes

Billing & Payments

Dunning email says custom domains "may be paused" after several days, but billing suspends them on the first failed invoice