@12-apps/payments-frontend 3.13.0 → 3.14.0

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@12-apps/payments-frontend",
-  "version": "3.13.0",
+  "version": "3.14.0",
   "type": "module",
   "description": "Browser half of the vendor-agnostic payments platform: plug-and-play MUI components for the per-provider settings page (credential form from each provider's schema, masked hints, verify/enable) and the checkout page (PIX QR + polling, card tokenization, hosted-checkout redirect), plus the headless hooks and fetch clients they build on. Talks only to the host's payments HTTP surface — never to a provider directly. Microfrontend-ready: no app coupling, host injects theme and auth.",
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./src/index.ts",
+    "./locales": "./src/locales.ts"
   },
   "scripts": {
     "clean": "rm -rf node_modules coverage storybook-static",
@@ -17,7 +18,7 @@
     "storybook:build": "storybook build"
   },
   "dependencies": {
-    "@12-apps/payments-backend": "^4.18.0",
+    "@12-apps/payments-backend": "^4.19.0",
     "react-qr-code": "^2.2.0"
   },
   "peerDependencies": {

package/src/card/en-US.ts

@@ -0,0 +1,61 @@
+import type { CardCopy } from './copy';
+
+/**
+ * The en-US pack for the card form — a NAMED constant a host passes by hand,
+ * never a default.
+ *
+ * `MM/AA` becomes `MM/YY` and `CVV` stays `CVV`, and the difference between
+ * those two is the rule: the expiry mask is what the buyer TYPES, so it follows
+ * their own notation, while CVV is what is PRINTED on the card and is the same
+ * three letters in either language. `CPF` stays too — it is Brazil's taxpayer
+ * number, and there is nothing else to call the field a Brazilian buyer is
+ * filling in.
+ */
+export const EN_US_CARD_COPY: CardCopy = {
+  fields: {
+    unknownBrand: 'Card',
+    numberLabel: 'Card number',
+    numberRequired: 'Enter the card number.',
+    numberIncomplete: 'That card number is incomplete.',
+    numberInvalid: 'That card number is not valid.',
+    holderLabel: 'Name printed on the card',
+    holderRequired: 'Enter the name printed on the card.',
+    expiryLabel: 'Expiry (MM/YY)',
+    expiryPlaceholder: 'MM/YY',
+    cvvLabel: 'CVV',
+    expiryIncomplete: 'The expiry is incomplete (MM/YY).',
+    monthInvalid: 'That month is not valid.',
+    expired: 'That card has expired.',
+    expiryInvalid: 'That expiry is not valid, or has passed.',
+    cvvRequired: 'Enter the CVV.',
+    cvvInvalid: 'That CVV is not valid.',
+    // The length differs by brand (3 for most, 4 for Amex), so it is
+    // interpolated rather than written out.
+    cvvDigits: (length) => `The CVV must be ${length} digits.`,
+    cpfRequired: 'CPF is required.',
+    cpfInvalid: 'That CPF is not valid.',
+    savedCardsLabel: 'Card',
+    savedCardExpiry: (month, year) => `Expires ${month}/${year}`,
+    newCard: 'New card',
+    newCardDescription: 'Enter another card',
+    saveCard: 'Save this card for next time',
+  },
+  tokenize: {
+    sdkUnavailable: 'Could not load the payment method. Reload the page.',
+    cardNotProcessed: 'Could not process the card. Check the details and try again.',
+    providerUnreachable: 'Could not reach the card provider. Check your connection.',
+    providerTimedOut: 'The card provider did not answer in time.',
+    // The status and the raw response ride along because this is what a store
+    // owner forwards to support; a tidier sentence would drop the only part
+    // that identifies the failure.
+    providerRefused: (status, response) =>
+      `The card provider refused the card details (HTTP ${status}). ` + `Response: ${response}`,
+    noPublicKey:
+      'The card public key is not available for this store. ' +
+      'Reconnect the provider and try again.',
+    // Ends with what the BUYER can do, in order of how likely each is to work:
+    // this is the one message here a shopper reads mid-purchase.
+    cardUnavailable:
+      'Card payment is unavailable in this store right now. Reload the page and try again, choose another payment method, or arrange it with the store directly.',
+  },
+};

package/src/card/index.ts

@@ -42,3 +42,4 @@ export {
 export { NEW_CARD, type CardDetails, type CardFieldErrors, type CardToken, type SavedCard } from "./types";
 export type { CardCopy, CardFieldCopy, CardTokenizeCopy } from "./copy";
 export { PT_BR_CARD_COPY } from "./pt-BR";
+export { EN_US_CARD_COPY } from "./en-US";

package/src/components/checkout/en-US.ts

@@ -0,0 +1,95 @@
+import { EN_US_CARD_COPY } from "../../card/en-US";
+import { EN_US_CHECKOUT_SCREENS_COPY } from "./screens-en-US";
+import type { CheckoutCopy } from "./copy-context";
+import type { CheckoutViewCopy, PaymentStatusCopy } from "./view-copy";
+
+/**
+ * The en-US packs for the checkout views — NAMED exports a host passes by hand,
+ * never defaults.
+ *
+ * Four of these sentences carry a promise rather than a description, and the
+ * translation keeps each one FIRST in its block, because the fear on this
+ * screen is having been charged for an order that failed:
+ *
+ *  - `failed.support` and `expired.support` both open by saying nothing was
+ *    charged;
+ *  - `awaitingTimedOut.support` says "do not pay again" before anything else it
+ *    has to say, because a second payment is the expensive mistake here;
+ *  - `dados.secureNotice` is the one reassurance on the details step.
+ */
+export const EN_US_PAYMENT_STATUS_COPY: PaymentStatusCopy = {
+  paid: {
+    heading: "Order confirmed",
+    support: "We have your payment and the order is recorded.",
+  },
+  awaiting: {
+    heading: "Confirming your payment",
+    support: "This usually takes a few seconds. You can leave this screen open.",
+  },
+  failed: {
+    heading: "Payment not completed",
+    support: "Nothing was charged. You can try again.",
+  },
+  expired: {
+    heading: "The code expired",
+    support: "Nothing was charged. Generate a new code to carry on.",
+  },
+  awaitingTimedOut: {
+    heading: "We have not had the confirmation yet",
+    support:
+      "If you have already paid, the order is confirmed as soon as the provider tells us — " +
+      "do not pay again. You can close this screen.",
+  },
+  retryAction: "Try again",
+  regenerateAction: "Generate a new code",
+  backAction: "Back to the menu",
+  amountLabel: "Amount paid",
+  referenceLabel: "Order",
+  receiptEmailLabel: "Receipt sent to",
+};
+
+/**
+ * The words the checkout's deeper screens read from context — the card form,
+ * its tokenizers, and the buyer-details step's own fields.
+ */
+export const EN_US_CHECKOUT_COPY: CheckoutCopy = {
+  card: EN_US_CARD_COPY,
+  screens: EN_US_CHECKOUT_SCREENS_COPY,
+  buyer: {
+    emailInvalid: "That e-mail address is not valid.",
+    emailRequired: "E-mail is required.",
+    nameRequired: "Name is required.",
+    phoneRequired: "Phone is required.",
+    // The list of REQUIRED field names is the host's configuration, so the
+    // sentence is built around it — and it inflects on how many there are,
+    // which is why this is a function rather than a template.
+    fieldsHint: (names) =>
+      names.length === 0
+        ? "Name, e-mail and phone are optional — they are only used for the receipt."
+        : `Enter your ${names.join(", ")} (${names.length === 1 ? "required" : "required"} ` +
+          "for payment). The other fields are optional — they are only used for the receipt.",
+  },
+};
+
+export const EN_US_CHECKOUT_VIEW_COPY: CheckoutViewCopy = {
+  screens: EN_US_CHECKOUT_COPY,
+  // The step KEYS are the package's own ids; only the labels are words.
+  steps: {
+    dados: "Details",
+    payment: "Payment",
+    status: "Confirmation",
+  },
+  dados: {
+    saveProfile: "Save my details for next time",
+    cannotContinueTitle: "Could not continue",
+    continueAction: "Continue",
+    secureNotice: "Secure payment",
+    keepShopping: "Keep shopping",
+    back: "Back",
+  },
+  emptyCart: {
+    title: "Your cart is empty.",
+    action: "See the menu",
+  },
+  status: EN_US_PAYMENT_STATUS_COPY,
+};

package/src/components/checkout/screens-en-US.ts

@@ -0,0 +1,113 @@
+import type { CheckoutScreensCopy } from './screens-copy';
+
+/**
+ * The en-US pack for the buyer's checkout screens — a NAMED constant a host
+ * passes by hand, never a default.
+ *
+ * Two entries here are LOCALE TAGS rather than words, and they move with the
+ * pack because they decide how the same screen renders a time and a wallet
+ * button: `pix.expiryLocale` formats the "valid until" clock, and
+ * `wallet.googlePay.buttonLocale` is the language Google's own button renders
+ * itself in. A pack whose sentences were English and whose clock was
+ * Portuguese would be a screen written for nobody.
+ *
+ * PIX, CPF, Apple Pay and Google Pay all keep their names: the first two are
+ * Brazilian schemes the buyer will look for by name in their banking app, and
+ * the last two are the vendors' own product names, rendered by the vendors'
+ * own buttons.
+ */
+export const EN_US_CHECKOUT_SCREENS_COPY: CheckoutScreensCopy = {
+  method: {
+    groupLabel: 'Payment method',
+    pixLabel: 'PIX',
+    cardLabel: 'Card',
+    pixDescription: 'Approved instantly',
+    cardDescription: 'Credit, paid in full',
+    unavailableHere: 'Unavailable in this store',
+  },
+  settling: {
+    cannotConfirm: 'Could not confirm the payment',
+    takingLonger: 'The payment is taking longer than expected',
+    // "do not make another payment" is the load-bearing half: a second payment
+    // is the expensive mistake on this screen.
+    takingLongerHelp:
+      'You can wait, or check your order again shortly — do not make another payment.',
+    processing: 'Processing payment…',
+    confirming: 'We are confirming your payment',
+    cannotPay: 'Could not pay',
+  },
+  pix: {
+    heading: 'Pay with PIX',
+    instructions: (totalLabel) =>
+      `Scan the QR code in your banking app, or copy the code. Total ${totalLabel}.`,
+    qrAlt: 'PIX QR code for payment',
+    copyAction: 'Copy',
+    copiedAction: 'Copied!',
+    validUntil: (time) => `Valid until ${time}. Confirmation is automatic.`,
+    expiryLocale: 'en-US',
+    awaiting: 'Waiting for payment…',
+    chargeMissing: 'Could not generate the PIX code.',
+  },
+  card: {
+    heading: 'Pay by card',
+  },
+  payer: {
+    taxId: (formatted) => `CPF ${formatted}`,
+    taxIdAlreadyKnown: 'CPF already on file',
+    payingAs: (name) => `Paying as ${name}`,
+    payingWithSavedDetails: 'Paying with your saved details',
+    changeAction: 'Change',
+  },
+  error: {
+    confirming: 'We are confirming your payment',
+    cannotContinue: 'Could not continue',
+    retryAction: 'Try again',
+    emailLabel: 'E-mail for the payment',
+    // Lower-case and fragmentary: it renders as a hint under the field.
+    emailMustDifferHint: "use an e-mail address different from the store's",
+    useEmailAction: 'Use this e-mail and continue',
+  },
+  wallet: {
+    applePay: {
+      orderTotal: 'Order total',
+      cannotStart: 'Could not start Apple Pay in this store. Pay by card instead.',
+      cannotComplete: 'Could not start Apple Pay. Try again, or pay by card.',
+      payAction: 'Pay with Apple Pay',
+    },
+    googlePay: {
+      cannotComplete: 'Could not complete the payment with Google Pay. Try again, or pay by card.',
+      // Google's button renders itself in this language; it takes a bare
+      // language subtag, not a full BCP-47 tag.
+      buttonLocale: 'en',
+    },
+    orPayWithCard: 'or pay by card',
+  },
+  hosted: {
+    // Five fragments the screen composes into one sentence, so each keeps its
+    // leading preposition and none reads as a sentence on its own.
+    destinationNamed: (displayName) => `to ${displayName}'s payment page`,
+    destinationGeneric: "to the provider's secure payment page",
+    methodsChoice: (methods) => `, where you choose to pay with ${methods}`,
+    pixAndCard: 'PIX or card',
+    pixOnly: 'PIX',
+    cardOnly: 'card',
+    handoff: (destination, choice) => `You will be taken ${destination}${choice}.`,
+    afterwards:
+      'Once the payment goes through, you come back here and we confirm the order.',
+    startAction: 'Continue to payment',
+    preparing: 'Preparing the payment',
+  },
+  transport: {
+    failed: 'Could not complete the operation. Try again.',
+    invalidResponse: 'Invalid response from the server.',
+    offline: 'Could not connect. Check your connection and try again.',
+  },
+  validation: {
+    taxIdInvalid: 'That CPF is not valid.',
+    nameRequired: 'Enter your name.',
+    emailInvalid: 'That e-mail address is not valid.',
+    phoneInvalid: 'That phone number is not valid.',
+    required: 'This field is required.',
+  },
+  generatingPayment: 'Generating payment…',
+};

package/src/components/checkout-payment-en-US.ts

@@ -0,0 +1,53 @@
+import type { CheckoutPaymentCopy } from './checkout-payment-copy';
+
+/**
+ * The en-US pack for the legacy `CheckoutPayment` step — a NAMED constant a
+ * host passes by hand, never a default.
+ *
+ * `money.amountLocale` is part of the pack and moves with it: it is what the
+ * step formats the total with, so the words around a price and the price
+ * itself are written for the same reader. It does NOT change the CURRENCY —
+ * an English-reading buyer of a Brazilian store still pays in BRL.
+ *
+ * PIX keeps its name. It is Brazil's instant-payment scheme, and the buyer will
+ * look for those three letters in their banking app.
+ */
+export const EN_US_CHECKOUT_PAYMENT_COPY: CheckoutPaymentCopy = {
+  money: {
+    totalLabel: (formattedAmount) => `Total: ${formattedAmount}`,
+    payAction: (formattedAmount) => `Pay ${formattedAmount}`,
+    amountLocale: 'en-US',
+  },
+  method: {
+    groupLabel: 'Payment method',
+    pixTitle: 'PIX',
+    pixSubtitle: 'Approved instantly',
+    cardTitle: 'Card',
+    cardSubtitle: 'Credit, paid in full',
+    generatePixAction: 'Generate a PIX QR code',
+    continueToPaymentAction: 'Continue to payment',
+  },
+  pix: {
+    qrAlt: 'PIX QR code',
+    copyPasteLabel: 'PIX copy-and-paste code',
+    copyAction: 'Copy the code',
+    copiedAction: 'Copied!',
+    awaiting: 'Waiting for payment…',
+  },
+  card: {
+    heading: 'Pay by card',
+    numberLabel: 'Card number',
+    holderLabel: 'Name printed on the card',
+    expiryLabel: 'Expiry (MM/YY)',
+    cvvLabel: 'CVV',
+    payAction: 'Pay by card',
+    newCard: 'New card — enter another card',
+    savedCard: (brand, last4, expiry) =>
+      `${brand} •••• ${last4}${expiry ? ` — expires ${expiry}` : ''}`,
+  },
+  refusal: {
+    paymentsOff: 'This store does not accept online payments yet.',
+    cardUnavailable: 'Card payment is unavailable.',
+    redirectNotice: 'You will be taken somewhere secure to finish the payment.',
+  },
+};

package/src/components/platform/en-US.ts

@@ -0,0 +1,93 @@
+import type { PlatformHomologacaoCopy } from './copy';
+
+/**
+ * The en-US pack for the platform's homologação screens.
+ *
+ * A NAMED pack, which is how this repo ships a language: a host imports it and
+ * passes it by hand.
+ *
+ * ## What is translated here, and what is not
+ *
+ * These screens are read by the platform OPERATOR filling PagBank's form, and
+ * that is what the words are for — so the instructions, headings and statuses
+ * are English here.
+ *
+ * What stays is everything the operator has to MATCH against PagBank's own
+ * surfaces: `redirect_uri` is the parameter name in the API response, "SIP" and
+ * "Pipefy" are the names of the systems they will open, `ACCESS_DENIED` is the
+ * error string they are quoting in the ticket, and "homologação" is what
+ * PagBank calls the process — an operator searching support for
+ * "homologation" finds nothing.
+ *
+ * The ANSWERS the form is filled with are a different matter and are not here
+ * at all: they live in `@12-apps/payments-backend`'s `PT_BR_HOMOLOGACAO_ANSWERS`
+ * and stay Portuguese, because a PagBank reviewer reads them and several are
+ * multiple-choice options on the form itself.
+ */
+export const EN_US_PLATFORM_HOMOLOGACAO_COPY: PlatformHomologacaoCopy = {
+  outcome: {
+    heading: 'Homologação status',
+    statusLabel: 'Status',
+    notSubmitted: 'Not submitted',
+    protocolLabel: 'Protocol',
+    protocolPlaceholder: 'Protocol (Pipefy card / ticket)',
+    notesLabel: 'Notes',
+    notesPlaceholder: "Notes (PagBank's reply, context…)",
+    save: 'Record',
+    saved: 'Record updated.',
+    // The KEYS are the stored status values, not words.
+    statuses: { SUBMITTED: 'Submitted', APPROVED: 'Approved', REJECTED: 'Rejected' },
+    // Three fragments the screen concatenates into one line, so the first two
+    // keep their trailing space and the last one ends the sentence.
+    submittedAt: (when) => `Submitted ${when}. `,
+    decidedAt: (when) => `Decided ${when}. `,
+    recordedBy: (who) => `Recorded by ${who}.`,
+  },
+  guide: {
+    heading: 'Homologação form — answers ready to paste',
+    // Five fragments wrapping two links. Each keeps its own leading or
+    // trailing space; a translation that made them whole sentences would break
+    // the line the screen actually renders.
+    ledeBeforeForm: 'Open the ',
+    formLink: 'official homologação form',
+    ledeBeforeSupport: ' and fill it in with the values below. In parallel, open a ticket on ',
+    supportLink: 'SIP — PagBank integration support',
+    ledeBeforeDocs:
+      ' quoting the 403 ACCESS_DENIED: what you answer first decides whether the form covers Connect. Documentation: ',
+    docsLink: 'requesting homologação',
+    ledeAfterDocs: '.',
+  },
+  anexo: {
+    heading: 'Evidence attachment',
+    body:
+      "The form asks for the requests and responses of the calls sent to PagBank's APIs. The file is generated from this platform's real calls, with the token redacted.",
+    generate: 'Generate attachment',
+    generateFailed: 'Could not generate the attachment.',
+  },
+  connect: {
+    expectedRedirectHeading: 'The callback this deploy uses (the value that must be registered)',
+    consultAgain: 'Look it up again',
+    noApplication: 'No application configured in this environment.',
+    // `redirect_uri` is the parameter name in PagBank's own response — an
+    // operator compares the two strings character by character.
+    redirectMatches: 'The registered redirect_uri matches the callback this deploy uses.',
+    redirectDiffers:
+      'The redirect_uri registered with PagBank differs from the callback this deploy uses.',
+    redirectUnreported:
+      "PagBank's response carried no redirect_uri, so it could not be compared with the callback.",
+    fields: {
+      name: 'Name (shown to the store owner)',
+      site: 'Site',
+      description: 'Description',
+      logo: 'Logo',
+      redirectUri: 'registered redirect_uri',
+    },
+    fieldEmpty: '—',
+    redirectNotReported: 'not reported',
+    resolvedFrom:
+      "This environment's application is resolved strictly from these variables, with no fallback between environments:",
+    showConfig: 'Show environment variables',
+    hideConfig: 'Hide environment variables',
+    extraKeys: 'Other fields returned',
+  },
+};

package/src/components/settings-en-US.ts

@@ -0,0 +1,187 @@
+import type { PaymentsSettingsCopy } from './settings-copy';
+
+/**
+ * The en-US pack for the payments settings surface — a NAMED constant a host
+ * passes by hand, never a default.
+ *
+ * The four sentences that matter most on this screen are the ones about MONEY
+ * MOVING, and the translation keeps each of them blunt rather than polite:
+ *
+ *  - `confirmSave.warning` — a wrong value pays a stranger, irreversibly;
+ *  - `card.removeConsequenceLive` — removing a live connection stops the store
+ *    taking money immediately;
+ *  - `priority.noneActive` — with nothing active the checkout cannot charge;
+ *  - `credentials.reverifyWarning` — changing credentials stops collection
+ *    until re-verification finishes.
+ *
+ * `**bold**` markers are the surface's own emphasis and survive translation, on
+ * the phrase that carries the consequence.
+ */
+export const EN_US_PAYMENTS_SETTINGS_COPY: PaymentsSettingsCopy = {
+  status: {
+    verified: 'VERIFIED',
+    unverified: 'NOT VERIFIED',
+    connectionOk: 'CONNECTION OK',
+    reconnectRequired: 'RECONNECT',
+    notConnected: 'Not connected',
+    threeStepsAhead: 'This provider only starts taking sales after the 3 steps below.',
+    connectAndVerifyFirst: 'Connect and verify the provider before switching sales on.',
+    receiving: {
+      state: 'Taking sales',
+      sub: 'Your store is being paid through this provider.',
+    },
+    pausedByOwner: {
+      state: 'Paused',
+      sub: 'Connection ready and paused by you — no new order is charged here.',
+    },
+    pausedChip: 'Paused',
+    readyNotReceiving: {
+      state: 'Not taking sales yet',
+      sub: 'Everything is ready — flip the switch to start taking payments.',
+    },
+  },
+  listBadge: {
+    active: 'Active',
+    connected: 'Connected',
+    reconnect: 'Reconnect',
+    notConnected: 'Not connected',
+  },
+  environment: {
+    production: 'Production',
+    sandbox: 'Sandbox',
+    groupLabel: "This connection's environment",
+    productionMeaning: 'Production — real money.',
+    sandboxMeaning: 'Sandbox — a test environment.',
+    productionConsequence: "Everything you do here applies to the store's real sales.",
+    sandboxConsequence: 'No money actually moves.',
+    // Leading space: it is appended to one of the sentences above.
+    storeIsUsing: (environmentName) => ` The store is currently using ${environmentName}.`,
+  },
+  oauth: {
+    connectAction: (displayName) => `Connect with ${displayName}`,
+    reconnectAction: 'Reconnect',
+    removeAction: 'Remove connection',
+    invitation: (displayName) =>
+      `Connect your ${displayName} account by authorising access on the provider's site. No keys to copy.`,
+    roundTripNote: 'You go out to the provider and come back here — it takes under a minute.',
+    connectedExplainer:
+      'Your account is connected. Charges are created on your behalf — no keys to copy.',
+    connectedNote: (displayName) =>
+      `${displayName} account connected. Revoke it whenever you like, here or in the provider's dashboard.`,
+    connectedAt: (when) => `Connected ${when}`,
+    validUntil: (when) => `Authorisation valid until ${when}`,
+    expiredAt: (when) =>
+      `The authorisation expired on ${when}. Reconnect to start taking payments again.`,
+    expiresAt: (when) =>
+      `The authorisation expires on ${when}. If the warning stays, reconnect the account.`,
+    revoked:
+      'The authorisation expired or was revoked. Reconnect to start taking payments again.',
+    notAvailableHere: (displayName) =>
+      `Connecting to ${displayName} automatically is not available in this installation — ` +
+      'the authorisation application has not been registered. To connect now, open ' +
+      '“I would rather enter the credentials myself” below and paste your own keys.',
+    connectUnavailable:
+      'This provider connects by authorisation, but the connect button is not available in this ' +
+      'installation. You can still connect by entering the credentials yourself.',
+    preferOAuth: 'I would rather connect by authorisation',
+    preferCredentials: 'I would rather enter the credentials myself',
+    // What the owner is granting, shown before they authorise.
+    scopes: {
+      read: 'Look up payments',
+      create: 'Create charges',
+      refund: 'Refund payments',
+      account: 'Look up account details',
+    },
+  },
+  card: {
+    accountHeading: (displayName) => `${displayName} account`,
+    accountLabel: 'Account',
+    connectionLabel: 'Connection',
+    authorizedAt: (displayName) => `Authorised on ${displayName}`,
+    environmentLabel: 'Environment',
+    connectedAtLabel: 'Connected',
+    sandboxWithNote: 'Sandbox (testing)',
+    steps: {
+      signIn: (displayName) =>
+        `Sign in to your ${displayName} account — you can create one on the spot if you do not have one.`,
+      authorize: "Authorise access on the provider's screen.",
+      comeBack: 'You come back here with the account connected.',
+    },
+    removeAction: 'Remove connection',
+    removeQuestion: (displayName) => `Remove the connection to ${displayName}?`,
+    removeConsequenceLive:
+      'The store stops taking payments immediately and is left with no active provider — new orders cannot be paid until you connect another.',
+    removeConsequenceIdle: 'This connection leaves the store. You can connect again later.',
+    removeStopsChargingNow: 'New orders stop being charged immediately.',
+    removeRevokes: (displayName) =>
+      `The authorisation is revoked at ${displayName}. Your account and its history stay there, untouched.`,
+    removeKeepsSettled: (displayName) =>
+      `Payments already approved and refunds in flight carry on as normal through ${displayName}.`,
+    removeRestartsSetup: 'To reconnect, the steps start again from the beginning.',
+    pauseInstead: 'Just pause taking payments',
+    cancel: 'Cancel',
+  },
+  credentials: {
+    configuredKeepBlank: 'Configured — leave blank to keep the current value.',
+    // Leading space: it is appended to a field label.
+    advancedSuffix: ' · Connect platforms only',
+    probeAction: 'Test connection',
+    reverifyWarning: (displayName) =>
+      `This store is already verified. Changing the credentials **requires re-verification** ` +
+      `and the store **stops taking payments** through ${displayName} until it finishes.`,
+    probeRunning: 'Testing the connection…',
+    probeSaveNote: 'We save and test the keys with the provider before going on.',
+    probeIncompleteNote: 'We kept what you have filled in. Complete the fields to test.',
+    probeFailed: (environmentName) =>
+      `Could not connect in ${environmentName}. Check the credentials for this environment.`,
+    checkPass: 'Verified',
+    checkFail: 'Fix',
+    uncheckable: 'Not verifiable',
+    saveAndTest: 'Save and test connection',
+    save: 'Save',
+    saveOnly: (fieldLabel) => `Save ${fieldLabel}`,
+    changeAction: 'Change',
+  },
+  priority: {
+    moveUp: (label) => `Move ${label} up`,
+    moveDown: (label) => `Move ${label} down`,
+    saveFailed: 'Could not save the order.',
+    firstInChain: 'first',
+    orderHeading: 'Order of attempts',
+    chainExplainer: (firstProviderLabel) =>
+      `Checkout tries **${firstProviderLabel}** first. If a charge fails for a technical ` +
+      'reason it tries the next in the list — but only when it can prove the previous ' +
+      'attempt did not charge anything.',
+    noneActive:
+      'No provider is active. Checkout will not be able to charge until you switch at least one on.',
+    retryDeclinedLabel: 'Retry a **declined** card with the next provider',
+    // Both sides of the switch say what it COSTS, which is the point of the
+    // pair: one names the risk, the other names the default.
+    retryDeclinedOn:
+      'A decline moves on to the next in the list. This can raise transaction costs and fraud signals.',
+    retryDeclinedOff:
+      'Default: a decline ends the charge. Only technical failures move on to the next.',
+  },
+  providerList: {
+    heading: 'Choose the payment provider',
+    subheading: 'Pick where your store is paid — the setup is tailored to it.',
+  },
+  confirmSave: {
+    title: 'Confirm where the money goes',
+    body: (fieldLabel) =>
+      `Every payment this store takes will be deposited into the account this ${fieldLabel} belongs to:`,
+    fieldFallback: 'credential',
+    warning:
+      "A wrong value sends this store's payments to somebody else, and there is no way to reverse it.",
+    cancelAction: 'Go back and check',
+    confirmAction: "That's the one, save it",
+  },
+  setupGuide: {
+    defaultConfirmLabel: 'I have enabled Integrated Checkout',
+    confirmedByYou: 'Confirmed by you',
+    reviewAction: 'Review',
+    confirmPrompt: "Confirm once you have finished on the provider's side.",
+    copyValue: (fieldLabel) => `Copy ${fieldLabel}`,
+    copied: 'Copied',
+  },
+};

package/src/locales.ts

@@ -0,0 +1,100 @@
+import type { CardCopy } from './card/copy';
+import { EN_US_CARD_COPY, PT_BR_CARD_COPY } from './card';
+import type { CheckoutPaymentCopy } from './components/checkout-payment-copy';
+import { EN_US_CHECKOUT_PAYMENT_COPY } from './components/checkout-payment-en-US';
+import { PT_BR_CHECKOUT_PAYMENT_COPY } from './components/checkout-payment-pt-BR';
+import type { CheckoutCopy } from './components/checkout/copy-context';
+import {
+  EN_US_CHECKOUT_COPY,
+  EN_US_CHECKOUT_VIEW_COPY,
+  EN_US_PAYMENT_STATUS_COPY,
+} from './components/checkout/en-US';
+import {
+  PT_BR_CHECKOUT_COPY,
+  PT_BR_CHECKOUT_VIEW_COPY,
+  PT_BR_PAYMENT_STATUS_COPY,
+} from './components/checkout/pt-BR';
+import { EN_US_CHECKOUT_SCREENS_COPY } from './components/checkout/screens-en-US';
+import type { CheckoutScreensCopy } from './components/checkout/screens-copy';
+import { PT_BR_CHECKOUT_SCREENS_COPY } from './components/checkout/screens-pt-BR';
+import type { CheckoutViewCopy, PaymentStatusCopy } from './components/checkout/view-copy';
+import type { PlatformHomologacaoCopy } from './components/platform/copy';
+import { EN_US_PLATFORM_HOMOLOGACAO_COPY } from './components/platform/en-US';
+import { PT_BR_PLATFORM_HOMOLOGACAO_COPY } from './components/platform/pt-BR';
+import { EN_US_PAYMENTS_SETTINGS_COPY } from './components/settings-en-US';
+import type { PaymentsSettingsCopy } from './components/settings-copy';
+import { PT_BR_PAYMENTS_SETTINGS_COPY } from './components/settings-pt-BR';
+
+/**
+ * Every surface this half renders, in both languages, keyed by tag.
+ *
+ * The two AUDIENCES here are worth keeping apart when a host wires them: the
+ * checkout packs are read by a SHOPPER mid-purchase and the settings and
+ * homologação packs by the store's OPERATOR. A store whose owner reads English
+ * and whose buyers read Portuguese is the ordinary case, not an edge one, so
+ * these resolve from different preferences rather than one.
+ *
+ * `LocalePack` is declared here rather than imported, and in this package that
+ * is not merely a preference: `payments/no-host-imports` forbids
+ * `packages/payments/**` from importing a sibling workspace package at all.
+ */
+type LocalePack<T> = { readonly 'pt-BR': T; readonly 'en-US': T };
+
+export const CARD_COPY = {
+  'pt-BR': PT_BR_CARD_COPY,
+  'en-US': EN_US_CARD_COPY,
+} as const satisfies LocalePack<CardCopy>;
+
+export const CHECKOUT_SCREENS_COPY = {
+  'pt-BR': PT_BR_CHECKOUT_SCREENS_COPY,
+  'en-US': EN_US_CHECKOUT_SCREENS_COPY,
+} as const satisfies LocalePack<CheckoutScreensCopy>;
+
+export const CHECKOUT_COPY = {
+  'pt-BR': PT_BR_CHECKOUT_COPY,
+  'en-US': EN_US_CHECKOUT_COPY,
+} as const satisfies LocalePack<CheckoutCopy>;
+
+export const CHECKOUT_VIEW_COPY = {
+  'pt-BR': PT_BR_CHECKOUT_VIEW_COPY,
+  'en-US': EN_US_CHECKOUT_VIEW_COPY,
+} as const satisfies LocalePack<CheckoutViewCopy>;
+
+export const PAYMENT_STATUS_COPY = {
+  'pt-BR': PT_BR_PAYMENT_STATUS_COPY,
+  'en-US': EN_US_PAYMENT_STATUS_COPY,
+} as const satisfies LocalePack<PaymentStatusCopy>;
+
+export const CHECKOUT_PAYMENT_COPY = {
+  'pt-BR': PT_BR_CHECKOUT_PAYMENT_COPY,
+  'en-US': EN_US_CHECKOUT_PAYMENT_COPY,
+} as const satisfies LocalePack<CheckoutPaymentCopy>;
+
+export const PAYMENTS_SETTINGS_COPY = {
+  'pt-BR': PT_BR_PAYMENTS_SETTINGS_COPY,
+  'en-US': EN_US_PAYMENTS_SETTINGS_COPY,
+} as const satisfies LocalePack<PaymentsSettingsCopy>;
+
+export const PLATFORM_HOMOLOGACAO_COPY = {
+  'pt-BR': PT_BR_PLATFORM_HOMOLOGACAO_COPY,
+  'en-US': EN_US_PLATFORM_HOMOLOGACAO_COPY,
+} as const satisfies LocalePack<PlatformHomologacaoCopy>;
+
+/**
+ * The en-US packs are published from HERE rather than from the root barrel,
+ * which is at its 400-line budget. That is a happier arrangement than it
+ * sounds: `@12-apps/payments-frontend/locales` is now the one subpath that
+ * holds everything about language — the per-locale packs and the records that
+ * key them — while the root keeps exporting the pt-BR names it always has, so
+ * no existing import moves.
+ */
+export { EN_US_CARD_COPY } from './card';
+export { EN_US_CHECKOUT_PAYMENT_COPY } from './components/checkout-payment-en-US';
+export {
+  EN_US_CHECKOUT_COPY,
+  EN_US_CHECKOUT_VIEW_COPY,
+  EN_US_PAYMENT_STATUS_COPY,
+} from './components/checkout/en-US';
+export { EN_US_CHECKOUT_SCREENS_COPY } from './components/checkout/screens-en-US';
+export { EN_US_PAYMENTS_SETTINGS_COPY } from './components/settings-en-US';
+export { EN_US_PLATFORM_HOMOLOGACAO_COPY } from './components/platform/en-US';