From 3001369d03fe3f12d8750ce73ad3e544392e6289 Mon Sep 17 00:00:00 2001 From: Aaron Schubert Date: Fri, 14 Aug 2026 14:20:50 +0100 Subject: [PATCH] docs(point-of-sale): pin paymentvalidations to tender-confirm semantics --- .changeset/pos-payment-validations-tender-confirm-docs.md | 5 +++++ packages/ui-extensions/src/surfaces/point-of-sale/events.ts | 5 ++++- 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 .changeset/pos-payment-validations-tender-confirm-docs.md diff --git a/.changeset/pos-payment-validations-tender-confirm-docs.md b/.changeset/pos-payment-validations-tender-confirm-docs.md new file mode 100644 index 0000000000..99613dedb8 --- /dev/null +++ b/.changeset/pos-payment-validations-tender-confirm-docs.md @@ -0,0 +1,5 @@ +--- +'@shopify/ui-extensions': patch +--- + +Document `paymentvalidations` dispatch timing: fires when a tender is confirmed but not yet committed, once per tender attempt (split payments dispatch per tender). diff --git a/packages/ui-extensions/src/surfaces/point-of-sale/events.ts b/packages/ui-extensions/src/surfaces/point-of-sale/events.ts index 35daaebb83..1bd42d4af4 100644 --- a/packages/ui-extensions/src/surfaces/point-of-sale/events.ts +++ b/packages/ui-extensions/src/surfaces/point-of-sale/events.ts @@ -96,7 +96,10 @@ export interface InterceptedPaymentMethod { } /** - * Dispatched when staff selects a payment method on the payments screen. + * Dispatched when a tender is confirmed but not yet committed — after the + * amount is entered, before the payment is recorded. One event per tender + * attempt; split payments dispatch one event per tender, each carrying its + * own amount. * * @private */