platform-types 1.10.760 → 1.10.762

package/dist/audit.d.ts

@@ -153,6 +153,16 @@ declare global {
      | 'order_shipment_created'
     /** A shipment was voided; when the order was delivered, this un-delivered it. */
      | 'order_shipment_voided' | 'payment_linked' | 'payment_unlinked'
+    /**
+     * An operator closed the order's storefront payment attempt that sat in
+     * `resolution` (`POST /payments/attempts { mode: 'resolve' }`). Records a
+     * decision only — no money moved and the order row is untouched.
+     * `before`: `attemptId`, `state` (`'resolution'`), `resolutionCause`.
+     * `after`: `attemptId`, `state` (`'resolved'`), `outcome` (`'refunded'` |
+     * `'kept'`) and the operator's reason as `'[present]'` — presence only, the
+     * words stay on the attempt row.
+     */
+     | 'payment_attempt_resolved'
     /** HISTORICAL: written only by the removed outbound MercadoPago refund; kept so old timeline rows still parse. */
      | 'payment_refunded'
     /** At least one till tender leg was appended (an absorbed replay writes none). */

package/dist/cjs/notification.js

@@ -5,8 +5,8 @@ exports.NotificationTypeEnum = void 0;
 // Indexed producers resolve candidates through `getNotificationSubscribers`:
 // legacy opt-ins and explicit channel maps remain source data on USER rows.
 // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
-// ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL do not select a
-// producer subscriber audience;
+// ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL /
+// PAYMENT_ATTEMPT_RESOLUTION do not select a producer subscriber audience;
 // the consumer still reads the live USER row for each delivery channel.
 // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
 // Exported as a real enum consumed by api and app; adding an indexed type
@@ -174,4 +174,29 @@ var NotificationTypeEnum;
      * storefront socket), and never the registrant's email address.
      */
     NotificationTypeEnum["CUSTOMER_PENDING_APPROVAL"] = "CUSTOMER_PENDING_APPROVAL";
+    /**
+     * A storefront online payment attempt entered `resolution`: Mercado Pago
+     * money landed that did not settle its order (a late capture after the hold
+     * ended or the order was cancelled, a second approval, an amount or order
+     * mismatch, an order already paid). Names the order (`orderId`) and the
+     * cause, in the title and description; the app opens the resolution queue
+     * (`GET /payments/attempts?state=resolution`) from it.
+     *
+     * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
+     * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that may
+     * read and close the queue — and never to a plain USER, so a client offers
+     * the `PAYMENT_ATTEMPT_RESOLUTION` toggle to ADMINs only. No legacy opt-in
+     * scan, as for `CUSTOMER_PENDING_APPROVAL` (a new key is seeded nowhere): the
+     * consumer enforces explicit type/channel preferences
+     * (`notificationPreferences.PAYMENT_ATTEMPT_RESOLUTION`), default-on when
+     * absent. Additive — no backfill or consumer migration owed.
+     *
+     * Once per new approval: it rings on the committed move INTO the state, and
+     * again on each further APPROVAL recorded on an attempt already there (new
+     * money the operator has not seen — a pending decision is then refused
+     * `409 PAYMENT_ATTEMPT_CHANGED`). A replayed approval moves nothing and rings
+     * nothing. An attempt an operator closed (`resolved`) and a later approval
+     * re-opens rings again.
+     */
+    NotificationTypeEnum["PAYMENT_ATTEMPT_RESOLUTION"] = "PAYMENT_ATTEMPT_RESOLUTION";
 })(NotificationTypeEnum || (exports.NotificationTypeEnum = NotificationTypeEnum = {}));

package/dist/cjs/order.js

