@12-apps/payments-frontend 3.5.0 → 3.7.0

package/src/components/checkout/pt-BR.ts

@@ -0,0 +1,74 @@
+import type {
+  CheckoutViewCopy,
+  PaymentsUnavailableCopy,
+  PaymentStatusCopy,
+} from "./view-copy";
+
+/**
+ * The pt-BR pack — the exact sentences these views compiled in until 6.0.0,
+ * now NAMED exports a host passes by hand, never defaults. The filename is
+ * what exempts this file from the copy-portability gate: Portuguese may ship,
+ * it may not be silent.
+ */
+export const PT_BR_PAYMENTS_UNAVAILABLE_COPY: PaymentsUnavailableCopy = {
+  title: "Pagamento online indisponível",
+  body: "Esta loja não recebe pagamentos pelo site. Combine o pagamento diretamente com a loja para concluir seu pedido.",
+  remedyTitle: "Pagamento com o garçom",
+  remedyBody: "Esta loja não recebe pagamentos pelo site. Chame o garçom para fechar a conta na mesa.",
+  callAction: "Chamar garçom",
+  callingAction: "Chamando...",
+};
+
+export const PT_BR_PAYMENT_STATUS_COPY: PaymentStatusCopy = {
+  paid: {
+    heading: "Pedido confirmado",
+    support: "Recebemos seu pagamento e já registramos o pedido.",
+  },
+  awaiting: {
+    heading: "Confirmando seu pagamento",
+    support: "Isso costuma levar alguns segundos. Pode deixar esta tela aberta.",
+  },
+  failed: {
+    // Said plainly and first: the fear on this screen is having been charged
+    // for an order that failed.
+    heading: "Pagamento não concluído",
+    support: "Nenhum valor foi cobrado. Você pode tentar novamente.",
+  },
+  expired: {
+    heading: "O código expirou",
+    support: "Nenhum valor foi cobrado. Gere um novo código para continuar.",
+  },
+  awaitingTimedOut: {
+    heading: "Ainda não recebemos a confirmação",
+    support:
+      "Se você já pagou, o pedido é confirmado assim que a operadora avisar — " +
+      "não pague de novo. Você pode fechar esta tela.",
+  },
+  retryAction: "Tentar novamente",
+  regenerateAction: "Gerar novo código",
+  backAction: "Voltar ao cardápio",
+  amountLabel: "Valor pago",
+  referenceLabel: "Pedido",
+  receiptEmailLabel: "Comprovante enviado para",
+};
+
+export const PT_BR_CHECKOUT_VIEW_COPY: CheckoutViewCopy = {
+  steps: {
+    dados: "Dados",
+    payment: "Pagamento",
+    status: "Confirmação",
+  },
+  dados: {
+    saveProfile: "Salvar meus dados para a próxima compra",
+    cannotContinueTitle: "Não foi possível continuar",
+    continueAction: "Continuar",
+    secureNotice: "Pagamento seguro",
+    keepShopping: "Continuar comprando",
+    back: "Voltar",
+  },
+  emptyCart: {
+    title: "Seu carrinho está vazio.",
+    action: "Ver cardápio",
+  },
+  status: PT_BR_PAYMENT_STATUS_COPY,
+};

package/src/components/checkout/types.ts

