@aglyn/shared-util-email 1.0.0-beta.219 → 1.0.0-beta.220

package/src/lib/risk-notice-catalog.js

@@ -262,6 +262,7 @@ export const RISK_STAFF_ACTIONS = {
  * as a hole in a sentence.
  */ export const RISK_NOTICE_TOKENS = {
     'workspace.name': 'The workspace name, or "your workspace".',
+    'site.label': 'The site the notice is about, as `the site "Harbor View"`, or "your site".',
     'item.label': 'What the notice is about, in the owner\'s words: the campaign "Spring sale", the page /pricing, order 1042.',
     'item.url': 'The absolute console link to the item.',
     occurredAt: 'When it happened, in UTC.',
@@ -272,9 +273,32 @@ export const RISK_STAFF_ACTIONS = {
     'lock.message': 'The message staff wrote when they applied the lock.',
     'lock.affected': 'What the lock or pause covers: sites, sessions, billing.',
     amount: 'The payment amount, when there is one.',
+    'payment.event': 'What happened to a payment, finishing "the payment was …": flagged for a fraud check, disputed by the cardholder with their bank.',
+    'page.visitors': 'What visitors see while a held page waits, as one sentence.',
     'evidence.dueBy': 'The date dispute evidence is due, when Stripe gave one.',
+    'payout.delay': 'A new publisher\'s payout schedule, finishing "moved to an extended schedule:": each payout reaches your bank 14 days after the sale, until your workspace is 30 days old.',
     'staff.evidence': 'Staff only: what the screen or Stripe reported.'
 };
+/**
+ * `{{payment.event}}` for each card signal a payment can draw, in the owner's
+ * words. The early warning and the review are told apart, because only one
+ * of them has held the money; a dispute is the bank's, and says so.
+ */ export const RISK_PAYMENT_EVENTS = {
+    'early-fraud-warning': 'reported by the card issuer as possibly not made by the cardholder',
+    'radar-review': 'held for a fraud review',
+    dispute: 'disputed by the cardholder with their bank'
+};
+/** `14 days`, `1 day`. */ function dayCount(days) {
+    return `${days} ${days === 1 ? 'day' : 'days'}`;
+}
+/**
+ * `{{payout.delay}}`: how long a new publisher's payouts wait, and until
+ * when. The numbers are the marketplace's own payout terms, passed in by the
+ * caller, and the notice states them: the schedule is money the publisher is
+ * owed and when it lands, not how anything was detected.
+ */ export function riskPayoutDelayText(payout) {
+    return `each payout reaches your bank ${dayCount(payout.delayDays)} after the sale, ` + `until your workspace is ${dayCount(payout.untilWorkspaceAgeDays)} old`;
+}
 const ASK_FOR_REVIEW = 'If you think this is a mistake, choose Request a review and tell us about it. A person reads every request.';
 const REVIEW_TIME = 'Reviews are usually answered within one business day. You will get a notice either way.';
 const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {{support.email}} with the reference {{reference}}.';
@@ -304,7 +328,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         owner: {
             title: 'An email is on hold for review',
             summary: 'Our automated safety review held {{item.label}} from {{workspace.name}} on {{occurredAt}} before it was sent.',
-            meaning: 'This email was not sent. Nobody on your list received it, and nothing else on your account has changed.',
+            meaning: 'This email was not delivered to anyone. Other emails with the same links or wording are stopped too while it is under review. Nothing else on your account has changed.',
             steps: [
                 'Open the email and check its links, its sender name and its wording.',
                 'If you change it, it is checked again when it next sends.',
@@ -342,7 +366,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         owner: {
             title: 'Your held email was released',
             summary: 'Our review team released {{item.label}} on {{occurredAt}}.',
-            meaning: 'A held campaign goes back on the schedule and sends shortly. An automated email sends the next time it runs.',
+            meaning: 'A held campaign that is still waiting goes back on the schedule and sends shortly; one you edited or canceled meanwhile stays as you left it. An automated email sends the next time it runs. A single email that was stopped, such as a receipt or a form reply, is not sent again, and the next one like it sends normally.',
             steps: [
                 'Nothing to do. If you edit the email before it sends, the edited version is checked on its own.'
             ],
@@ -370,8 +394,8 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'email-held',
         owner: {
             title: 'A held email will not be sent',
-            summary: 'After review, {{item.label}} was not approved on {{occurredAt}}.',
-            meaning: 'This email will not be sent in its current form. A held campaign is canceled; an automated email step stays stopped.',
+            summary: 'After review, {{item.label}} from {{workspace.name}} was not approved on {{occurredAt}}.',
+            meaning: 'This email will not be sent in its current form, and other emails with the same links or wording are stopped too until they are changed. A held campaign that was still waiting is canceled; an automated email step stays stopped.',
             steps: [
                 'Read our acceptable use rules before you send similar mail again.',
                 'If you think the decision is wrong, choose Request a review and explain what the email is for.'
@@ -407,8 +431,8 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'page-held',
         owner: {
             title: 'A published page is on hold for review',
-            summary: 'Our automated safety review held the latest version of {{item.label}} on {{occurredAt}}.',
-            meaning: 'Visitors still see the previous version of this page. If it has never been published before, visitors see a not-found page until the review is done.',
+            summary: 'On {{occurredAt}}, our automated safety review held the latest version of {{item.label}} on {{site.label}}.',
+            meaning: '{{page.visitors}} Nothing else on the site has changed.',
             steps: [
                 'Open the page and check its links, embeds and any fields that ask visitors for information.',
                 'If you change and publish it again, the new version is checked on its own.',
@@ -446,7 +470,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'page-held',
         owner: {
             title: 'Your held page is live',
-            summary: 'Our review team released {{item.label}} on {{occurredAt}}.',
+            summary: 'On {{occurredAt}}, our review team released {{item.label}} on {{site.label}}.',
             meaning: 'Visitors now see the version that was held.',
             steps: [
                 'Nothing to do. Open the page to confirm it looks right.'
@@ -479,7 +503,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'page-flagged',
         owner: {
             title: 'A live page is being reviewed',
-            summary: 'Our automated safety review flagged {{item.label}} on {{occurredAt}}. The page is still live.',
+            summary: 'On {{occurredAt}}, our automated safety review flagged {{item.label}} on {{site.label}}. The page is still live.',
             meaning: 'Visitors still see the page while a person looks. If you did not publish what is on it, someone else may have access to your account.',
             steps: [
                 'Open the page and check its links, embeds and any fields that ask visitors for information.',
@@ -517,7 +541,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'page-held',
         owner: {
             title: 'A held page will not be published',
-            summary: 'After review, the held version of {{item.label}} was not approved on {{occurredAt}}.',
+            summary: 'On {{occurredAt}}, after review, our team did not approve the held version of {{item.label}} on {{site.label}}.',
             meaning: 'Visitors keep seeing the previous version, or a not-found page if there is none. Publishing the same content again is held again.',
             steps: [
                 'Change the page and publish a new version, or restore an earlier version from its history.',
@@ -590,9 +614,9 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         includeSiteManagers: false,
         helpAnchor: 'listing-held',
         owner: {
-            title: 'Your marketplace submission was released',
-            summary: 'Our review team released {{item.label}} on {{occurredAt}}.',
-            meaning: 'It was not published automatically.',
+            title: 'Your marketplace submission was cleared',
+            summary: 'On {{occurredAt}}, our review team cleared {{item.label}} from {{workspace.name}}. It is not listed yet: submit it again and it will go through.',
+            meaning: 'It was not published automatically, so buyers cannot see it until you submit it again.',
             steps: [
                 'Submit it again; it will go through this time.'
             ],
@@ -656,8 +680,8 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'domain-flagged',
         owner: {
             title: 'A domain you added is being reviewed',
-            summary: '{{item.label}} was added to {{workspace.name}} on {{occurredAt}} and is waiting on a routine review.',
-            meaning: 'The domain stays connected while we look. Email sent from it may wait for the review to finish.',
+            summary: 'On {{occurredAt}}, {{item.label}} was added to {{workspace.name}}, and it is waiting on a routine review by our team.',
+            meaning: 'The domain stays connected while we look, and nothing is charged. If you send email from it, that email is stopped and held for its own review, whatever this review decides.',
             steps: [
                 'Nothing is needed if the domain and the name on it are yours.',
                 'To speed it up, choose Request a review and tell us who owns the domain and what it is for.',
@@ -692,8 +716,8 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'domain-flagged',
         owner: {
             title: 'Your domain review is complete',
-            summary: '{{item.label}} was reviewed and cleared on {{occurredAt}}.',
-            meaning: 'The domain works as normal. Email that was waiting on it sends on its next attempt.',
+            summary: 'On {{occurredAt}}, our team reviewed {{item.label}} on {{workspace.name}} and cleared it.',
+            meaning: 'The domain stays connected. If you send email from it, clearing the domain does not release that email: an email that was stopped is not sent again, and new email from it still goes through its own review.',
             steps: [
                 'Nothing to do.'
             ],
@@ -721,8 +745,8 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'domain-flagged',
         owner: {
             title: 'A domain on your workspace was not approved',
-            summary: 'After review, {{item.label}} was not approved on {{occurredAt}}.',
-            meaning: 'Email from this domain will not be sent, and pages served on it may be restricted.',
+            summary: 'On {{occurredAt}}, after review, our team did not approve {{item.label}} on {{workspace.name}}.',
+            meaning: 'This decision by itself does not disconnect the domain or change your sites. If you send email from it, that email keeps being stopped.',
             steps: [
                 'Remove the domain from your workspace, or show us that it is yours.',
                 'If you think the decision is wrong, choose Request a review with proof of ownership.'
@@ -758,7 +782,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'billing-payment-flagged',
         owner: {
             title: 'A payment on your subscription needs attention',
-            summary: 'On {{occurredAt}}, a subscription payment of {{amount}} for {{workspace.name}} was flagged for a fraud check.',
+            summary: 'On {{occurredAt}}, a subscription payment of {{amount}} for {{workspace.name}} was {{payment.event}}.',
             meaning: 'The payment may be reversed by the cardholder\'s bank. If it is, your subscription may need a new payment method, and your plan can change.',
             steps: [
                 'If you made this payment, choose Request a review and confirm it, so we can answer the bank.',
@@ -799,12 +823,12 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         includeSiteManagers: true,
         helpAnchor: 'link-blocked',
         owner: {
-            title: 'A link on your store was blocked',
-            summary: 'On {{occurredAt}}, we stopped sending anyone to {{item.label}}, because the address looks like another company\'s website.',
-            meaning: 'Nobody who follows that link is sent there. Everything else on your store works as normal.',
+            title: 'A link on {{site.label}} was blocked',
+            summary: 'On {{occurredAt}}, we blocked {{item.label}} on {{site.label}}, because the address looks like another company\'s website.',
+            meaning: 'Nobody who follows that link is sent there. Everything else on the site works as normal, and nothing is charged.',
             steps: [
-                'Replace it with a file from your media library or a link on your own domain.',
-                'If the address really is yours, choose Request a review and tell us about it.'
+                'Replace it with a file from your media library or a link on your own domain. The link stays blocked whatever a review decides, so replacing it is the way to make it work again.',
+                'If the address really is yours, you can still tell us with Request a review.'
             ],
             actions: [
                 'view-details',
@@ -829,7 +853,9 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         severity: 'urgent',
         emailOwners: true,
         alertStaff: true,
-        neverDigest: false,
+        // Which site, and that its orders need checking before they ship, is the
+        // point of the notice; a digest would drop both.
+        neverDigest: true,
         reviewable: true,
         closesWith: {
             released: 'review-cleared',
@@ -838,8 +864,8 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         includeSiteManagers: true,
         helpAnchor: 'card-testing',
         owner: {
-            title: 'Unusual checkout activity on your site',
-            summary: 'On {{occurredAt}}, the checkout on {{item.label}} saw an unusual burst of payment attempts, which can be someone testing stolen cards.',
+            title: 'Unusual checkout activity on {{site.label}}',
+            summary: 'On {{occurredAt}}, checkout on {{site.label}} saw an unusual burst of payment attempts, which can be someone testing stolen cards.',
             meaning: 'Checkout is still open. Repeated attempts from one source are being slowed. Payments from stolen cards may be reversed by the cardholder\'s bank later.',
             steps: [
                 'Review your recent orders before you fulfill them.',
@@ -854,7 +880,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         },
         staff: {
             title: 'Card-testing velocity on a site',
-            summary: '{{item.label}} of {{workspace.name}}. {{staff.evidence}} Nothing has been refused site-wide or refunded. Reference {{reference}}.',
+            summary: 'Unusual burst of card payments: {{item.label}}, workspace {{workspace.name}}. {{staff.evidence}} Nothing has been refused site-wide or refunded. Reference {{reference}}.',
             actions: [
                 'staff-open-row',
                 'staff-lock-site',
@@ -876,7 +902,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'gift-card-hold',
         owner: {
             title: 'Gift cards from an order are on hold',
-            summary: 'On {{occurredAt}}, the gift cards bought with {{item.label}} were put on hold because the payment for it is in question.',
+            summary: 'On {{occurredAt}}, we put on hold the gift cards bought with {{item.label}} on {{site.label}}, because the payment for that order is in question.',
             meaning: 'They cannot be redeemed for now. Their balance is kept. If the payment is refunded or the dispute is lost, the balance is voided for you.',
             steps: [
                 'Check the order and the buyer.',
@@ -891,7 +917,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         },
         staff: {
             title: 'Gift cards frozen on a questioned payment',
-            summary: '{{item.label}} on {{workspace.name}}. {{staff.evidence}}',
+            summary: 'Gift cards bought with {{item.label}} on {{workspace.name}} were frozen. {{staff.evidence}}',
             actions: [
                 'staff-view-workspace',
                 'staff-lock-site'
@@ -909,11 +935,11 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'sale-fraud-warning',
         owner: {
             title: 'A payment you received may be fraudulent',
-            summary: 'On {{occurredAt}}, the card issuer reported the payment for {{item.label}} ({{amount}}) as possibly not made by the cardholder.',
+            summary: 'On {{occurredAt}}, the card issuer reported the payment for {{item.label}} on {{site.label}} ({{amount}}) as possibly not made by the cardholder.',
             meaning: 'This payment may be reversed by the cardholder\'s bank. It is not a chargeback yet. Nothing has been refunded or canceled.',
             steps: [
                 'Hold anything not yet shipped or delivered until you are sure the buyer is genuine.',
-                'Refunding now usually prevents a chargeback and its fee.',
+                'Refunding now usually prevents a chargeback. If a chargeback is decided for the cardholder, the payment is taken back from you.',
                 'If you know the buyer and the sale is genuine, you can keep the order.'
             ],
             actions: [
@@ -944,7 +970,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'sale-payment-review',
         owner: {
             title: 'A payment you received is on hold for review',
-            summary: 'On {{occurredAt}}, the payment for {{item.label}} ({{amount}}) was held for a fraud review.',
+            summary: 'On {{occurredAt}}, the payment for {{item.label}} on {{site.label}} ({{amount}}) was held for a fraud review.',
             meaning: 'The payment has not reached your balance yet and may be refunded if it is not approved. Nothing has been refunded or canceled.',
             steps: [
                 'Hold anything not yet shipped or delivered until the payment clears.',
@@ -972,13 +998,14 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         severity: 'urgent',
         emailOwners: true,
         alertStaff: false,
-        neverDigest: false,
+        // Its evidence deadline is the point of the notice; a digest would drop it.
+        neverDigest: true,
         reviewable: false,
         includeSiteManagers: true,
         helpAnchor: 'sale-dispute',
         owner: {
             title: 'A customer disputed a payment',
-            summary: 'On {{occurredAt}}, the cardholder disputed the payment for {{item.label}} ({{amount}}) with their bank.',
+            summary: 'On {{occurredAt}}, the cardholder disputed the payment for {{item.label}} on {{site.label}} ({{amount}}) with their bank.',
             meaning: 'The payment may be reversed by the cardholder\'s bank. An unanswered dispute is decided for the cardholder. Your evidence is due by {{evidence.dueBy}}.',
             steps: [
                 'Open the order and gather what shows the sale was genuine: receipts, delivery tracking, messages with the buyer.',
@@ -1056,7 +1083,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'marketplace-sale-review',
         owner: {
             title: 'A marketplace sale is under review',
-            summary: 'On {{occurredAt}}, our team opened a routine review of {{item.label}} ({{amount}}).',
+            summary: 'On {{occurredAt}}, our team opened a routine review of {{item.label}} ({{amount}}) for {{workspace.name}}.',
             meaning: 'The sale is recorded as usual, and its payout may take longer than normal. Nothing has been refunded.',
             steps: [
                 'Nothing is needed from you.',
@@ -1093,7 +1120,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'marketplace-sale-review',
         owner: {
             title: 'A marketplace sale may be reversed',
-            summary: 'On {{occurredAt}}, the payment for {{item.label}} was reported as possibly not made by the cardholder, or held for a fraud check.',
+            summary: 'On {{occurredAt}}, the payment for {{item.label}} ({{amount}}) to {{workspace.name}} was {{payment.event}}.',
             meaning: 'This payment may be reversed by the cardholder\'s bank. If it is, your share of it is taken back from your payouts. Nothing has been refunded yet.',
             steps: [
                 'Nothing is needed from you: the marketplace handles the payment with the buyer\'s bank.',
@@ -1124,8 +1151,8 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'marketplace-payouts',
         owner: {
             title: 'Your marketplace payouts are on an extended schedule',
-            summary: 'On {{occurredAt}}, payouts for {{workspace.name}}\'s marketplace sales moved to an extended schedule.',
-            meaning: 'Payouts to new publishers wait for a period before they reach your bank. Your sales are recorded as usual and pay out automatically when the period ends.',
+            summary: 'On {{occurredAt}}, payouts for {{workspace.name}}\'s marketplace sales moved to an extended schedule: {{payout.delay}}.',
+            meaning: 'Nothing is withheld or charged. Your sales are recorded as usual, and each one pays out automatically when its wait ends.',
             steps: [
                 'Nothing to do. You will get a notice when payouts return to the standard schedule.'
             ],
@@ -1181,7 +1208,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'requesting-a-review',
         owner: {
             title: 'Our review is complete',
-            summary: 'On {{occurredAt}}, our team finished reviewing {{item.label}} and closed it with no action.',
+            summary: 'On {{occurredAt}}, our team finished reviewing {{item.label}} on {{workspace.name}} and closed it with no action.',
             meaning: 'Nothing on your account changes because of it.',
             steps: [
                 'Nothing to do.'
@@ -1210,10 +1237,10 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         helpAnchor: 'requesting-a-review',
         owner: {
             title: 'Our review found a problem',
-            summary: 'On {{occurredAt}}, our team finished reviewing {{item.label}} and took action on it.',
-            meaning: 'You may receive a separate notice about what changed on your account, such as a lock or a canceled subscription.',
+            summary: 'On {{occurredAt}}, our team finished reviewing {{item.label}} on {{workspace.name}} and did not clear it.',
+            meaning: 'This decision by itself does not lock anything, take anything down or change your billing. If we take any further step, you will get a separate notice saying exactly what changed.',
             steps: [
-                'Read any other notices you received today; they say what changed.',
+                'If another notice arrives, it says what changed. If none does, nothing else has changed.',
                 'If you think the decision is wrong, choose Request a review or contact support with the reference {{reference}}.'
             ],
             actions: [
@@ -1245,7 +1272,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
             summary: 'On {{occurredAt}}, our team locked {{workspace.name}}. The message from our team: {{lock.message}}',
             meaning: 'While it is locked: {{lock.affected}}',
             steps: [
-                'Read the message above; it says what we need from you.',
+                'Nothing is needed from you unless the message above asks for something, or you believe this is a mistake.',
                 CANNOT_SIGN_IN,
                 'Tell us who you are, what the workspace is for, and anything that explains what happened. A person reads every appeal.'
             ],
@@ -1307,7 +1334,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
             summary: 'On {{occurredAt}}, our team locked {{item.label}}. The message from our team: {{lock.message}}',
             meaning: 'While it is locked: {{lock.affected}}',
             steps: [
-                'Read the message above; it says what we need from you.',
+                'Nothing is needed from you unless the message above asks for something, or you believe this is a mistake.',
                 'Contact support to appeal, with the reference {{reference}}. A person reads every appeal.',
                 CANNOT_SIGN_IN
             ],
@@ -1368,7 +1395,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
             summary: 'On {{occurredAt}}, our team locked {{item.label}}. The message from our team: {{lock.message}}',
             meaning: 'While it is locked: {{lock.affected}}',
             steps: [
-                'Read the message above; it says what we need from you.',
+                'Nothing is needed from you unless the message above asks for something, or you believe this is a mistake.',
                 'Contact support to appeal, with the reference {{reference}}.'
             ],
             actions: [
@@ -1424,9 +1451,9 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         owner: {
             title: 'Your account has been locked',
             summary: 'On {{occurredAt}}, our team locked your {{brand.productName}} account. The message from our team: {{lock.message}}',
-            meaning: 'While it is locked: {{lock.affected}}',
+            meaning: 'What this means: {{lock.affected}}',
             steps: [
-                'Read the message above; it says what we need from you.',
+                'Nothing is needed from you unless the message above asks for something, or you believe this is a mistake.',
                 APPEAL_BY_REPLY
             ],
             actions: [
@@ -1479,11 +1506,11 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         includeSiteManagers: false,
         helpAnchor: 'locked',
         owner: {
-            title: '{{item.label}} is paused on {{workspace.name}}',
-            summary: 'On {{occurredAt}}, our team paused {{item.label}} for {{workspace.name}}. The message from our team: {{lock.message}}',
+            title: 'Paused on {{workspace.name}}: {{item.label}}',
+            summary: 'On {{occurredAt}}, our team paused {{item.label}} on {{workspace.name}}. The message from our team: {{lock.message}}',
             meaning: 'Everything else on your workspace keeps working. {{lock.affected}}',
             steps: [
-                'Read the message above; it says what we need from you.',
+                'Nothing is needed from you unless the message above asks for something, or you believe this is a mistake.',
                 'Contact support with the reference {{reference}} if you have questions.'
             ],
             actions: [
@@ -1492,7 +1519,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         },
         staff: {
             title: 'Workspace feature paused',
-            summary: '{{item.label}} was paused for {{workspace.name}} on {{occurredAt}}.',
+            summary: 'Paused for {{workspace.name}} on {{occurredAt}}: {{item.label}}.',
             actions: [
                 'staff-unlock',
                 'staff-view-workspace'
@@ -1509,7 +1536,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         includeSiteManagers: false,
         helpAnchor: 'locked',
         owner: {
-            title: '{{item.label}} is back on {{workspace.name}}',
+            title: 'Back on for {{workspace.name}}: {{item.label}}',
             summary: 'On {{occurredAt}}, our team turned {{item.label}} back on for {{workspace.name}}.',
             meaning: 'What happens now: {{lock.affected}}',
             steps: [
@@ -1521,7 +1548,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
         },
         staff: {
             title: 'Workspace feature restored',
-            summary: '{{item.label}} was restored for {{workspace.name}} on {{occurredAt}}.',
+            summary: 'Restored for {{workspace.name}} on {{occurredAt}}: {{item.label}}.',
             actions: [
                 'staff-view-workspace'
             ]
@@ -1541,7 +1568,7 @@ const CANNOT_SIGN_IN = 'If you cannot sign in, reply to this email or write to {
             summary: 'On {{occurredAt}}, our team canceled the subscription for {{workspace.name}}.',
             meaning: 'What changes: {{lock.affected}}',
             steps: [
-                'Export anything you need from your workspace.',
+                'Nothing is deleted. Your sites and data stay when the workspace moves to the Free plan.',
                 'Contact support if you believe this was a mistake, with the reference {{reference}}.'
             ],
             actions: [
@@ -1590,6 +1617,7 @@ export function isRiskEventKind(value) {
  * a sentence never has a hole in it.
  */ const TOKEN_FALLBACKS = {
     'workspace.name': 'your workspace',
+    'site.label': 'your site',
     'item.label': 'an item on your workspace',
     occurredAt: 'a recent date',
     reference: 'shown on this notice',
@@ -1597,7 +1625,10 @@ export function isRiskEventKind(value) {
     'lock.message': 'None was given.',
     'lock.affected': 'see your account for details.',
     amount: 'an amount shown on the payment',
+    'payment.event': 'flagged for a fraud check',
+    'page.visitors': 'Visitors see the previous version of this page, or a not-found page if it was never published, until the review is done.',
     'evidence.dueBy': 'the date shown on the order',
+    'payout.delay': 'each payout waits a set number of days after the sale before it reaches your bank',
     'staff.evidence': '',
     'brand.productName': 'the platform'
 };