@@ -628,6 +628,13 @@ exports.ORDER_ERROR_CODES = [
     'ORDER_CURRENCY_NOT_SUBSCRIBED',
     'PAYMENT_METHODS_NOT_CONFIGURED',
     'PAYMENT_METHOD_NOT_FOUND',
+    // An online method (`Method.storefront: 'mp-checkout-pro'`) the store cannot
+    // take for this cart: Mercado Pago not connected, or a cart not in pesos.
+    'PAYMENT_METHOD_UNAVAILABLE',
+    // Storefront checkout: the cart re-priced since the shopper saw it (re-read and
+    // confirm), and an allocated order id already taken (retry).
+    'CART_PRICES_CHANGED',
+    'ORDER_ID_COLLISION',
     'DELIVERY_METHOD_NOT_FOUND',
     'ORDER_BELOW_MINIMUM_PURCHASE',
     'ORDER_INVALID_CART',

package/dist/cjs/paymentAttempt.js

@@ -19,7 +19,7 @@
  * no operator write can carry it back onto the order.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAYMENT_ATTEMPT_RESOLUTION_CAUSES = exports.ORDER_NOT_PAYABLE_REASONS = exports.PAYMENT_ATTEMPT_ERROR_CODES = exports.PAYMENT_ATTEMPT_STATES = void 0;
+exports.PAYMENT_HOLD_MINUTES_DEFAULT = exports.PAYMENT_HOLD_MINUTES_MAX = exports.PAYMENT_HOLD_MINUTES_MIN = exports.PAYMENT_ATTEMPT_RESOLUTION_CAUSES = exports.ORDER_NOT_PAYABLE_REASONS = exports.PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = exports.PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES = exports.PAYMENT_ATTEMPT_ERROR_CODES = exports.PAYMENT_ATTEMPT_STATES = void 0;
 /** Every {@link PaymentAttemptState}, in lifecycle order. */
 exports.PAYMENT_ATTEMPT_STATES = [
     'created',
@@ -31,10 +31,11 @@ exports.PAYMENT_ATTEMPT_STATES = [
     'refunded',
     'charged_back',
     'resolution',
+    'resolved',
 ];
 /**
- * Every refusal code a payment-attempt start, or a checkout choosing an online
- * method, answers:
+ * Every refusal code a payment-attempt start, a checkout choosing an online
+ * method, or an operator closing a resolution answers:
  *
  * - `PAYMENT_PROVIDER_NOT_CONNECTED` · 412 — the store has no Mercado Pago
  *   account connected.
@@ -44,9 +45,20 @@ exports.PAYMENT_ATTEMPT_STATES = [
  *   {@link OrderNotPayableData}.
  * - `PAYMENT_ATTEMPT_EXPIRED` · 410 — the attempt's `expiresAt` passed.
  * - `PAYMENT_METHOD_UNAVAILABLE` · 409 — the checkout chose an online payment
- *   method the store cannot take right now (its provider is not connected).
+ *   method the store cannot take for this cart: its provider is not connected,
+ *   or the cart is not in pesos (Checkout Pro here charges ARS only). `data` is
+ *   `{}`. Also published in `ORDER_ERROR_CODES` — web `POST /orders` answers it.
  * - `MP_PREFERENCE_CREATE_FAILED` · 502 — Mercado Pago refused the checkout or
  *   did not answer in time. No attempt was written, so starting again is safe.
+ * - `PAYMENT_ATTEMPT_NOT_FOUND` · 404 — the resolve named an attempt the store
+ *   does not have, or an `orderId` that is not the attempt's.
+ * - `PAYMENT_ATTEMPT_NOT_IN_RESOLUTION` · 409 — the resolve's attempt is not in
+ *   `resolution` (never was, or another operator closed it first). Nothing
+ *   written; `data.state` is the state it is in.
+ * - `PAYMENT_ATTEMPT_CHANGED` · 409 — the attempt is still in `resolution` but
+ *   is not the one the operator decided on: its `updatedAt` is not the request's
+ *   `expectedUpdatedAt` (a further payment was recorded on it, for one). Nothing
+ *   written; `data` is {@link PaymentAttemptChangedData}.
  */
 exports.PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_PROVIDER_NOT_CONNECTED',
@@ -55,7 +67,20 @@ exports.PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_ATTEMPT_EXPIRED',
     'PAYMENT_METHOD_UNAVAILABLE',
     'MP_PREFERENCE_CREATE_FAILED',
+    'PAYMENT_ATTEMPT_NOT_FOUND',
+    'PAYMENT_ATTEMPT_NOT_IN_RESOLUTION',
+    'PAYMENT_ATTEMPT_CHANGED',
 ];
+/**
+ * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
+ *
+ * - `refunded` — staff refunded the payment in Mercado Pago's panel.
+ * - `kept` — the money stays with the store (for instance, the order is
+ *   fulfilled by hand on it).
+ */
+exports.PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES = ['refunded', 'kept'];
+/** The longest `reason` a resolve may record, in characters after trimming. */
+exports.PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = 500;
 /**
  * Every `data.reason` of `409 ORDER_NOT_PAYABLE`:
  *
@@ -86,3 +111,12 @@ exports.PAYMENT_ATTEMPT_RESOLUTION_CAUSES = [
     'not-settled',
     'late-capture',
 ];
+/**
+ * The bounds of the store's payment hold, `ecommerce.config.paymentHoldMinutes`
+ * — how long a new attempt stays payable, in whole minutes. Both writers refuse
+ * a value outside `[MIN, MAX]` (`400 VALIDATION_FAILED`); the start reads an
+ * absent or out-of-range stored value as `DEFAULT`.
+ */
+exports.PAYMENT_HOLD_MINUTES_MIN = 15;
+exports.PAYMENT_HOLD_MINUTES_MAX = 1440;
+exports.PAYMENT_HOLD_MINUTES_DEFAULT = 60;

package/dist/cjs/socket.js

@@ -528,6 +528,18 @@ exports.SOCKET_ACTIONS = [
      * customer broadcast. Sent once per committed state move of the attempt.
      */
     'orderPaymentAttempt',
+    /**
+     * A storefront payment attempt an operator acts on changed: it entered
+     * `resolution`, took a further NEW approval while in it, or an operator
+     * closed it (`resolved`). `data` is
+     * `PaymentAttemptOperatorView` (`paymentAttempt.ts`) — never the checkout
+     * URL or the Preference id.
+     *
+     * ⚠️ OPERATOR sockets of the store only, and ADMIN tier only (`wsPostStore`
+     * with `lowTierData: null` — the tier `GET /payments/attempts` admits). Never
+     * a customer socket: the shopper's own frame is `orderPaymentAttempt`.
+     */
+    'paymentAttemptChanged',
     'stripe',
     'subscription',
     // Fiscal.

package/dist/customer.d.ts

@@ -1593,10 +1593,19 @@ declare global {
      * `register`, `mode: 'social'` with the same provider on `register-social`
      * (that account has no password) — never to register again, which the email
      * uniqueness constraint would now refuse.
+     *
+     * In a store that approves registrations first, the answer is the created
+     * customer with `accessState: 'pending'` and NO session: no token and no
+     * `sessionIssued`. The client tells the shopper the account awaits approval;
+     * signing in is refused until the store approves it.
      */
     type CustomerRegisterResult = AuthCustomer | (Customer & {
         accessToken?: never;
         sessionIssued: false;
+    }) | (Customer & {
+        accessState: 'pending';
+        accessToken?: never;
+        sessionIssued?: never;
     });
 }
 export {};

package/dist/notification.d.ts

@@ -152,7 +152,32 @@ export declare enum NotificationTypeEnum {
      * audience — the operator bell would reach the pending registrant's own
      * storefront socket), and never the registrant's email address.
      */
-    CUSTOMER_PENDING_APPROVAL = "CUSTOMER_PENDING_APPROVAL"
+    CUSTOMER_PENDING_APPROVAL = "CUSTOMER_PENDING_APPROVAL",
+    /**
+     * A storefront online payment attempt entered `resolution`: Mercado Pago
+     * money landed that did not settle its order (a late capture after the hold
+     * ended or the order was cancelled, a second approval, an amount or order
+     * mismatch, an order already paid). Names the order (`orderId`) and the
+     * cause, in the title and description; the app opens the resolution queue
+     * (`GET /payments/attempts?state=resolution`) from it.
+     *
+     * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
+     * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that may
+     * read and close the queue — and never to a plain USER, so a client offers
+     * the `PAYMENT_ATTEMPT_RESOLUTION` toggle to ADMINs only. No legacy opt-in
+     * scan, as for `CUSTOMER_PENDING_APPROVAL` (a new key is seeded nowhere): the
+     * consumer enforces explicit type/channel preferences
+     * (`notificationPreferences.PAYMENT_ATTEMPT_RESOLUTION`), default-on when
+     * absent. Additive — no backfill or consumer migration owed.
+     *
+     * Once per new approval: it rings on the committed move INTO the state, and
+     * again on each further APPROVAL recorded on an attempt already there (new
+     * money the operator has not seen — a pending decision is then refused
+     * `409 PAYMENT_ATTEMPT_CHANGED`). A replayed approval moves nothing and rings
+     * nothing. An attempt an operator closed (`resolved`) and a later approval
+     * re-opens rings again.
+     */
+    PAYMENT_ATTEMPT_RESOLUTION = "PAYMENT_ATTEMPT_RESOLUTION"
 }
 declare global {
     type CustomerNotificationPreferences = Partial<Record<'reminder-scheduled' | 'appointment-reminder', {

package/dist/notification.js

@@ -2,8 +2,8 @@
 // Indexed producers resolve candidates through `getNotificationSubscribers`:
 // legacy opt-ins and explicit channel maps remain source data on USER rows.
 // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
-// ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL do not select a
-// producer subscriber audience;
+// ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL /
+// PAYMENT_ATTEMPT_RESOLUTION do not select a producer subscriber audience;
 // the consumer still reads the live USER row for each delivery channel.
 // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
 // Exported as a real enum consumed by api and app; adding an indexed type
@@ -171,4 +171,29 @@ export var NotificationTypeEnum;
      * storefront socket), and never the registrant's email address.
      */
     NotificationTypeEnum["CUSTOMER_PENDING_APPROVAL"] = "CUSTOMER_PENDING_APPROVAL";
+    /**
+     * A storefront online payment attempt entered `resolution`: Mercado Pago
+     * money landed that did not settle its order (a late capture after the hold
+     * ended or the order was cancelled, a second approval, an amount or order
+     * mismatch, an order already paid). Names the order (`orderId`) and the
+     * cause, in the title and description; the app opens the resolution queue
+     * (`GET /payments/attempts?state=resolution`) from it.
+     *
+     * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
+     * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that may
+     * read and close the queue — and never to a plain USER, so a client offers
+     * the `PAYMENT_ATTEMPT_RESOLUTION` toggle to ADMINs only. No legacy opt-in
+     * scan, as for `CUSTOMER_PENDING_APPROVAL` (a new key is seeded nowhere): the
+     * consumer enforces explicit type/channel preferences
+     * (`notificationPreferences.PAYMENT_ATTEMPT_RESOLUTION`), default-on when
+     * absent. Additive — no backfill or consumer migration owed.
+     *
+     * Once per new approval: it rings on the committed move INTO the state, and
+     * again on each further APPROVAL recorded on an attempt already there (new
+     * money the operator has not seen — a pending decision is then refused
+     * `409 PAYMENT_ATTEMPT_CHANGED`). A replayed approval moves nothing and rings
+     * nothing. An attempt an operator closed (`resolved`) and a later approval
+     * re-opens rings again.
+     */
+    NotificationTypeEnum["PAYMENT_ATTEMPT_RESOLUTION"] = "PAYMENT_ATTEMPT_RESOLUTION";
 })(NotificationTypeEnum || (NotificationTypeEnum = {}));