@@ -250,6 +250,17 @@ export interface CheckoutCustomerField {
  */
 export interface CheckoutChainLink {
   provider: string;
+  /**
+   * The provider's own name as a BUYER should read it ("InfinitePay"), which
+   * `GET /api/checkout/config` publishes per entry.
+   *
+   * Optional, and the DEGRADE DIRECTION IS "SAY NOTHING": an older host serves
+   * no name, and a hand-off screen then describes where the buyer is going
+   * without naming it, rather than printing the internal `provider` id — a
+   * buyer shown "infinitepay" learns less than one shown nothing, and learns
+   * it in a vocabulary that is ours rather than theirs.
+   */
+  displayName?: string | null;
   tokenization: "NONE" | "PUBLIC_KEY" | "SDK" | "REDIRECT";
   publicKey: string | null;
   mockTokenization: boolean;

package/src/components/checkout/view-copy.ts

@@ -0,0 +1,94 @@
+/**
+ * Every string the legacy checkout views render — required props, with NO
+ * defaults, deliberately (the payments extraction's own doctrine, FUT-760):
+ * a default in the origin host's language reads as finished to the next host
+ * right up until a buyer sees it. These three views proved the point — the
+ * flows factory's copy port existed, was REQUIRED, declared
+ * `unavailableWithRemedyTitle` and `emptyCartAction`, and the views simply
+ * never read it, so a host that dutifully passed copy still rendered another
+ * product's voice.
+ *
+ * A pt-BR host imports {@link PT_BR_CHECKOUT_VIEW_COPY} from `./pt-BR` (the
+ * package root re-exports it) and passes it by hand — one reviewable line,
+ * never a silence.
+ */
+
+/** The screen shown when the store cannot take money online. */
+export interface PaymentsUnavailableCopy {
+  /** No remedy: the store simply does not charge online. */
+  title: string;
+  body: string;
+  /** A remedy exists (the origin host: the waiter; a clinic: the front desk). */
+  remedyTitle: string;
+  remedyBody: string;
+  /** The remedy button, idle and in flight. */
+  callAction: string;
+  callingAction: string;
+}
+
+/** The stepper's three labels, in flow order. */
+export interface CheckoutStepperCopy {
+  dados: string;
+  payment: string;
+  status: string;
+}
+
+/** The buyer-details step: its bar, its refusal, and the slim header. */
+export interface DadosStepCopy {
+  /** The save-my-details checkbox. */
+  saveProfile: string;
+  /** The refusal Alert's title (its body is the server's own sentence). */
+  cannotContinueTitle: string;
+  /** The sticky bar's one action. */
+  continueAction: string;
+  /**
+   * The reassurance caption under it. OPTIONAL, on the flows port's
+   * `secureNotice` precedent: a host that has not written the sentence gets
+   * NO caption rather than someone else's.
+   */
+  secureNotice?: string;
+  /** The slim header's back control, on Dados and after it. */
+  keepShopping: string;
+  back: string;
+}
+
+/** Nothing to check out (cart mode only). */
+export interface EmptyCartCopy {
+  title: string;
+  action: string;
+}
+
+/** One outcome's headline and its single supporting line. */
+export interface StatusOutcomeCopy {
+  heading: string;
+  support: string;
+}
+
+/**
+ * The confirmation screen. Icons and tones stay the component's — they are
+ * visual grammar, not language; every SENTENCE is the host's, including the
+ * timed-out wait's "do not pay again", which is the one instruction on this
+ * screen that matters (FUT-556).
+ */
+export interface PaymentStatusCopy {
+  paid: StatusOutcomeCopy;
+  awaiting: StatusOutcomeCopy;
+  failed: StatusOutcomeCopy;
+  expired: StatusOutcomeCopy;
+  awaitingTimedOut: StatusOutcomeCopy;
+  retryAction: string;
+  regenerateAction: string;
+  backAction: string;
+  /** The paid receipt's three row labels. */
+  amountLabel: string;
+  referenceLabel: string;
+  receiptEmailLabel: string;
+}
+
+/** What the legacy `CheckoutFlow` itself renders and must be handed. */
+export interface CheckoutViewCopy {
+  steps: CheckoutStepperCopy;
+  dados: DadosStepCopy;
+  emptyCart: EmptyCartCopy;
+  status: PaymentStatusCopy;
+}

package/src/flows/copy.ts

@@ -18,8 +18,20 @@
  * the port and nothing else.
  */
 
+import type { CheckoutViewCopy } from "../components/checkout/view-copy";
+
+export type { CheckoutViewCopy };
+
 /** Every buyer-facing string the factory's own screens render. */
 export interface CheckoutCopyFE {
+  /**
+   * Everything the wrapped `CheckoutFlow` itself renders — stepper labels,
+   * the Dados step, the empty cart, the whole confirmation screen. FUT-741
+   * scoped those screens out as "already carried their own product copy";
+   * that copy was one application's Portuguese, so the scope-out WAS the
+   * leak. A pt-BR host passes `PT_BR_CHECKOUT_VIEW_COPY` here by hand.
+   */
+  views: CheckoutViewCopy;
   /** No provider connected AND no host remedy: the store simply does not charge. */
   unavailableTitle: string;
   unavailableBody: string;
@@ -47,11 +59,23 @@ export interface CheckoutCopyFE {
    * part only a host can own.
    */
   returnTimedOut?: string;
-  /** Nothing to check out (cart mode only). */
-  emptyCartTitle: string;
-  emptyCartAction: string;
   /** The Dados step's primary action. */
   continueAction: string;
+  /**
+   * The reassurance caption under that action.
+   *
+   * The screen rendered "Pagamento seguro" inline — one line below a sibling
+   * reading `runtime.copy.continueAction`, so the port was already there and
+   * already required; this string simply never asked it. That is the shape
+   * FUT-760 left behind: defaults removed from the CONFIG surface without the
+   * rendering being rewired, so a host that dutifully passes copy still gets
+   * the origin product's voice.
+   *
+   * OPTIONAL, on the {@link CheckoutCopyFE.returnTimedOut} precedent: a host
+   * that has not written the sentence gets NO caption rather than someone
+   * else's. Reassurance nobody chose is worth less than silence.
+   */
+  secureNotice?: string;
   /** The add-card screen (FUT-183): putting a card on file outside a purchase. */
   addCardTitle: string;
   addCardAction: string;

package/src/flows/create-payment-flows.tsx

@@ -85,6 +85,7 @@ function buildCheckout(
 
     return (
       <CheckoutFlow
+        copy={runtime.copy.views}
         cart={cart}
         createOrder={createOrder}
         saveBuyerContact={ports.saveBuyerContact}

package/src/flows/screens-buyer.tsx

@@ -87,9 +87,11 @@ function buildBuyerDetails(runtime: FlowsRuntime): CheckoutScreens["BuyerDetails
             {runtime.copy.continueAction}
           </Button>
         </Box>
-        <Text variant="caption" size="xs" color="secondary" as="p">
-          Pagamento seguro
-        </Text>
+        {runtime.copy.secureNotice ? (
+          <Text variant="caption" size="xs" color="secondary" as="p">
+            {runtime.copy.secureNotice}
+          </Text>
+        ) : null}
       </Box>
     );
   }
@@ -155,7 +157,7 @@ function buildEmptyCart(runtime: FlowsRuntime): CheckoutScreens["EmptyCart"] {
   return function EmptyCart() {
     return (
       <FlowsShell runtime={runtime}>
-        <EmptyCartView onBack={runtime.config.ports.exitToCatalog} />
+        <EmptyCartView copy={runtime.copy.views.emptyCart} onBack={runtime.config.ports.exitToCatalog} />
       </FlowsShell>
     );
   };

package/src/flows/screens-pay.tsx

@@ -82,6 +82,7 @@ function buildPaymentStatus(runtime: FlowsRuntime): CheckoutScreens["PaymentStat
     return (
       <FlowsShell runtime={runtime}>
         <PaymentStatusView
+          copy={runtime.copy.views.status}
           status={status}
           totalLabel={payable?.totalLabel ?? ""}
           orderId={payable?.orderId}

package/src/index.ts

@@ -85,6 +85,20 @@ export {
 } from './components/checkout/transport';
 export { type CheckoutHostPorts } from './components/checkout/use-checkout-controller';
 export { PaymentsUnavailable } from './components/checkout/payments-unavailable';
+export type {
+  CheckoutStepperCopy,
+  CheckoutViewCopy,
+  DadosStepCopy,
+  EmptyCartCopy,
+  PaymentStatusCopy,
+  PaymentsUnavailableCopy,
+  StatusOutcomeCopy,
+} from './components/checkout/view-copy';
+export {
+  PT_BR_CHECKOUT_VIEW_COPY,
+  PT_BR_PAYMENTS_UNAVAILABLE_COPY,
+  PT_BR_PAYMENT_STATUS_COPY,
+} from './components/checkout/pt-BR';
 export { fetchCheckoutConfig } from './components/checkout/client';
 /**
  * The `sessionStorage` key the hosted-checkout return leg parks the raised