@vtex/faststore 0.0.8 → 0.0.11

package/dist/matter/payment/use-payment-submit-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-payment-submit-gate.js","names":[],"sources":["../../../src/matter/payment/use-payment-submit-gate.ts"],"sourcesContent":["'use client';\n\nimport { useMemo } from 'react';\nimport { type DocumentType, isValidDocument } from '../../particles/document-field/document-field.js';\nimport type { PaymentUserError } from '../../sdk/payment/operations.js';\nimport { resolveCardholderDocument } from './cardholder-document-rule.js';\nimport { usePayment } from './payment.js';\nimport type { PaymentSectionMethod } from './use-payment-method-selection.js';\n\n/**\n * The submit gate (specs/cardholder-document-submit-gate.md, T24 of the Credit Card epic;\n * docs/features/credit-card/rfc.md § D3, D6). One pure resolver covering the two facts T11's own\n * deferral asked to ship together: a required-but-missing-or-malformed cardholder document, and a\n * declined \"same as delivery\" billing address with nothing persisted yet. `PlaceOrder` (T14) reads the\n * verdict through `usePaymentSubmitGate()` below and forwards it into `usePlaceOrder`'s (T13)\n * pre-flight, which refuses on it before `startTransaction` ever opens a transaction the client already\n * knows it cannot complete.\n *\n * **Only the verdict crosses into `sdk/payment/`.** `usePlaceOrder` never learns *why* it refused —\n * only this opaque `PaymentUserError` — because `sdk/payment/use-place-order.ts` may name no identifier\n * matching `CARD_FIELD_PATTERN` (`sdk/payment/card-field-pattern.ts`), which includes `document`. Every\n * fact the gate reads, and the four codes below, live here in `matter/payment/` instead.\n */\n\n// ---------------------------------------------------------------------------\n// Client-synthesized codes. Distinct from T13's own three (`use-place-order.ts`) and from the\n// gateway's (`gateway.ts`) — these mean \"the client already knows this submission would be refused,\"\n// resolved before any request leaves the browser.\n// ---------------------------------------------------------------------------\n\nexport const PAYMENT_MISSING_DOCUMENT_CODE = 'MISSING_CARDHOLDER_DOCUMENT';\nexport const PAYMENT_INVALID_DOCUMENT_CODE = 'INVALID_CARDHOLDER_DOCUMENT';\nexport const PAYMENT_UNSAVED_BILLING_ADDRESS_CODE = 'UNSAVED_BILLING_ADDRESS';\n/**\n * T192 (issue 948): a document refusal while `CardholderDocument` renders nothing —\n * a method the card form cannot pay with, or a selection outside the section's `group` — so the\n * shopper is told to change the method, never to fill a field that is not on screen. The code and its\n * copy are provisional until Product answers T191's OQ-4; `PlaceOrder` authors the copy\n * (`unavailableMethodMessage`).\n */\nexport const PAYMENT_UNAVAILABLE_METHOD_CODE = 'UNAVAILABLE_PAYMENT_METHOD';\n\nconst MISSING_DOCUMENT_ERROR: PaymentUserError = {\n  code: PAYMENT_MISSING_DOCUMENT_CODE,\n  message: 'Enter your document before placing the order.',\n};\n\nconst INVALID_DOCUMENT_ERROR: PaymentUserError = {\n  code: PAYMENT_INVALID_DOCUMENT_CODE,\n  message: 'Enter a valid document before placing the order.',\n};\n\nconst UNSAVED_BILLING_ADDRESS_ERROR: PaymentUserError = {\n  code: PAYMENT_UNSAVED_BILLING_ADDRESS_CODE,\n  message: 'Save your billing address before placing the order.',\n};\n\nconst UNAVAILABLE_METHOD_ERROR: PaymentUserError = {\n  code: PAYMENT_UNAVAILABLE_METHOD_CODE,\n  message: 'Choose another payment method before placing the order.',\n};\n\n/**\n * Whether `CardholderDocument` renders for this selection (T192, Decision 3): the one definition, so\n * the field and the gate can never disagree about it. `selectedMethod` is the *scoped* one\n * `usePayment()` serves, so a selection outside `group` shows no field. Nothing shows while the card\n * payment is collapsed either (T191, FR-7), whatever the method's validator says. T42: the method must\n * ask for a document *and* the store's country must resolve to a document type\n * (`resolveCardholderDocument`).\n */\nexport function isCardholderDocumentShown({\n  cardPaymentCollapsed,\n  selectedMethod,\n  countryDocumentType,\n}: Readonly<{\n  cardPaymentCollapsed: boolean;\n  selectedMethod: PaymentSectionMethod | null;\n  countryDocumentType: DocumentType | null;\n}>): boolean {\n  return !cardPaymentCollapsed && resolveCardholderDocument({ method: selectedMethod, countryDocumentType }) !== null;\n}\n\n// ---------------------------------------------------------------------------\n// Refusal targets (T212)\n// ---------------------------------------------------------------------------\n\n/**\n * The element a refusal names, opaque to every reader outside `matter/payment/`: `PlaceOrder` hands it to\n * `focusRefusal` without ever spelling what it stands for, because `place-order.tsx` is scanned for\n * `CARD_FIELD_PATTERN` substrings (docs/features/credit-card-r2/rfc.md § D21). The literals are not part\n * of the contract.\n */\nexport type PaymentRefusalTarget = 'cardholder-field' | 'billing-form';\n\n/**\n * Which element a refusal asks the shopper to fix, or `null` when none can be named. Pure and total over\n * any `error.code`: only the gate's own three codes name a target, so a code a backend leg returned\n * verbatim, and `UNAVAILABLE_PAYMENT_METHOD` (no field to fix), move nothing.\n */\nexport function refusalTargetOf({ code }: PaymentUserError): PaymentRefusalTarget | null {\n  switch (code) {\n    case PAYMENT_MISSING_DOCUMENT_CODE:\n    case PAYMENT_INVALID_DOCUMENT_CODE:\n      return 'cardholder-field';\n    case PAYMENT_UNSAVED_BILLING_ADDRESS_CODE:\n      return 'billing-form';\n    default:\n      return null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// The resolver\n// ---------------------------------------------------------------------------\n\nexport type PaymentSubmitGateInput = Readonly<{\n  /**\n   * The selected method's `validator.documentRequired`; `false` when no method is resolved yet.\n   * `usePaymentSubmitGate()` resolves the method by `selectedMethodId` against `allMethods` — the\n   * section's *unscoped* list — never the group-scoped `selectedMethod` (finding S1; see that hook's\n   * own doc comment).\n   */\n  documentRequired: boolean;\n  /**\n   * The selected method's `validator.documentDisplayable`, resolved the same unscoped way; `false` when\n   * no method is resolved yet. Gates *both* document checks below (fix pass, findings R1/S4/S5 — one\n   * root cause, three symptoms): `draft.document` is a single fact with a single writer,\n   * `CardholderDocument.onValueChange` (`cardholder-document.tsx:111`). When the selected method's\n   * validator says the document is not displayable, `CardholderDocument` renders nothing for it\n   * (`cardholder-document.tsx:93`) — but nothing clears `draft.document` when that happens: not\n   * `CardholderDocument` unmounting, and not `selectMethod` (`use-payment-method-selection.ts`), which\n   * writes only `path`/`bin` from its input. So `draft.document` can still hold whatever the shopper\n   * typed for a *previously* selected, displayable method. Without this flag, a stale malformed value\n   * would refuse forever with no field left to fix it (R1: a mid-typing, not-yet-valid value survives a\n   * network-detection re-dispatch to a method that never shows the field; S5: any method whose validator\n   * pairs `documentRequired: true` with `documentDisplayable: false` is unconditionally unsatisfiable),\n   * and a stale *valid* value would silently vouch for a document the current method never collected\n   * (S4). Both are the same mistake: treating `draft.document` as meaningful when there is no field on\n   * screen for the shopper to read it from or correct it in. Neither check may run in that state —\n   * matching US-1's fourth criterion (\"the gate contributes nothing regardless of what `draft.document`\n   * holds\") generalized to every `documentRequired` value, not only `false`. This does not weaken the\n   * spec's own settled \"no `CardholderDocument` composed\" deadlock (its Risk R1, US-4 — a different R1\n   * than this fix pass's own): that case has `documentDisplayable: true` on the validator (the method\n   * genuinely calls for a document) with the leaf simply missing from the schema, so FR-1 still fires and\n   * still refuses with a console diagnostic.\n   */\n  documentDisplayable: boolean;\n  /**\n   * Whether `CardholderDocument` renders for this selection: `isCardholderDocumentShown(...)` over the\n   * *scoped* `selectedMethod` and `cardPaymentCollapsed` (T192, Decision 3). Never a trigger: the two\n   * unscoped flags above still decide whether the document refuses (S1). It decides only what the\n   * refusal says — the document codes when the field is on screen, `UNAVAILABLE_PAYMENT_METHOD` when it\n   * is not, since a shopper cannot fill a field that is not there (issue 948).\n   */\n  documentFieldShown: boolean;\n  /**\n   * The document type the field shows and the gate validates with (T42): the store country's type, `null`\n   * when the country resolves to none — then no document check runs and the gate never refuses on one,\n   * since no field exists for the shopper to fix.\n   */\n  documentType: DocumentType | null;\n  /** `draft.document` — the masked value `CardholderDocument` publishes on change. */\n  document: string | null;\n  /** `draft.billingAddressUnsaved`. */\n  billingAddressUnsaved: boolean | null;\n}>;\n\n/**\n * The document half of the gate: document-missing, then document-invalid, or `null`.\n *\n * FR-1/FR-3: emptiness is its own explicit check, never expressed through `isValidDocument` alone —\n * `isValidDocument('')` returns `true` by design (the document is optional in the general case), which\n * would otherwise silently let a required-but-blank document through. FR-2/Decision 6: validity is\n * checked whenever a value is present, independent of `documentRequired` — a malformed *optional*\n * document blocks too, matching the legacy's own unconditional `pattern`/`validate` rule. Decision 6's\n * own premise is a *displayable* field (a shopper who can see and fix what they typed); `documentDisplayable`\n * therefore gates FR-1 and FR-2 alike (findings R1/S4/S5).\n */\nfunction resolveDocumentRefusal({\n  documentRequired,\n  documentDisplayable,\n  documentType,\n  document,\n}: Pick<\n  PaymentSubmitGateInput,\n  'documentRequired' | 'documentDisplayable' | 'documentType' | 'document'\n>): PaymentUserError | null {\n  if (!documentDisplayable || documentType === null) return null;\n  if (documentRequired && (document?.trim() ?? '') === '') return MISSING_DOCUMENT_ERROR;\n  if (!isValidDocument(document ?? '', documentType)) return INVALID_DOCUMENT_ERROR;\n  return null;\n}\n\n/**\n * The whole gate: at most one refusal, resolved in a fixed order (FR-7) — the document slot\n * (document-missing, then document-invalid), then billing-unsaved. Pure — no hooks, no context, no DOM —\n * so the truth table is unit-testable without rendering, mirroring `card-entry.tsx`'s own exported\n * `isValidLuhn` / `isExpirationInFuture` convention.\n *\n * T192 (Decision 2): the document slot refuses in exactly the states it always did, and `documentFieldShown`\n * changes only its code — `UNAVAILABLE_PAYMENT_METHOD` instead of a document code while `CardholderDocument`\n * renders nothing (INV-1, INV-2). The billing check is unchanged.\n */\nexport function resolvePaymentSubmitGate({\n  documentRequired,\n  documentDisplayable,\n  documentFieldShown,\n  documentType,\n  document,\n  billingAddressUnsaved,\n}: PaymentSubmitGateInput): PaymentUserError | null {\n  const documentRefusal = resolveDocumentRefusal({ documentRequired, documentDisplayable, documentType, document });\n  if (documentRefusal) {\n    return documentFieldShown ? documentRefusal : UNAVAILABLE_METHOD_ERROR;\n  }\n\n  if (billingAddressUnsaved) {\n    return UNSAVED_BILLING_ADDRESS_ERROR;\n  }\n\n  return null;\n}\n\n/**\n * Reads `usePayment()` and resolves the gate, memoized on the primitives — never on the `draft` object\n * itself (NFR-3): `draft`'s identity changes on every card-number keystroke (`setDraftBin`), and this\n * must not re-run the document check on each one.\n *\n * Resolves the validator by looking `persistedMethodId` up against `allMethods` — the section's\n * *unscoped* fact and *unscoped* method list — rather than the group-scoped `selectedMethod` /\n * `selectedMethodId` `usePayment()` also exposes (T74, Decision 4/7: the ones `CardholderDocument`/\n * `CardEntry` render from). Fix pass, finding S1, carried forward by T74's contract split:\n * `usePlaceOrder`'s own pre-flight (`sdk/payment/use-place-order.ts`) resolves *its* `selectedMethod`\n * the same unscoped way, off its own independent fragment slice (Decision 2 forbids either hook from\n * reading the other's module). Resolving off the scoped `selectedMethodId` here would silently degrade\n * `documentRequired` to `false` whenever the persisted selection's `groupName` sits outside this root's\n * configured `group` set — no attacker needed, just a store whose real credit- or debit-card group name\n * differs from the hardcoded defaults (`payment.tsx`'s `DEFAULT_METHOD_GROUP`, now two groups rather than\n * one) — while `usePlaceOrder` still finds the method by id alone and opens a transaction. Matching\n * `usePlaceOrder`'s own by-id lookup keeps the two\n * in agreement for every method actually reachable through this root, which is the one thing\n * `usePaymentSubmitGate` and `usePlaceOrder` can never be allowed to disagree about.\n *\n * T192 (issue 948): the scoped `selectedMethod` and `cardPaymentCollapsed` are read for one fact only,\n * `documentFieldShown`, through the same `isCardholderDocumentShown` `CardholderDocument` renders by.\n * It never decides whether the gate refuses — only whether a refusal may name the document.\n */\nexport function usePaymentSubmitGate(): PaymentUserError | null {\n  const { persistedMethodId, allMethods, selectedMethod, cardPaymentCollapsed, countryDocumentType, draft } =\n    usePayment();\n  const resolvedMethod = useMemo(\n    () => allMethods.find((method) => method.id === persistedMethodId) ?? null,\n    [allMethods, persistedMethodId],\n  );\n  // T42: the same rule the field renders by, over the same unscoped method this gate always read. A\n  // country with no document type yields `null`: no check runs and nothing refuses (Decision 7).\n  const documentRule = resolveCardholderDocument({ method: resolvedMethod, countryDocumentType });\n  const documentRequired = documentRule?.required ?? false;\n  const documentDisplayable = documentRule !== null;\n  const documentType = documentRule?.type ?? null;\n  const documentFieldShown = isCardholderDocumentShown({ cardPaymentCollapsed, selectedMethod, countryDocumentType });\n  const { document, billingAddressUnsaved } = draft;\n\n  return useMemo(\n    () =>\n      resolvePaymentSubmitGate({\n        documentRequired,\n        documentDisplayable,\n        documentFieldShown,\n        documentType,\n        document,\n        billingAddressUnsaved,\n      }),\n    [documentRequired, documentDisplayable, documentFieldShown, documentType, document, billingAddressUnsaved],\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA8BA,MAAa,gCAAgC;AAC7C,MAAa,gCAAgC;AAC7C,MAAa,uCAAuC;;;;;;;;AAQpD,MAAa,kCAAkC;AAE/C,MAAM,yBAA2C;CAC/C,MAAM;CACN,SAAS;AACX;AAEA,MAAM,yBAA2C;CAC/C,MAAM;CACN,SAAS;AACX;AAEA,MAAM,gCAAkD;CACtD,MAAM;CACN,SAAS;AACX;AAEA,MAAM,2BAA6C;CACjD,MAAM;CACN,SAAS;AACX;;;;;;;;;AAUA,SAAgB,0BAA0B,EACxC,sBACA,gBACA,uBAKW;CACX,OAAO,CAAC,wBAAwB,0BAA0B;EAAE,QAAQ;EAAgB;CAAoB,CAAC,MAAM;AACjH;;;;;;AAmBA,SAAgB,gBAAgB,EAAE,QAAuD;CACvF,QAAQ,MAAR;EACE,KAAK;EACL,KAAK,+BACH,OAAO;EACT,KAAK,sCACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;;;;;;;AAqEA,SAAS,uBAAuB,EAC9B,kBACA,qBACA,cACA,YAI0B;CAC1B,IAAI,CAAC,uBAAuB,iBAAiB,MAAM,OAAO;CAC1D,IAAI,qBAAqB,UAAU,KAAK,KAAK,QAAQ,IAAI,OAAO;CAChE,IAAI,CAAC,gBAAgB,YAAY,IAAI,YAAY,GAAG,OAAO;CAC3D,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,yBAAyB,EACvC,kBACA,qBACA,oBACA,cACA,UACA,yBACkD;CAClD,MAAM,kBAAkB,uBAAuB;EAAE;EAAkB;EAAqB;EAAc;CAAS,CAAC;CAChH,IAAI,iBACF,OAAO,qBAAqB,kBAAkB;CAGhD,IAAI,uBACF,OAAO;CAGT,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,uBAAgD;CAC9D,MAAM,EAAE,mBAAmB,YAAY,gBAAgB,sBAAsB,qBAAqB,UAChG,WAAW;CACb,MAAM,iBAAiB,cACf,WAAW,MAAM,WAAW,OAAO,OAAO,iBAAiB,KAAK,MACtE,CAAC,YAAY,iBAAiB,CAChC;CAGA,MAAM,eAAe,0BAA0B;EAAE,QAAQ;EAAgB;CAAoB,CAAC;CAC9F,MAAM,mBAAmB,cAAc,YAAY;CACnD,MAAM,sBAAsB,iBAAiB;CAC7C,MAAM,eAAe,cAAc,QAAQ;CAC3C,MAAM,qBAAqB,0BAA0B;EAAE;EAAsB;EAAgB;CAAoB,CAAC;CAClH,MAAM,EAAE,UAAU,0BAA0B;CAE5C,OAAO,cAEH,yBAAyB;EACvB;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,GACH;EAAC;EAAkB;EAAqB;EAAoB;EAAc;EAAU;CAAqB,CAC3G;AACF"}
+{"version":3,"file":"use-payment-submit-gate.js","names":[],"sources":["../../../src/matter/payment/use-payment-submit-gate.ts"],"sourcesContent":["'use client';\n\nimport { useMemo } from 'react';\nimport { type DocumentType, isValidDocument } from '../../particles/document-field/document-field.js';\nimport type { PaymentUserError } from '../../sdk/payment/operations.js';\nimport { resolveCardholderDocument } from './cardholder-document-rule.js';\nimport { type PaymentClientProfile, usePayment } from './payment.js';\nimport type { PaymentSectionMethod } from './use-payment-method-selection.js';\n\n/**\n * The submit gate (specs/cardholder-document-submit-gate.md, T24 of the Credit Card epic;\n * docs/features/credit-card/rfc.md § D3, D6). One pure resolver covering the two facts T11's own\n * deferral asked to ship together: a required-but-missing-or-malformed cardholder document, and a\n * declined \"same as delivery\" billing address with nothing persisted yet. `PlaceOrder` (T14) reads the\n * verdict through `usePaymentSubmitGate()` below and forwards it into `usePlaceOrder`'s (T13)\n * pre-flight, which refuses on it before `startTransaction` ever opens a transaction the client already\n * knows it cannot complete.\n *\n * **Only the verdict crosses into `sdk/payment/`.** `usePlaceOrder` never learns *why* it refused —\n * only this opaque `PaymentUserError` — because `sdk/payment/use-place-order.ts` may name no identifier\n * matching `CARD_FIELD_PATTERN` (`sdk/payment/card-field-pattern.ts`), which includes `document`. Every\n * fact the gate reads, and the four codes below, live here in `matter/payment/` instead.\n */\n\n// ---------------------------------------------------------------------------\n// Client-synthesized codes. Distinct from T13's own three (`use-place-order.ts`) and from the\n// gateway's (`gateway.ts`) — these mean \"the client already knows this submission would be refused,\"\n// resolved before any request leaves the browser.\n// ---------------------------------------------------------------------------\n\nexport const PAYMENT_MISSING_DOCUMENT_CODE = 'MISSING_CARDHOLDER_DOCUMENT';\nexport const PAYMENT_INVALID_DOCUMENT_CODE = 'INVALID_CARDHOLDER_DOCUMENT';\nexport const PAYMENT_UNSAVED_BILLING_ADDRESS_CODE = 'UNSAVED_BILLING_ADDRESS';\n/** The cart's profile lacks a first or last name: VTEX refuses the order with `ORD007`. */\nexport const PAYMENT_MISSING_PROFILE_NAME_CODE = 'MISSING_PROFILE_NAME';\n/** The cart's profile lacks a phone: VTEX refuses the order with `ORD007`, in every country measured. */\nexport const PAYMENT_MISSING_PROFILE_PHONE_CODE = 'MISSING_PROFILE_PHONE';\n/**\n * T192 (issue 948): a document refusal while `CardholderDocument` renders nothing —\n * a method the card form cannot pay with, or a selection outside the section's `group` — so the\n * shopper is told to change the method, never to fill a field that is not on screen. The code and its\n * copy are provisional until Product answers T191's OQ-4; `PlaceOrder` authors the copy\n * (`unavailableMethodMessage`).\n */\nexport const PAYMENT_UNAVAILABLE_METHOD_CODE = 'UNAVAILABLE_PAYMENT_METHOD';\n\n// The `message` of each error below is diagnostic (logs, `onResult`); `PlaceOrder` words the code.\nconst MISSING_DOCUMENT_ERROR: PaymentUserError = {\n  code: PAYMENT_MISSING_DOCUMENT_CODE,\n  message: 'Enter your document before placing the order.',\n};\n\nconst INVALID_DOCUMENT_ERROR: PaymentUserError = {\n  code: PAYMENT_INVALID_DOCUMENT_CODE,\n  message: 'Enter a valid document before placing the order.',\n};\n\nconst UNSAVED_BILLING_ADDRESS_ERROR: PaymentUserError = {\n  code: PAYMENT_UNSAVED_BILLING_ADDRESS_CODE,\n  message: 'Save your billing address before placing the order.',\n};\n\nconst MISSING_PROFILE_NAME_ERROR: PaymentUserError = {\n  code: PAYMENT_MISSING_PROFILE_NAME_CODE,\n  message: 'Enter your first and last name before placing the order.',\n};\n\nconst MISSING_PROFILE_PHONE_ERROR: PaymentUserError = {\n  code: PAYMENT_MISSING_PROFILE_PHONE_CODE,\n  message: 'Enter your phone number before placing the order.',\n};\n\nconst UNAVAILABLE_METHOD_ERROR: PaymentUserError = {\n  code: PAYMENT_UNAVAILABLE_METHOD_CODE,\n  message: 'Choose another payment method before placing the order.',\n};\n\n/**\n * Whether `CardholderDocument` renders for this selection (T192, Decision 3): the one definition, so\n * the field and the gate can never disagree about it. `selectedMethod` is the *scoped* one\n * `usePayment()` serves, so a selection outside `group` shows no field. Nothing shows while the card\n * payment is collapsed either (T191, FR-7), whatever the method's validator says. T42: the method must\n * ask for a document *and* the store's country must resolve to a document type\n * (`resolveCardholderDocument`).\n */\nexport function isCardholderDocumentShown({\n  cardPaymentCollapsed,\n  selectedMethod,\n  countryDocumentType,\n}: Readonly<{\n  cardPaymentCollapsed: boolean;\n  selectedMethod: PaymentSectionMethod | null;\n  countryDocumentType: DocumentType | null;\n}>): boolean {\n  return !cardPaymentCollapsed && resolveCardholderDocument({ method: selectedMethod, countryDocumentType }) !== null;\n}\n\n// ---------------------------------------------------------------------------\n// Refusal targets (T212)\n// ---------------------------------------------------------------------------\n\n/**\n * The element a refusal names, opaque to every reader outside `matter/payment/`: `PlaceOrder` hands it to\n * `focusRefusal` without ever spelling what it stands for, because `place-order.tsx` is scanned for\n * `CARD_FIELD_PATTERN` substrings (docs/features/credit-card-r2/rfc.md § D21). The literals are not part\n * of the contract.\n */\nexport type PaymentRefusalTarget = 'cardholder-field' | 'billing-form';\n\n/**\n * Which element a refusal asks the shopper to fix, or `null` when none can be named. Pure and total over\n * any `error.code`: only the gate's own three codes name a target, so a code a backend leg returned\n * verbatim, and `UNAVAILABLE_PAYMENT_METHOD` (no field to fix), move nothing.\n */\nexport function refusalTargetOf({ code }: PaymentUserError): PaymentRefusalTarget | null {\n  switch (code) {\n    case PAYMENT_MISSING_DOCUMENT_CODE:\n    case PAYMENT_INVALID_DOCUMENT_CODE:\n      return 'cardholder-field';\n    case PAYMENT_UNSAVED_BILLING_ADDRESS_CODE:\n      return 'billing-form';\n    default:\n      return null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// The resolver\n// ---------------------------------------------------------------------------\n\nexport type PaymentSubmitGateInput = Readonly<{\n  /**\n   * The selected method's `validator.documentRequired`; `false` when no method is resolved yet.\n   * `usePaymentSubmitGate()` resolves the method by `selectedMethodId` against `allMethods` — the\n   * section's *unscoped* list — never the group-scoped `selectedMethod` (finding S1; see that hook's\n   * own doc comment).\n   */\n  documentRequired: boolean;\n  /**\n   * The selected method's `validator.documentDisplayable`, resolved the same unscoped way; `false` when\n   * no method is resolved yet. Gates *both* document checks below (fix pass, findings R1/S4/S5 — one\n   * root cause, three symptoms): `draft.document` is a single fact with a single writer,\n   * `CardholderDocument.onValueChange` (`cardholder-document.tsx:111`). When the selected method's\n   * validator says the document is not displayable, `CardholderDocument` renders nothing for it\n   * (`cardholder-document.tsx:93`) — but nothing clears `draft.document` when that happens: not\n   * `CardholderDocument` unmounting, and not `selectMethod` (`use-payment-method-selection.ts`), which\n   * writes only `path`/`bin` from its input. So `draft.document` can still hold whatever the shopper\n   * typed for a *previously* selected, displayable method. Without this flag, a stale malformed value\n   * would refuse forever with no field left to fix it (R1: a mid-typing, not-yet-valid value survives a\n   * network-detection re-dispatch to a method that never shows the field; S5: any method whose validator\n   * pairs `documentRequired: true` with `documentDisplayable: false` is unconditionally unsatisfiable),\n   * and a stale *valid* value would silently vouch for a document the current method never collected\n   * (S4). Both are the same mistake: treating `draft.document` as meaningful when there is no field on\n   * screen for the shopper to read it from or correct it in. Neither check may run in that state —\n   * matching US-1's fourth criterion (\"the gate contributes nothing regardless of what `draft.document`\n   * holds\") generalized to every `documentRequired` value, not only `false`. This does not weaken the\n   * spec's own settled \"no `CardholderDocument` composed\" deadlock (its Risk R1, US-4 — a different R1\n   * than this fix pass's own): that case has `documentDisplayable: true` on the validator (the method\n   * genuinely calls for a document) with the leaf simply missing from the schema, so FR-1 still fires and\n   * still refuses with a console diagnostic.\n   */\n  documentDisplayable: boolean;\n  /**\n   * Whether `CardholderDocument` renders for this selection: `isCardholderDocumentShown(...)` over the\n   * *scoped* `selectedMethod` and `cardPaymentCollapsed` (T192, Decision 3). Never a trigger: the two\n   * unscoped flags above still decide whether the document refuses (S1). It decides only what the\n   * refusal says — the document codes when the field is on screen, `UNAVAILABLE_PAYMENT_METHOD` when it\n   * is not, since a shopper cannot fill a field that is not there (issue 948).\n   */\n  documentFieldShown: boolean;\n  /**\n   * The document type the field shows and the gate validates with (T42): the store country's type, `null`\n   * when the country resolves to none — then no document check runs and the gate never refuses on one,\n   * since no field exists for the shopper to fix.\n   */\n  documentType: DocumentType | null;\n  /** `draft.document` — the masked value `CardholderDocument` publishes on change. */\n  document: string | null;\n  /** `draft.billingAddressUnsaved`. */\n  billingAddressUnsaved: boolean | null;\n  /**\n   * The cart's profile. Absent (`undefined` or `null`) means it was not read, and the profile slot\n   * never refuses. A present object counts as read, even with every field `null`: the content of a\n   * profile cannot tell \"not yet read\" from \"read and empty\".\n   */\n  profile?: PaymentClientProfile | null;\n}>;\n\nfunction isBlank(value: string | null | undefined): boolean {\n  return (value?.trim() ?? '') === '';\n}\n\n/**\n * The profile half of the gate: a missing name, then a missing phone, or `null`. VTEX refuses the\n * order at `startTransaction` with `ORD007` for each of the three, in every country measured, so no\n * country is consulted.\n */\nfunction resolveProfileRefusal({ profile }: Pick<PaymentSubmitGateInput, 'profile'>): PaymentUserError | null {\n  if (!profile) return null;\n  if (isBlank(profile.firstName) || isBlank(profile.lastName)) return MISSING_PROFILE_NAME_ERROR;\n  if (isBlank(profile.phone)) return MISSING_PROFILE_PHONE_ERROR;\n  return null;\n}\n\n/**\n * The document half of the gate: document-missing, then document-invalid, or `null`.\n *\n * FR-1/FR-3: emptiness is its own explicit check, never expressed through `isValidDocument` alone —\n * `isValidDocument('')` returns `true` by design (the document is optional in the general case), which\n * would otherwise silently let a required-but-blank document through. FR-2/Decision 6: validity is\n * checked whenever a value is present, independent of `documentRequired` — a malformed *optional*\n * document blocks too, matching the legacy's own unconditional `pattern`/`validate` rule. Decision 6's\n * own premise is a *displayable* field (a shopper who can see and fix what they typed); `documentDisplayable`\n * therefore gates FR-1 and FR-2 alike (findings R1/S4/S5).\n */\nfunction resolveDocumentRefusal({\n  documentRequired,\n  documentDisplayable,\n  documentType,\n  document,\n}: Pick<\n  PaymentSubmitGateInput,\n  'documentRequired' | 'documentDisplayable' | 'documentType' | 'document'\n>): PaymentUserError | null {\n  if (!documentDisplayable || documentType === null) return null;\n  if (documentRequired && (document?.trim() ?? '') === '') return MISSING_DOCUMENT_ERROR;\n  if (!isValidDocument(document ?? '', documentType)) return INVALID_DOCUMENT_ERROR;\n  return null;\n}\n\n/**\n * The whole gate: at most one refusal, resolved in a fixed order (FR-7) — the document slot\n * (document-missing, then document-invalid), then billing-unsaved, then the profile. Pure — no hooks, no\n * context, no DOM — so the truth table is unit-testable without rendering, mirroring `card-entry.tsx`'s own exported\n * `isValidLuhn` / `isExpirationInFuture` convention.\n *\n * T192 (Decision 2): the document slot refuses in exactly the states it always did, and `documentFieldShown`\n * changes only its code — `UNAVAILABLE_PAYMENT_METHOD` instead of a document code while `CardholderDocument`\n * renders nothing (INV-1, INV-2). The billing check is unchanged.\n */\nexport function resolvePaymentSubmitGate({\n  documentRequired,\n  documentDisplayable,\n  documentFieldShown,\n  documentType,\n  document,\n  billingAddressUnsaved,\n  profile,\n}: PaymentSubmitGateInput): PaymentUserError | null {\n  const documentRefusal = resolveDocumentRefusal({ documentRequired, documentDisplayable, documentType, document });\n  if (documentRefusal) {\n    return documentFieldShown ? documentRefusal : UNAVAILABLE_METHOD_ERROR;\n  }\n\n  if (billingAddressUnsaved) {\n    return UNSAVED_BILLING_ADDRESS_ERROR;\n  }\n\n  return resolveProfileRefusal({ profile });\n}\n\n/**\n * Reads `usePayment()` and resolves the gate, memoized on the primitives — never on the `draft` object\n * itself (NFR-3): `draft`'s identity changes on every card-number keystroke (`setDraftBin`), and this\n * must not re-run the document check on each one.\n *\n * Resolves the validator by looking `persistedMethodId` up against `allMethods` — the section's\n * *unscoped* fact and *unscoped* method list — rather than the group-scoped `selectedMethod` /\n * `selectedMethodId` `usePayment()` also exposes (T74, Decision 4/7: the ones `CardholderDocument`/\n * `CardEntry` render from). Fix pass, finding S1, carried forward by T74's contract split:\n * `usePlaceOrder`'s own pre-flight (`sdk/payment/use-place-order.ts`) resolves *its* `selectedMethod`\n * the same unscoped way, off its own independent fragment slice (Decision 2 forbids either hook from\n * reading the other's module). Resolving off the scoped `selectedMethodId` here would silently degrade\n * `documentRequired` to `false` whenever the persisted selection's `groupName` sits outside this root's\n * configured `group` set — no attacker needed, just a store whose real credit- or debit-card group name\n * differs from the hardcoded defaults (`payment.tsx`'s `DEFAULT_METHOD_GROUP`, now two groups rather than\n * one) — while `usePlaceOrder` still finds the method by id alone and opens a transaction. Matching\n * `usePlaceOrder`'s own by-id lookup keeps the two\n * in agreement for every method actually reachable through this root, which is the one thing\n * `usePaymentSubmitGate` and `usePlaceOrder` can never be allowed to disagree about.\n *\n * T192 (issue 948): the scoped `selectedMethod` and `cardPaymentCollapsed` are read for one fact only,\n * `documentFieldShown`, through the same `isCardholderDocumentShown` `CardholderDocument` renders by.\n * It never decides whether the gate refuses — only whether a refusal may name the document.\n */\nexport function usePaymentSubmitGate(): PaymentUserError | null {\n  const {\n    persistedMethodId,\n    allMethods,\n    selectedMethod,\n    cardPaymentCollapsed,\n    countryDocumentType,\n    draft,\n    clientProfile,\n  } = usePayment();\n  const resolvedMethod = useMemo(\n    () => allMethods.find((method) => method.id === persistedMethodId) ?? null,\n    [allMethods, persistedMethodId],\n  );\n  // T42: the same rule the field renders by, over the same unscoped method this gate always read. A\n  // country with no document type yields `null`: no check runs and nothing refuses (Decision 7).\n  const documentRule = resolveCardholderDocument({ method: resolvedMethod, countryDocumentType });\n  const documentRequired = documentRule?.required ?? false;\n  const documentDisplayable = documentRule !== null;\n  const documentType = documentRule?.type ?? null;\n  const documentFieldShown = isCardholderDocumentShown({ cardPaymentCollapsed, selectedMethod, countryDocumentType });\n  const { document, billingAddressUnsaved } = draft;\n  // Primitives only, like the document facts. `profileRead` is part of the key because a present profile\n  // with every field `null` refuses and an absent one does not: the three fields alone cannot tell them apart.\n  const profileRead = clientProfile != null;\n  const firstName = clientProfile?.firstName ?? null;\n  const lastName = clientProfile?.lastName ?? null;\n  const phone = clientProfile?.phone ?? null;\n\n  return useMemo(\n    () =>\n      resolvePaymentSubmitGate({\n        documentRequired,\n        documentDisplayable,\n        documentFieldShown,\n        documentType,\n        document,\n        billingAddressUnsaved,\n        profile: profileRead ? { firstName, lastName, phone } : null,\n      }),\n    [\n      documentRequired,\n      documentDisplayable,\n      documentFieldShown,\n      documentType,\n      document,\n      billingAddressUnsaved,\n      profileRead,\n      firstName,\n      lastName,\n      phone,\n    ],\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA8BA,MAAa,gCAAgC;AAC7C,MAAa,gCAAgC;AAC7C,MAAa,uCAAuC;;AAEpD,MAAa,oCAAoC;;AAEjD,MAAa,qCAAqC;;;;;;;;AAQlD,MAAa,kCAAkC;AAG/C,MAAM,yBAA2C;CAC/C,MAAM;CACN,SAAS;AACX;AAEA,MAAM,yBAA2C;CAC/C,MAAM;CACN,SAAS;AACX;AAEA,MAAM,gCAAkD;CACtD,MAAM;CACN,SAAS;AACX;AAEA,MAAM,6BAA+C;CACnD,MAAM;CACN,SAAS;AACX;AAEA,MAAM,8BAAgD;CACpD,MAAM;CACN,SAAS;AACX;AAEA,MAAM,2BAA6C;CACjD,MAAM;CACN,SAAS;AACX;;;;;;;;;AAUA,SAAgB,0BAA0B,EACxC,sBACA,gBACA,uBAKW;CACX,OAAO,CAAC,wBAAwB,0BAA0B;EAAE,QAAQ;EAAgB;CAAoB,CAAC,MAAM;AACjH;;;;;;AAmBA,SAAgB,gBAAgB,EAAE,QAAuD;CACvF,QAAQ,MAAR;EACE,KAAK;EACL,KAAK,+BACH,OAAO;EACT,KAAK,sCACH,OAAO;EACT,SACE,OAAO;CACX;AACF;AAgEA,SAAS,QAAQ,OAA2C;CAC1D,QAAQ,OAAO,KAAK,KAAK,QAAQ;AACnC;;;;;;AAOA,SAAS,sBAAsB,EAAE,WAA6E;CAC5G,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,QAAQ,SAAS,KAAK,QAAQ,QAAQ,QAAQ,GAAG,OAAO;CACpE,IAAI,QAAQ,QAAQ,KAAK,GAAG,OAAO;CACnC,OAAO;AACT;;;;;;;;;;;;AAaA,SAAS,uBAAuB,EAC9B,kBACA,qBACA,cACA,YAI0B;CAC1B,IAAI,CAAC,uBAAuB,iBAAiB,MAAM,OAAO;CAC1D,IAAI,qBAAqB,UAAU,KAAK,KAAK,QAAQ,IAAI,OAAO;CAChE,IAAI,CAAC,gBAAgB,YAAY,IAAI,YAAY,GAAG,OAAO;CAC3D,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,yBAAyB,EACvC,kBACA,qBACA,oBACA,cACA,UACA,uBACA,WACkD;CAClD,MAAM,kBAAkB,uBAAuB;EAAE;EAAkB;EAAqB;EAAc;CAAS,CAAC;CAChH,IAAI,iBACF,OAAO,qBAAqB,kBAAkB;CAGhD,IAAI,uBACF,OAAO;CAGT,OAAO,sBAAsB,EAAE,QAAQ,CAAC;AAC1C;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,uBAAgD;CAC9D,MAAM,EACJ,mBACA,YACA,gBACA,sBACA,qBACA,OACA,kBACE,WAAW;CACf,MAAM,iBAAiB,cACf,WAAW,MAAM,WAAW,OAAO,OAAO,iBAAiB,KAAK,MACtE,CAAC,YAAY,iBAAiB,CAChC;CAGA,MAAM,eAAe,0BAA0B;EAAE,QAAQ;EAAgB;CAAoB,CAAC;CAC9F,MAAM,mBAAmB,cAAc,YAAY;CACnD,MAAM,sBAAsB,iBAAiB;CAC7C,MAAM,eAAe,cAAc,QAAQ;CAC3C,MAAM,qBAAqB,0BAA0B;EAAE;EAAsB;EAAgB;CAAoB,CAAC;CAClH,MAAM,EAAE,UAAU,0BAA0B;CAG5C,MAAM,cAAc,iBAAiB;CACrC,MAAM,YAAY,eAAe,aAAa;CAC9C,MAAM,WAAW,eAAe,YAAY;CAC5C,MAAM,QAAQ,eAAe,SAAS;CAEtC,OAAO,cAEH,yBAAyB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA,SAAS,cAAc;GAAE;GAAW;GAAU;EAAM,IAAI;CAC1D,CAAC,GACH;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CACF;AACF"}

package/dist/matter/place-order/place-order.d.ts

@@ -1,3 +1,4 @@
+import { ContentValue, MessageLocaleProp } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import { PageRef } from "../../sdk/navigation/types.js";
@@ -6,74 +7,187 @@ import { ComponentActions } from "../../sdk/actions/types.js";
 import { PlaceOrderData } from "../../sdk/payment/use-place-order.js";
 import { ComponentPropsWithRef } from "react";
 //#region src/matter/place-order/place-order.d.ts
-export type PlaceOrderProps = ComponentPropsWithRef<'div'> & {
-  /** CTA label while idle. */
-  label?: string;
-  /** CTA label while the three-call sequence is in flight. */
-  placingLabel?: string;
-  /** Status message shown beside the button for as long as the order is being placed. Absent or blank renders nothing. */
-  placingMessage?: string;
-  /**
-   * CTA label while a surviving attempt (T29) offers a resume — the card already left the browser
-   * (`sent`) or its fate is unknown (`unresolved`), and the next click finalizes it rather than running
-   * the full sequence again. Shown instead of `label`, never alongside `placingLabel` (mutually
-   * exclusive — `placing` takes priority whenever both could apply).
-   */
-  resumeLabel?: string;
-  /** Inline message shown once the sequence has settled with no `userErrors`. */
-  successMessage?: string;
-  /** Shown when `placeOrder()` is invoked with no registered submission for the current path. */
-  missingSubmissionMessage?: string;
-  /** Shown when no payment method is selected yet. */
-  missingMethodMessage?: string;
-  /** Shown when `startTransaction` resolves incomplete transaction data. */
-  invalidTransactionMessage?: string;
-  /** Shown for an infrastructure-level failure reaching the payment gateway action. */
-  networkErrorMessage?: string;
-  /** Shown when the selected method requires a cardholder document and none is set. */
-  missingDocumentMessage?: string;
-  /** Shown when the typed cardholder document fails validation. */
-  invalidDocumentMessage?: string;
-  /**
-   * Shown instead of the two document messages above when the selected method calls for a cardholder
-   * document the page is not showing — a method the card form cannot pay with, or one outside the
-   * section's `group` — so the shopper has to choose another payment method (T192).
-   */
-  unavailableMethodMessage?: string;
-  /** Shown when the shopper declined "same as delivery" but never saved a billing address. */
-  unsavedBillingAddressMessage?: string;
-  /** Shown when the new-card draft itself fails validation before ever reaching the gateway. */
-  invalidCardDataMessage?: string;
-  /** Shown when the typed card number is well-formed but no payment network the store accepts claims it (T47). */
-  unsupportedNetworkMessage?: string;
-  /** Shown when a saved-card submission is refused for a missing or invalid CVV. */
-  invalidSecurityCodeMessage?: string;
-  /** Shown when the payment gateway itself refuses the submitted card. */
-  gatewayErrorMessage?: string;
-  /**
-   * Shown when a click lands on an order-placement attempt whose own sequence is still running — a
-   * transaction this instance did not open, and which nothing here may finalize or re-run (T170).
-   */
-  inFlightMessage?: string;
-  /**
-   * Shown when the payment was handed to the gateway but the order could not be confirmed, so it may still be
-   * processing (T176). Rendered as a status, never as the error alert.
-   */
-  unconfirmedMessage?: string;
+export type PlaceOrderProps = ComponentPropsWithRef<'div'> & MessageLocaleProp & {
   /**
    * Where the shopper lands after a successful placement. A page reference gets the placed order's
-   * group as its `orderGroup` param. A string is a logical path of this store, navigated as written;
-   * an absolute, protocol-relative, or non-http(s) value, or a `{orderGroup}` template, is refused
+   * Node id as its `orderId` param. A string is a logical path of this store, navigated as written;
+   * an absolute, protocol-relative, or non-http(s) value, or a `{orderId}` template, is refused
    * rather than navigated to (fail closed, dev-only warn).
    * e.g. `{ standard: 'order-placed' }`
    */
   successHref?: PageRef | string;
+  /**
+   * The page the bank sends the shopper back to after a 3D Secure challenge, a page of this store that
+   * composes `ChallengeReturn`. A page reference only: a string, or a page the route map does not hold, is
+   * refused with a dev-only warning, since the return URL is built from the page's public path. No default:
+   * a store that authors none keeps the refusal a challenge answer gets today, with no redirect.
+   * e.g. `{ page: 'checkout-challenge-return' }`
+   */
+  challengeReturnHref?: PageRef;
   /** `Payment` slice forwarded by the reactive runtime (arity-1, ADR-0015) — `null` until it resolves. */
   $data?: PlaceOrderData;
   /** Compiler-injected action surface; carries `payment.startTransaction`, `payment.gatewayCallback`, `analytics.track`. */
   $actions?: ComponentActions;
+  /** The button labels, the message while placing, the success message and the message for each refusal code this CTA words. */
+  $content?: ContentValue<typeof PlaceOrderContent>;
+};
+export declare const PlaceOrderContent: {
+  readonly id: "place-order";
+  readonly title: "Place Order";
+  readonly description: "The place-order button labels, the message while placing, the success message, and the message for each refusal it words.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly label: {
+        readonly type: "string";
+        readonly title: "Button label";
+        readonly format: "icu-message";
+        readonly messageSource: "Place order";
+      };
+      readonly placingLabel: {
+        readonly type: "string";
+        readonly title: "Button label while placing";
+        readonly format: "icu-message";
+        readonly messageSource: "Placing order...";
+      };
+      readonly placingMessage: {
+        readonly type: "string";
+        readonly title: "Message while placing";
+        readonly format: "icu-message";
+        readonly messageSource: "Processing your payment. Please keep this page open.";
+        readonly messageOptional: true;
+      };
+      readonly resumeLabel: {
+        readonly type: "string";
+        readonly title: "Button label while a surviving attempt offers a resume";
+        readonly format: "icu-message";
+        readonly messageSource: "Complete your order";
+      };
+      readonly successMessage: {
+        readonly type: "string";
+        readonly title: "Success message";
+        readonly format: "icu-message";
+        readonly messageSource: "Order placed successfully.";
+      };
+      readonly missingSubmissionMessage: {
+        readonly type: "string";
+        readonly title: "Missing payment submission message";
+        readonly format: "icu-message";
+        readonly messageSource: "Enter your payment details before placing the order.";
+      };
+      readonly missingMethodMessage: {
+        readonly type: "string";
+        readonly title: "Missing payment method message";
+        readonly format: "icu-message";
+        readonly messageSource: "Choose a payment method before placing the order.";
+      };
+      readonly invalidTransactionMessage: {
+        readonly type: "string";
+        readonly title: "Invalid transaction message";
+        readonly format: "icu-message";
+        readonly messageSource: "Unable to start the payment. Please try again.";
+      };
+      readonly networkErrorMessage: {
+        readonly type: "string";
+        readonly title: "Network error message";
+        readonly format: "icu-message";
+        readonly messageSource: "Unable to complete the request. Please try again.";
+      };
+      readonly missingDocumentMessage: {
+        readonly type: "string";
+        readonly title: "Missing document message";
+        readonly format: "icu-message";
+        readonly messageSource: "Enter your document before placing the order.";
+      };
+      readonly invalidDocumentMessage: {
+        readonly type: "string";
+        readonly title: "Invalid document message";
+        readonly format: "icu-message";
+        readonly messageSource: "Enter a valid document before placing the order.";
+      };
+      readonly unavailableMethodMessage: {
+        readonly type: "string";
+        readonly title: "Unavailable payment method message";
+        readonly format: "icu-message";
+        readonly messageSource: "Choose another payment method before placing the order.";
+      };
+      readonly unsavedBillingAddressMessage: {
+        readonly type: "string";
+        readonly title: "Unsaved billing address message";
+        readonly format: "icu-message";
+        readonly messageSource: "Save your billing address before placing the order.";
+      };
+      readonly missingProfileNameMessage: {
+        readonly type: "string";
+        readonly title: "Missing name message";
+        readonly format: "icu-message";
+        readonly messageSource: "Enter your first and last name before placing the order.";
+      };
+      readonly missingProfilePhoneMessage: {
+        readonly type: "string";
+        readonly title: "Missing phone message";
+        readonly format: "icu-message";
+        readonly messageSource: "Enter your phone number before placing the order.";
+      };
+      readonly invalidCardDataMessage: {
+        readonly type: "string";
+        readonly title: "Invalid card data message";
+        readonly format: "icu-message";
+        readonly messageSource: "Enter valid card details before placing the order.";
+      };
+      readonly unsupportedNetworkMessage: {
+        readonly type: "string";
+        readonly title: "Unsupported card network message";
+        readonly format: "icu-message";
+        readonly messageSource: "This card is not from a network the store accepts. Use another card or choose another payment method.";
+      };
+      readonly invalidSecurityCodeMessage: {
+        readonly type: "string";
+        readonly title: "Invalid security code message";
+        readonly format: "icu-message";
+        readonly messageSource: "Enter a valid security code before placing the order.";
+      };
+      readonly gatewayErrorMessage: {
+        readonly type: "string";
+        readonly title: "Gateway error message";
+        readonly format: "icu-message";
+        readonly messageSource: "Unable to complete the payment. Please try again.";
+      };
+      readonly inFlightMessage: {
+        readonly type: "string";
+        readonly title: "Order already in flight message";
+        readonly format: "icu-message";
+        readonly messageSource: "This order is already being placed. Please wait.";
+      };
+      readonly unconfirmedMessage: {
+        readonly type: "string";
+        readonly title: "Unconfirmed order message";
+        readonly format: "icu-message";
+        readonly messageSource: "We could not confirm your order yet. Your payment may still be processing, so please do not pay again.";
+      };
+      readonly declinedMessage: {
+        readonly type: "string";
+        readonly title: "Declined payment message";
+        readonly format: "icu-message";
+        readonly messageSource: "Check your payment information or choose another payment method.";
+      };
+      readonly lapsedTransactionMessage: {
+        readonly type: "string";
+        readonly title: "Lapsed payment window message";
+        readonly format: "icu-message";
+        readonly messageSource: "We could not confirm your order yet. Your payment may still be processing, so please do not pay again.";
+      };
+      readonly challengeUnavailableMessage: {
+        readonly type: "string";
+        readonly title: "Unavailable bank verification message";
+        readonly format: "icu-message";
+        readonly messageSource: "Your bank asked for an extra verification step that we could not open. Your payment may still be processing, so please do not pay again.";
+      };
+    };
+  };
 };
 export declare const PlaceOrderDefinition: ComponentDefinition<PlaceOrderProps>;
-export declare function PlaceOrder({ label, placingLabel, placingMessage, resumeLabel, successMessage, missingSubmissionMessage, missingMethodMessage, invalidTransactionMessage, networkErrorMessage, missingDocumentMessage, invalidDocumentMessage, unavailableMethodMessage, unsavedBillingAddressMessage, invalidCardDataMessage, unsupportedNetworkMessage, invalidSecurityCodeMessage, gatewayErrorMessage, inFlightMessage, unconfirmedMessage, successHref, $data: $dataProp, $actions: $actionsProp, className, ...props }: PlaceOrderProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlaceOrder({ successHref, challengeReturnHref, $data: $dataProp, $actions: $actionsProp, $content, $locale, className, ...props }: PlaceOrderProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //# sourceMappingURL=place-order.d.ts.map