@12-apps/payments-frontend 3.38.0 → 3.40.0

package/src/components/checkout/types.ts

@@ -2,11 +2,10 @@
  * The buyer checkout's payment vocabulary (FUT-7 / FUT-44 / FUT-58, moved into
  * the library by FUT-564).
  *
- * Pure types with no runtime imports. Everything here is PAYMENT: what a
- * charge, an order-in-payment, a buyer identity or a provider protocol looks
- * like to the screens in this folder. The host-side halves — the cart, the
- * catalog, order CREATION — stay in the host app and reach the flow through
- * the ports declared on `CheckoutFlowProps`.
+ * Pure types with no runtime imports. Everything here is PAYMENT: what a charge, an
+ * order-in-payment, a buyer identity or a provider protocol looks like to the screens in
+ * this folder. The host-side halves — the cart, the catalog, order CREATION — stay in the
+ * host app and reach the flow through the ports declared on `CheckoutFlowProps`.
  */
 
 import type { CheckoutDecline, CheckoutDeclineReason } from "./decline";
@@ -15,10 +14,9 @@ import type { CheckoutDecline, CheckoutDeclineReason } from "./decline";
 export type PaymentMethod = "PIX" | "CARD";
 
 /**
- * The digital wallets a chain entry can charge (FUT-471/472). Mirrors the
- * backend's `WalletType` — a wallet is not a fourth method: it is another way
- * of producing the CARD instrument, so it rides the CARD tile and the CARD
- * charge.
+ * The digital wallets a chain entry can charge (FUT-471/472). Mirrors the backend's
+ * `WalletType` — a wallet is not a fourth method: it is another way of producing the
+ * CARD instrument, so it rides the CARD tile and the CARD charge.
  */
 export type CheckoutWalletType = "GOOGLE_PAY" | "APPLE_PAY";
 
@@ -114,6 +112,8 @@ export interface CheckoutOrder {
   appliedDiscounts: CheckoutDiscount[];
   /** Pre-formatted BRL grand total (e.g. `R$ 42,90`). */
   totalLabel: string;
+  /** Cents the provider is asked for when a balance the host holds pays part of {@link totalCents}; absent ⇒ the total. */
+  amountDueCents?: number;
   /** Present only when {@link method} is `"PIX"`. */
   pix?: PixCharge;
   /**

package/src/index.ts

@@ -56,7 +56,7 @@ export { PT_BR_CHECKOUT_PAYMENT_COPY } from './components/checkout-payment-pt-BR
 // ---------------------------------------------------------------------------
 export { CheckoutFlow, type CheckoutCartView, type CheckoutFlowProps } from './components/checkout/checkout-flow';
 // The Pagamento step as ONE list (FUT-3591/3592) — opt-in via `CheckoutFlowProps.paymentList`.
-export type { CheckoutDoorOption, CheckoutListChoice, CheckoutListHold, CheckoutOnlineChoice, CheckoutPaymentList, PaymentListCopy } from './components/checkout/list/types';
+export type { CheckoutDoorOption, CheckoutListChoice, CheckoutListHold, CheckoutOnlineChoice, CheckoutPaymentList, CheckoutPixBank, PaymentListCopy, PixBankCopy, PixBankId, PixBankName } from './components/checkout/list/types';
 export { PT_BR_PAYMENT_LIST_COPY } from './components/checkout/list/pt-BR';
 export type { BackActionEmphasis } from './components/checkout/payment-status-parts';
 export type { CheckoutDeliverySummary, CheckoutSummaryLine } from './components/checkout/payment-summary';

package/src/locales.ts

@@ -22,7 +22,9 @@ import type { CheckoutScreensCopy } from './components/checkout/screens-copy';
 import { PT_BR_CHECKOUT_SCREENS_COPY } from './components/checkout/screens-pt-BR';
 import { EN_US_PAYMENT_LIST_COPY } from './components/checkout/list/en-US';
 import { PT_BR_PAYMENT_LIST_COPY } from './components/checkout/list/pt-BR';
-import type { PaymentListCopy } from './components/checkout/list/types';
+import { EN_US_PIX_BANK_COPY } from './components/checkout/list/bank-en-US';
+import { PT_BR_PIX_BANK_COPY } from './components/checkout/list/bank-pt-BR';
+import type { PaymentListCopy, PixBankCopy } from './components/checkout/list/types';
 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';
@@ -88,6 +90,15 @@ export const PAYMENT_LIST_COPY = {
   'en-US': EN_US_PAYMENT_LIST_COPY,
 } as const satisfies LocalePack<PaymentListCopy>;
 
+/**
+ * The Pix-to-bank flow's words (FUT-3612) — `CheckoutFlowProps.paymentList.pixBank.copy`.
+ * Read by the SHOPPER.
+ */
+export const PIX_BANK_COPY = {
+  'pt-BR': PT_BR_PIX_BANK_COPY,
+  'en-US': EN_US_PIX_BANK_COPY,
+} as const satisfies LocalePack<PixBankCopy>;
+
 export const CHECKOUT_COPY = {
   'pt-BR': PT_BR_CHECKOUT_COPY,
   'en-US': EN_US_CHECKOUT_COPY,