package/dist/order.d.ts

@@ -1285,9 +1285,10 @@ declare global {
      * `POST /orders { mode: 'cancel' }`, by ADMIN, SUPERVISOR or MANAGER. All
      * are distinct from a bare `disabled`, which records no cancellation.
      *
-     * `system` is written only by the payment-hold expiry, which cancels an
-     * order whose online payment attempt lapsed unpaid. No writer emits it yet;
-     * it is published first so a client can render it before one does.
+     * `system` is written only by the payment-hold expiry
+     * (`services/orderSystemCancellation.ts`, run by the payment-attempt sweep),
+     * which cancels an order whose online payment attempt lapsed unpaid; its
+     * `cancelledBy` is `'system'`, never a user id.
      */
     type OrderCancellationSource = 'customer' | 'operator' | 'system';
     /**
@@ -2872,6 +2873,6 @@ export declare const orderFulfilmentProgress: (order: OrderFulfilmentProgressInp
  * `SUBSCRIPTION_READONLY`) sit on the order CREATE leg only: an edit is not a new
  * order, so `bareOrderPostHandler` routes past `requireMetered` entirely.
  */
-export declare const ORDER_ERROR_CODES: readonly ["ORDER_COST_DENOMINATION_UNKNOWN", "SERVICE_ORDER_DELIVERY_MANAGED", "ORDER_NOT_FOUND", "ORDER_LOCKED", "ORDER_NOT_READY", "ORDER_DELIVERED_ANOTHER_DAY", "ORDER_DELIVERY_STATE_UNCHANGED", "ORDER_ILLEGAL_TRANSITION", "ORDER_VERSION_CONFLICT", "CUSTOMER_NOT_FOUND", "CUSTOMER_MERGED", "ORDER_HAS_NO_CUSTOMER", "CUSTOMER_ANONYMIZED", "FX_CONVERSION_UNAVAILABLE", "ROLE_FORBIDDEN", "ORDER_CANCELLED", "PAYMENT_SETTLED_ON_ANOTHER_ORDER", "ORDER_HAS_SHIPMENTS", "ORDER_HAS_RETURNS", "SHIPMENT_QUANTITY_EXCEEDED", "SHIPMENT_LINE_MISMATCH", "SHIPMENT_NOT_FOUND", "SHIPMENT_LIMIT_REACHED", "SHIPMENT_TOO_LARGE", "ORDER_FULFILMENT_EXTERNAL", "SHIPMENT_FAILED", "ADMIN_REQUIRED", "IDEMPOTENCY_KEY_REQUIRED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_LOCK_CONTENTION", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENT_RESPONSE_NOT_CACHED", "ORDER_CANCELLATION_NOT_PROTECTED", "ORDER_CANCELLATION_COMMITTED", "ORDER_CANCELLATION_LOCKED", "ORDER_CANCELLATION_TOO_LARGE", "ORDER_CANCELLATION_FAILED", "SALE_LEDGER_RETRACTION_REFUSED", "SALE_LEDGER_ROW_NOT_OWNED", "PRODUCT_NOT_FOUND", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "DEPOSIT_SOURCE_NOT_ALLOWED", "DEPOSIT_CURRENCY_MISMATCH", "DEPOSIT_EXCEEDS_TOTAL", "DEPOSIT_FREEZE_REQUIRES_INVOICE", "DEPOSIT_FREEZE_INVOICE_PENDING", "DEPOSIT_CHARACTERIZATION_CONFLICT", "DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING", "DEPOSIT_INVOICED_ORDER_MUST_FREEZE", "DEPOSIT_FROZEN_ORDER_MUST_FREEZE", "DEPOSIT_REFERENCE_IS_LINKED_PAYMENT", "DEPOSIT_DUPLICATE_REFERENCE", "TILL_TENDER_REQUIRES_DEPOSIT", "PAYMENT_REFERENCED_BY_DEPOSIT", "ORDER_HAS_UNREFUNDED_DEPOSIT", "ORDER_PRICE_FROZEN", "DEPOSIT_NOT_FOUND", "DEPOSIT_ALREADY_REFUNDED", "UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "UNIT_QUANTITY_UNREPRESENTABLE", "KIT_RECIPE_CHANGED", "CART_PROMOTION_UNAVAILABLE", "ORDER_HAS_KIT_LINES", "ORDER_TARGET_REQUIRED", "ORDER_SOURCE_CONFLICT", "ORDER_CUSTOMER_REQUIRED", "BASKET_EMPTY", "BASKET_CHANGED_DURING_CHECKOUT", "CART_VERSION_CREATE_ONLY", "CART_VERSION_REQUIRES_CART_ID", "CART_REVISION_STALE", "CART_CUSTOMER_MISMATCH", "COUNTER_SALE_CREATE_ONLY", "SOLD_AT_CREATE_ONLY", "SOLD_AT_IN_FUTURE", "ORDER_TENDER_CREATE_ONLY", "CREDIT_OVERRIDE_CREATE_ONLY", "ON_ACCOUNT_CREATE_ONLY", "ON_ACCOUNT_WITH_TENDERS", "TENDERS_REQUIRE_COUNTER_SALE", "LINES_REQUIRE_COUNTER_SALE", "PRODUCT_COST_UNKNOWN", "PRICE_CHANGE_DISABLED", "LINE_DISCOUNT_EXCEEDS_MAX", "CUSTOMER_DISABLED", "SHIFT_NOT_AVAILABLE", "SOLD_AT_OUTSIDE_SHIFT", "ORDER_CURRENCY_NOT_SUBSCRIBED", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "DELIVERY_METHOD_NOT_FOUND", "ORDER_BELOW_MINIMUM_PURCHASE", "ORDER_INVALID_CART", "EMAIL_VERIFICATION_REQUIRED", "ACCOUNT_DISABLED", "CUSTOMER_ACCESS_PENDING", "CUSTOMER_ACCESS_REJECTED", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "ORDER_DISCOUNT_AFTER_INVOICE", "ORDER_DISCOUNT_ON_SERVICE_ORDER", "ORDER_DISCOUNT_ON_MARKETPLACE_ORDER", "ORDER_INVOICE_METHOD_OUTSTANDING_FACTURA", "ORDER_SERVICE_PERIOD_AFTER_INVOICE", "ORDER_ATTEMPT_COMMITTED", "ORDER_ATTEMPT_ABANDONED", "ORDER_ATTEMPT_KEY_EXPIRED", "ORDER_ATTEMPT_KEY_SCOPE_MISMATCH", "ORDER_COMPLETION_ATTEMPT_COMMITTED", "ORDER_COMPLETION_ATTEMPT_ABANDONED"];
+export declare const ORDER_ERROR_CODES: readonly ["ORDER_COST_DENOMINATION_UNKNOWN", "SERVICE_ORDER_DELIVERY_MANAGED", "ORDER_NOT_FOUND", "ORDER_LOCKED", "ORDER_NOT_READY", "ORDER_DELIVERED_ANOTHER_DAY", "ORDER_DELIVERY_STATE_UNCHANGED", "ORDER_ILLEGAL_TRANSITION", "ORDER_VERSION_CONFLICT", "CUSTOMER_NOT_FOUND", "CUSTOMER_MERGED", "ORDER_HAS_NO_CUSTOMER", "CUSTOMER_ANONYMIZED", "FX_CONVERSION_UNAVAILABLE", "ROLE_FORBIDDEN", "ORDER_CANCELLED", "PAYMENT_SETTLED_ON_ANOTHER_ORDER", "ORDER_HAS_SHIPMENTS", "ORDER_HAS_RETURNS", "SHIPMENT_QUANTITY_EXCEEDED", "SHIPMENT_LINE_MISMATCH", "SHIPMENT_NOT_FOUND", "SHIPMENT_LIMIT_REACHED", "SHIPMENT_TOO_LARGE", "ORDER_FULFILMENT_EXTERNAL", "SHIPMENT_FAILED", "ADMIN_REQUIRED", "IDEMPOTENCY_KEY_REQUIRED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_LOCK_CONTENTION", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENT_RESPONSE_NOT_CACHED", "ORDER_CANCELLATION_NOT_PROTECTED", "ORDER_CANCELLATION_COMMITTED", "ORDER_CANCELLATION_LOCKED", "ORDER_CANCELLATION_TOO_LARGE", "ORDER_CANCELLATION_FAILED", "SALE_LEDGER_RETRACTION_REFUSED", "SALE_LEDGER_ROW_NOT_OWNED", "PRODUCT_NOT_FOUND", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "DEPOSIT_SOURCE_NOT_ALLOWED", "DEPOSIT_CURRENCY_MISMATCH", "DEPOSIT_EXCEEDS_TOTAL", "DEPOSIT_FREEZE_REQUIRES_INVOICE", "DEPOSIT_FREEZE_INVOICE_PENDING", "DEPOSIT_CHARACTERIZATION_CONFLICT", "DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING", "DEPOSIT_INVOICED_ORDER_MUST_FREEZE", "DEPOSIT_FROZEN_ORDER_MUST_FREEZE", "DEPOSIT_REFERENCE_IS_LINKED_PAYMENT", "DEPOSIT_DUPLICATE_REFERENCE", "TILL_TENDER_REQUIRES_DEPOSIT", "PAYMENT_REFERENCED_BY_DEPOSIT", "ORDER_HAS_UNREFUNDED_DEPOSIT", "ORDER_PRICE_FROZEN", "DEPOSIT_NOT_FOUND", "DEPOSIT_ALREADY_REFUNDED", "UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "UNIT_QUANTITY_UNREPRESENTABLE", "KIT_RECIPE_CHANGED", "CART_PROMOTION_UNAVAILABLE", "ORDER_HAS_KIT_LINES", "ORDER_TARGET_REQUIRED", "ORDER_SOURCE_CONFLICT", "ORDER_CUSTOMER_REQUIRED", "BASKET_EMPTY", "BASKET_CHANGED_DURING_CHECKOUT", "CART_VERSION_CREATE_ONLY", "CART_VERSION_REQUIRES_CART_ID", "CART_REVISION_STALE", "CART_CUSTOMER_MISMATCH", "COUNTER_SALE_CREATE_ONLY", "SOLD_AT_CREATE_ONLY", "SOLD_AT_IN_FUTURE", "ORDER_TENDER_CREATE_ONLY", "CREDIT_OVERRIDE_CREATE_ONLY", "ON_ACCOUNT_CREATE_ONLY", "ON_ACCOUNT_WITH_TENDERS", "TENDERS_REQUIRE_COUNTER_SALE", "LINES_REQUIRE_COUNTER_SALE", "PRODUCT_COST_UNKNOWN", "PRICE_CHANGE_DISABLED", "LINE_DISCOUNT_EXCEEDS_MAX", "CUSTOMER_DISABLED", "SHIFT_NOT_AVAILABLE", "SOLD_AT_OUTSIDE_SHIFT", "ORDER_CURRENCY_NOT_SUBSCRIBED", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "PAYMENT_METHOD_UNAVAILABLE", "CART_PRICES_CHANGED", "ORDER_ID_COLLISION", "DELIVERY_METHOD_NOT_FOUND", "ORDER_BELOW_MINIMUM_PURCHASE", "ORDER_INVALID_CART", "EMAIL_VERIFICATION_REQUIRED", "ACCOUNT_DISABLED", "CUSTOMER_ACCESS_PENDING", "CUSTOMER_ACCESS_REJECTED", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "ORDER_DISCOUNT_AFTER_INVOICE", "ORDER_DISCOUNT_ON_SERVICE_ORDER", "ORDER_DISCOUNT_ON_MARKETPLACE_ORDER", "ORDER_INVOICE_METHOD_OUTSTANDING_FACTURA", "ORDER_SERVICE_PERIOD_AFTER_INVOICE", "ORDER_ATTEMPT_COMMITTED", "ORDER_ATTEMPT_ABANDONED", "ORDER_ATTEMPT_KEY_EXPIRED", "ORDER_ATTEMPT_KEY_SCOPE_MISMATCH", "ORDER_COMPLETION_ATTEMPT_COMMITTED", "ORDER_COMPLETION_ATTEMPT_ABANDONED"];
 export type OrderErrorCode = (typeof ORDER_ERROR_CODES)[number];
 export {};

package/dist/order.js

@@ -621,6 +621,13 @@ export const ORDER_ERROR_CODES = [
     'ORDER_CURRENCY_NOT_SUBSCRIBED',
     'PAYMENT_METHODS_NOT_CONFIGURED',
     'PAYMENT_METHOD_NOT_FOUND',
+    // An online method (`Method.storefront: 'mp-checkout-pro'`) the store cannot
+    // take for this cart: Mercado Pago not connected, or a cart not in pesos.
+    'PAYMENT_METHOD_UNAVAILABLE',
+    // Storefront checkout: the cart re-priced since the shopper saw it (re-read and
+    // confirm), and an allocated order id already taken (retry).
+    'CART_PRICES_CHANGED',
+    'ORDER_ID_COLLISION',
     'DELIVERY_METHOD_NOT_FOUND',
     'ORDER_BELOW_MINIMUM_PURCHASE',
     'ORDER_INVALID_CART',

package/dist/payment.d.ts

@@ -136,6 +136,18 @@ declare global {
         externalReference?: string;
         reconciled?: boolean;
         reconcileReason?: string;
+        /**
+         * MercadoPago's own money breakdown, in major units of `currency`: `gross` is
+         * `transaction_amount`, `net` is `transaction_details.net_received_amount`
+         * (what the store received), and `fee` is what MercadoPago kept
+         * (`gross − net`; the collector-paid `fee_details` when MercadoPago states no
+         * net). Each is present only when MercadoPago reported it, on MercadoPago
+         * payments recorded since these fields existed. Absent means "not recorded",
+         * never zero; a `fee` of `0` is a fee-free payment.
+         */
+        gross?: number;
+        fee?: number;
+        net?: number;
     }
     /**
      * Confidence tier for a link suggestion.

package/dist/paymentAttempt.d.ts

@@ -33,14 +33,26 @@ declare global {
      *   unless money had already reached it by another route; then the order is
      *   left as it is and the attempt stays `expired` — not `resolution`, since
      *   that money is not this attempt's.
-     * - `cancelled` — the order was cancelled while the attempt was live.
-     * - `refunded` — the approved payment was refunded.
+     * - `cancelled` — the order was cancelled while the attempt was live: by an
+     *   operator (`POST /orders { mode: 'cancel' }`), in the same transaction as
+     *   the cancellation. An approval that still lands on its checkout is a late
+     *   capture and moves it to `resolution`.
+     * - `refunded` — the approved payment was refunded. Only from `approved`: a
+     *   refund on a `resolution` attempt is the operator's resolution work and
+     *   leaves it `resolution`.
      * - `charged_back` — the approved payment was charged back.
      * - `resolution` — money landed that must NOT settle the order: an approval
      *   on an order already paid, on an expired or cancelled order, or for an
      *   amount other than the order total. The payment is recorded and an
      *   operator decides; the order is neither settled nor re-opened. Show it to
      *   the shopper as under review.
+     * - `resolved` — an operator closed the `resolution`
+     *   ({@link ResolvePaymentAttemptRequest}), recording whether the money was
+     *   refunded in Mercado Pago or kept. Moves no money and never touches the
+     *   order. Not quite terminal: a chargeback still moves it to `charged_back`,
+     *   and a FURTHER approval on the same checkout re-opens it to `resolution`
+     *   — new money always needs an operator again. Show it to the shopper as
+     *   reviewed by the store (the outcome and reason are operator-only).
      */
     type PaymentAttemptState = (typeof PAYMENT_ATTEMPT_STATES)[number];
     /** One of {@link PAYMENT_ATTEMPT_ERROR_CODES}. */
@@ -49,6 +61,8 @@ declare global {
     type OrderNotPayableReason = (typeof ORDER_NOT_PAYABLE_REASONS)[number];
     /** One of {@link PAYMENT_ATTEMPT_RESOLUTION_CAUSES}. */
     type PaymentAttemptResolutionCause = (typeof PAYMENT_ATTEMPT_RESOLUTION_CAUSES)[number];
+    /** One of {@link PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES}. */
+    type PaymentAttemptResolutionOutcome = (typeof PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES)[number];
     /**
      * The body that starts (or returns the live) payment attempt for an order.
      * The caller must be the order's customer; the store is the token's. The
@@ -69,6 +83,18 @@ declare global {
     interface OrderNotPayableData {
         reason: OrderNotPayableReason;
     }
+    /**
+     * `data` of `409 PAYMENT_ATTEMPT_CHANGED`: the attempt as it stands now. Show
+     * it to the operator — a payment they have not seen may be on it — and resend
+     * with its `updatedAt` once they have.
+     */
+    interface PaymentAttemptChangedData {
+        attempt: PaymentAttemptOperatorView;
+    }
+    /** `data` of `409 PAYMENT_ATTEMPT_NOT_IN_RESOLUTION`: the state the attempt is actually in. */
+    interface PaymentAttemptNotInResolutionData {
+        state: PaymentAttemptState;
+    }
     /**
      * The minimised attempt the shopper sees on their own order — never the
      * stored record.
@@ -107,6 +133,12 @@ declare global {
         state: PaymentAttemptState;
         /** Why the attempt is in `resolution` — set by the move into it. */
         resolutionCause?: PaymentAttemptResolutionCause;
+        /**
+         * How an operator closed the resolution — set by the move to `resolved`
+         * and kept after it (a later chargeback, or a re-opening approval, leaves
+         * the last closing on record).
+         */
+        resolution?: PaymentAttemptResolutionRecord;
         /** The Mercado Pago payments whose approval this attempt processed, oldest first. */
         approvedPaymentIds: string[];
         /** The Mercado Pago payment whose notification made the last move. */
@@ -121,9 +153,49 @@ declare global {
         /** Unix ms. */
         updatedAt: number;
     }
+    /** How an operator closed a `resolution` — see {@link ResolvePaymentAttemptRequest}. */
+    interface PaymentAttemptResolutionRecord {
+        outcome: PaymentAttemptResolutionOutcome;
+        /** The operator's own words, as sent (trimmed). */
+        reason: string;
+        /** The store user who closed it. */
+        resolvedBy: string;
+        /** Unix ms. */
+        resolvedAt: number;
+    }
+    /**
+     * `POST /payments/attempts { mode: 'resolve' }` (App host, admin) — an
+     * operator closes an attempt in `resolution`, moving it to `resolved`.
+     *
+     * Records a decision and nothing else: it moves NO money, writes no
+     * `PAYMENT#` row and never touches the order. A refund is made in Mercado
+     * Pago's own panel (the api has no outbound refund); `outcome: 'refunded'`
+     * records that staff did so, `'kept'` that the money stays with the store.
+     *
+     * ⚠️ The operator closes the attempt AS THEY SAW IT: `expectedUpdatedAt` is
+     * the `updatedAt` of the {@link PaymentAttemptOperatorView} they decided on.
+     * Anything that moved the attempt since — a further approval recorded on it
+     * included — answers `409 PAYMENT_ATTEMPT_CHANGED` with the current view and
+     * writes nothing, so a decision is never applied to money it did not cover.
+     */
+    interface ResolvePaymentAttemptRequest {
+        mode: 'resolve';
+        attemptId: string;
+        /** The attempt's order — must be the one `attemptId` names. */
+        orderId: string;
+        /** The `updatedAt` (Unix ms) of the operator view the decision was taken on. */
+        expectedUpdatedAt: number;
+        outcome: PaymentAttemptResolutionOutcome;
+        /** Required, 1–{@link PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX} characters after trimming. */
+        reason: string;
+    }
+    /** `data` of a successful resolve: the attempt as it now stands. */
+    interface ResolvePaymentAttemptResponse {
+        attempt: PaymentAttemptOperatorView;
+    }
     /**
-     * `data` of `GET /payments/attempts?state=resolution` (App host, admin):
-     * the store's attempts in that state, newest activity first. Page on
+     * `data` of `GET /payments/attempts?state=resolution|resolved` (App host,
+     * admin): the store's attempts in that state, newest activity first. Page on
      * `nextCursor`'s presence, never on the page's length — the state is a
      * filter, so a page can be short, even empty, with more to come.
      */
@@ -134,10 +206,10 @@ declare global {
     }
 }
 /** Every {@link PaymentAttemptState}, in lifecycle order. */
-export declare const PAYMENT_ATTEMPT_STATES: readonly ["created", "pending", "approved", "rejected", "expired", "cancelled", "refunded", "charged_back", "resolution"];
+export declare const PAYMENT_ATTEMPT_STATES: readonly ["created", "pending", "approved", "rejected", "expired", "cancelled", "refunded", "charged_back", "resolution", "resolved"];
 /**
- * Every refusal code a payment-attempt start, or a checkout choosing an online
- * method, answers:
+ * Every refusal code a payment-attempt start, a checkout choosing an online
+ * method, or an operator closing a resolution answers:
  *
  * - `PAYMENT_PROVIDER_NOT_CONNECTED` · 412 — the store has no Mercado Pago
  *   account connected.
@@ -147,11 +219,32 @@ export declare const PAYMENT_ATTEMPT_STATES: readonly ["created", "pending", "ap
  *   {@link OrderNotPayableData}.
  * - `PAYMENT_ATTEMPT_EXPIRED` · 410 — the attempt's `expiresAt` passed.
  * - `PAYMENT_METHOD_UNAVAILABLE` · 409 — the checkout chose an online payment
- *   method the store cannot take right now (its provider is not connected).
+ *   method the store cannot take for this cart: its provider is not connected,
+ *   or the cart is not in pesos (Checkout Pro here charges ARS only). `data` is
+ *   `{}`. Also published in `ORDER_ERROR_CODES` — web `POST /orders` answers it.
  * - `MP_PREFERENCE_CREATE_FAILED` · 502 — Mercado Pago refused the checkout or
  *   did not answer in time. No attempt was written, so starting again is safe.
+ * - `PAYMENT_ATTEMPT_NOT_FOUND` · 404 — the resolve named an attempt the store
+ *   does not have, or an `orderId` that is not the attempt's.
+ * - `PAYMENT_ATTEMPT_NOT_IN_RESOLUTION` · 409 — the resolve's attempt is not in
+ *   `resolution` (never was, or another operator closed it first). Nothing
+ *   written; `data.state` is the state it is in.
+ * - `PAYMENT_ATTEMPT_CHANGED` · 409 — the attempt is still in `resolution` but
+ *   is not the one the operator decided on: its `updatedAt` is not the request's
+ *   `expectedUpdatedAt` (a further payment was recorded on it, for one). Nothing
+ *   written; `data` is {@link PaymentAttemptChangedData}.
  */
-export declare const PAYMENT_ATTEMPT_ERROR_CODES: readonly ["PAYMENT_PROVIDER_NOT_CONNECTED", "PAYMENT_PROVIDER_TOKEN_EXPIRED", "ORDER_NOT_PAYABLE", "PAYMENT_ATTEMPT_EXPIRED", "PAYMENT_METHOD_UNAVAILABLE", "MP_PREFERENCE_CREATE_FAILED"];
+export declare const PAYMENT_ATTEMPT_ERROR_CODES: readonly ["PAYMENT_PROVIDER_NOT_CONNECTED", "PAYMENT_PROVIDER_TOKEN_EXPIRED", "ORDER_NOT_PAYABLE", "PAYMENT_ATTEMPT_EXPIRED", "PAYMENT_METHOD_UNAVAILABLE", "MP_PREFERENCE_CREATE_FAILED", "PAYMENT_ATTEMPT_NOT_FOUND", "PAYMENT_ATTEMPT_NOT_IN_RESOLUTION", "PAYMENT_ATTEMPT_CHANGED"];
+/**
+ * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
+ *
+ * - `refunded` — staff refunded the payment in Mercado Pago's panel.
+ * - `kept` — the money stays with the store (for instance, the order is
+ *   fulfilled by hand on it).
+ */
+export declare const PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES: readonly ["refunded", "kept"];
+/** The longest `reason` a resolve may record, in characters after trimming. */
+export declare const PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = 500;
 /**
  * Every `data.reason` of `409 ORDER_NOT_PAYABLE`:
  *
@@ -175,4 +268,13 @@ export declare const ORDER_NOT_PAYABLE_REASONS: readonly ["cancelled", "paid", "
  *   expired or been cancelled, or the order was already cancelled.
  */
 export declare const PAYMENT_ATTEMPT_RESOLUTION_CAUSES: readonly ["second-approval", "amount-mismatch", "order-mismatch", "order-already-paid", "not-settled", "late-capture"];
+/**
+ * The bounds of the store's payment hold, `ecommerce.config.paymentHoldMinutes`
+ * — how long a new attempt stays payable, in whole minutes. Both writers refuse
+ * a value outside `[MIN, MAX]` (`400 VALIDATION_FAILED`); the start reads an
+ * absent or out-of-range stored value as `DEFAULT`.
+ */
+export declare const PAYMENT_HOLD_MINUTES_MIN = 15;
+export declare const PAYMENT_HOLD_MINUTES_MAX = 1440;
+export declare const PAYMENT_HOLD_MINUTES_DEFAULT = 60;
 export {};

package/dist/paymentAttempt.js

@@ -28,10 +28,11 @@ export const PAYMENT_ATTEMPT_STATES = [
     'refunded',
     'charged_back',
     'resolution',
+    'resolved',
 ];
 /**
- * Every refusal code a payment-attempt start, or a checkout choosing an online
- * method, answers:
+ * Every refusal code a payment-attempt start, a checkout choosing an online
+ * method, or an operator closing a resolution answers:
  *
  * - `PAYMENT_PROVIDER_NOT_CONNECTED` · 412 — the store has no Mercado Pago
  *   account connected.
@@ -41,9 +42,20 @@ export const PAYMENT_ATTEMPT_STATES = [
  *   {@link OrderNotPayableData}.
  * - `PAYMENT_ATTEMPT_EXPIRED` · 410 — the attempt's `expiresAt` passed.
  * - `PAYMENT_METHOD_UNAVAILABLE` · 409 — the checkout chose an online payment
- *   method the store cannot take right now (its provider is not connected).
+ *   method the store cannot take for this cart: its provider is not connected,
+ *   or the cart is not in pesos (Checkout Pro here charges ARS only). `data` is
+ *   `{}`. Also published in `ORDER_ERROR_CODES` — web `POST /orders` answers it.
  * - `MP_PREFERENCE_CREATE_FAILED` · 502 — Mercado Pago refused the checkout or
  *   did not answer in time. No attempt was written, so starting again is safe.
+ * - `PAYMENT_ATTEMPT_NOT_FOUND` · 404 — the resolve named an attempt the store
+ *   does not have, or an `orderId` that is not the attempt's.
+ * - `PAYMENT_ATTEMPT_NOT_IN_RESOLUTION` · 409 — the resolve's attempt is not in
+ *   `resolution` (never was, or another operator closed it first). Nothing
+ *   written; `data.state` is the state it is in.
+ * - `PAYMENT_ATTEMPT_CHANGED` · 409 — the attempt is still in `resolution` but
+ *   is not the one the operator decided on: its `updatedAt` is not the request's
+ *   `expectedUpdatedAt` (a further payment was recorded on it, for one). Nothing
+ *   written; `data` is {@link PaymentAttemptChangedData}.
  */
 export const PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_PROVIDER_NOT_CONNECTED',
@@ -52,7 +64,20 @@ export const PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_ATTEMPT_EXPIRED',
     'PAYMENT_METHOD_UNAVAILABLE',
     'MP_PREFERENCE_CREATE_FAILED',
+    'PAYMENT_ATTEMPT_NOT_FOUND',
+    'PAYMENT_ATTEMPT_NOT_IN_RESOLUTION',
+    'PAYMENT_ATTEMPT_CHANGED',
 ];
+/**
+ * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
+ *
+ * - `refunded` — staff refunded the payment in Mercado Pago's panel.
+ * - `kept` — the money stays with the store (for instance, the order is
+ *   fulfilled by hand on it).
+ */
+export const PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES = ['refunded', 'kept'];
+/** The longest `reason` a resolve may record, in characters after trimming. */
+export const PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = 500;
 /**
  * Every `data.reason` of `409 ORDER_NOT_PAYABLE`:
  *
@@ -83,3 +108,12 @@ export const PAYMENT_ATTEMPT_RESOLUTION_CAUSES = [
     'not-settled',
     'late-capture',
 ];
+/**
+ * The bounds of the store's payment hold, `ecommerce.config.paymentHoldMinutes`
+ * — how long a new attempt stays payable, in whole minutes. Both writers refuse
+ * a value outside `[MIN, MAX]` (`400 VALIDATION_FAILED`); the start reads an
+ * absent or out-of-range stored value as `DEFAULT`.
+ */
+export const PAYMENT_HOLD_MINUTES_MIN = 15;
+export const PAYMENT_HOLD_MINUTES_MAX = 1440;
+export const PAYMENT_HOLD_MINUTES_DEFAULT = 60;

package/dist/socket.d.ts

@@ -26,7 +26,7 @@
  * A client must ignore actions it does not own rather than assume it
  * receives all of them.
  */
-export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "whatsapp-order-draft", "whatsapp-order-confirmation", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems"];
+export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "whatsapp-order-draft", "whatsapp-order-confirmation", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "paymentAttemptChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
 /**

package/dist/socket.js

@@ -525,6 +525,18 @@ export const SOCKET_ACTIONS = [
      * customer broadcast. Sent once per committed state move of the attempt.
      */
     'orderPaymentAttempt',
+    /**
+     * A storefront payment attempt an operator acts on changed: it entered
+     * `resolution`, took a further NEW approval while in it, or an operator
+     * closed it (`resolved`). `data` is
+     * `PaymentAttemptOperatorView` (`paymentAttempt.ts`) — never the checkout
+     * URL or the Preference id.
+     *
+     * ⚠️ OPERATOR sockets of the store only, and ADMIN tier only (`wsPostStore`
+     * with `lowTierData: null` — the tier `GET /payments/attempts` admits). Never
+     * a customer socket: the shopper's own frame is `orderPaymentAttempt`.
+     */
+    'paymentAttemptChanged',
     'stripe',
     'subscription',
     // Fiscal.

package/dist/store.d.ts

@@ -146,6 +146,18 @@ declare global {
              * frame), so the storefront can say the account needs approval.
              */
             registrationMode?: 'open' | 'approval';
+            /**
+             * How long a storefront online payment holds the order, in whole
+             * minutes: the payment attempt's `expiresAt` and its Checkout Pro
+             * Preference's `expiration_date_to` are this far from the start.
+             * An integer from `PAYMENT_HOLD_MINUTES_MIN` (15) to
+             * `PAYMENT_HOLD_MINUTES_MAX` (1440); absent means
+             * `PAYMENT_HOLD_MINUTES_DEFAULT` (60), and so does a stored value
+             * outside that range. Written by `PATCH /store` (ADMIN) and
+             * `PUT /platform/stores/{storeId}` (MANAGER). Never sent to shoppers:
+             * they see the attempt's `expiresAt` instead.
+             */
+            paymentHoldMinutes?: number;
             showStocks?: boolean;
         };
         sidebar?: {
@@ -188,7 +200,7 @@ declare global {
      * data: { field: 'ecommerce.config.newCustomerPriceList', value: number }; nothing written.
      */
     interface EcommercePatchInput {
-        config?: Pick<NonNullable<Ecommerce['config']>, 'showDefaultPriceList' | 'newCustomerPriceList' | 'registrationMode'> & StorefrontLiveSettingsPatch;
+        config?: Pick<NonNullable<Ecommerce['config']>, 'showDefaultPriceList' | 'newCustomerPriceList' | 'registrationMode' | 'paymentHoldMinutes'> & StorefrontLiveSettingsPatch;
         sidebar?: Ecommerce['sidebar'];
         home?: Omit<NonNullable<Ecommerce['home']>, 'displayOrders' | 'displayProfile'>;
         themeColors?: Ecommerce['themeColors'];
@@ -1742,7 +1754,11 @@ declare global {
      * - `'offline'` — offered, paid on delivery or pickup.
      * - `'mp-checkout-pro'` — offered, paid online through a payment attempt
      *   (`StartPaymentAttemptRequest`) on the store's connected Mercado Pago
-     *   account.
+     *   account. ⚠️ PESOS ONLY: Checkout Pro here charges ARS, so the storefront
+     *   checkout refuses this method on a cart in any other currency
+     *   (`409 PAYMENT_METHOD_UNAVAILABLE`, before the order is created), exactly
+     *   as it does when no Mercado Pago account is connected. A client should not
+     *   offer it on a non-ARS cart.
      */
     type StorefrontMethodKind = (typeof STOREFRONT_METHOD_KINDS)[number];
     interface Method {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.760",
+	"version": "1.10.762",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",