platform-types 1.10.856 → 1.10.858

package/dist/auditEnvelope.d.ts

@@ -1,5 +1,5 @@
 declare global {
-    type EntityAuditEntity = 'PLAN' | 'STORE' | 'PAYMENT' | 'ORDER' | 'MERCADOPAGO' | 'INVOICE' | 'SUBSCRIPTION' | 'USER' | 'CUSTOMER' | 'INTEGRATION' | 'PLATFORM';
+    type EntityAuditEntity = 'PLAN' | 'STORE' | 'PAYMENT' | 'ORDER' | 'MERCADOPAGO' | 'INVOICE' | 'SUBSCRIPTION' | 'USER' | 'CUSTOMER' | 'INTEGRATION' | 'PLATFORM' | 'MSG_PACK';
     /** Existing business fields with independently projected public metadata. */
     interface EntityAuditHttpEntry {
         entity: EntityAuditEntity;

package/dist/balancePayment.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Online cuenta-corriente payment — a signed-in storefront buyer pays open
+ * debits of their own ledger through the store's Mercado Pago Checkout Pro.
+ *
+ * Available while `Ecommerce.config.onlineBalancePayment` reads `true` on the
+ * public store frame: that key carries the VERDICT there (the stored switch AND
+ * the `customerAccounts` module on AND Mercado Pago linked AND a peso ledger),
+ * never the stored value alone.
+ *
+ * Which debits can be paid, and in what shape:
+ *
+ * - `prefix` — the OLDEST open debits, in the order {@link OpenAccountDebitsResponse}
+ *   lists them, from the first one on, with no gap. The payment credits the
+ *   customer, and an unstamped credit settles debits oldest-first, so any
+ *   other selection would settle debits the buyer did not pick.
+ * - `order` — exactly one debit linked to an order; the payment credits that
+ *   order and settles its debit.
+ *
+ * The amount is always the server's: the remaining balance of the selection,
+ * whole. No partial payment of a debit, no free amount, pesos only.
+ *
+ * ⚠️ Not offered, ever: a refund-in-transit debit (`RIT#…`), and a debit whose
+ * order carries a factura de crédito electrónica MiPyME (FCE, `CbteTipo`
+ * 201–213 that ARCA did not reject) — collected outside this flow. An orderless
+ * debit cannot be tied to a voucher, so it is offered whatever was invoiced.
+ *
+ * The document the buyer gets is a non-fiscal «Comprobante de pago»
+ * numbered `CPG-{n}` per store (`receiptNo`), never a «Recibo».
+ */
+declare global {
+    /** One of {@link BALANCE_ATTEMPT_MODES}. */
+    type BalanceAttemptMode = (typeof BALANCE_ATTEMPT_MODES)[number];
+    /**
+     * One of {@link BALANCE_ATTEMPT_STATES}.
+     *
+     * - `created` — the checkout exists; nothing paid yet.
+     * - `pending` — a payment was made and Mercado Pago has not decided it.
+     * - `rejected` — the last payment was rejected. NOT terminal: Checkout Pro
+     *   lets the buyer retry inside the same checkout until `expiresAt`.
+     * - `approved` — the payment was approved and credited to the ledger;
+     *   `receiptNo` and `paidAt` are set.
+     * - `expired` — `expiresAt` passed with nothing approved. Nothing else
+     *   changes: no order is cancelled and no ledger row is written.
+     * - `resolution` — money landed that was not credited on its own (an amount
+     *   other than the one frozen at the start, a payment after the checkout
+     *   expired). The store reviews it; show it as under review.
+     * - `refunded` — the approved payment was refunded in Mercado Pago. The
+     *   credit stays on the ledger until the store reverses it.
+     * - `charged_back` — the approved payment was charged back. Same as
+     *   `refunded` for the ledger.
+     */
+    type BalanceAttemptState = (typeof BALANCE_ATTEMPT_STATES)[number];
+    /** One of {@link BALANCE_PAYMENT_ERROR_CODES}. */
+    type BalancePaymentErrorCode = (typeof BALANCE_PAYMENT_ERROR_CODES)[number];
+    /**
+     * Web `GET /account?mode=open-debits` — every other query key is ignored.
+     * The caller's own ledger (the token's customer), allocated by the shared
+     * allocator (`allocateAccountLedger`).
+     */
+    interface WebAccountOpenDebitsQuery {
+        mode: 'open-debits';
+    }
+    /** One open debit the buyer may pay online. Amounts are decimal units of `ledgerCurrency`. */
+    interface OpenAccountDebit {
+        /** The ACCOUNT row's id (`ACC#{orderId}` for an order's debit, a UUID for a manual one) — what a start sends. */
+        accountId: string;
+        /** Absent on an orderless debit, which only a `prefix` start can pay. */
+        orderId?: string;
+        /** `YYYYMMDD` ledger day of the debit. */
+        dated: number;
+        /** `YYYYMMDD` due day stamped on the row; absent means unspecified. */
+        dueDate?: number;
+        /** The row's own text, verbatim. */
+        details?: string;
+        /** The debit as written. */
+        original: number;
+        /** What is still owed on it — the amount a start charges for it. Always above zero. */
+        remaining: number;
+    }
+    /** `data` of web `GET /account?mode=open-debits`. */
+    interface OpenAccountDebitsResponse {
+        /**
+         * The payable open debits, OLDEST FIRST in allocation order (when each was
+         * written, `createdAt` — not `dated`, which a backdated row bends). A
+         * `prefix` start names the first N of them.
+         */
+        debits: OpenAccountDebit[];
+        /**
+         * How many leading entries of `debits` a `prefix` start may cover: the run
+         * before the first open debit that cannot be paid online. Every entry after
+         * it can only be paid on its own, as `mode: 'order'`, and an orderless one
+         * after it not at all. Equals `debits.length` when nothing blocks.
+         */
+        prefixLength: number;
+        /** The ledger's catalog id (`ars`). Every amount here is in it. */
+        ledgerCurrency: string;
+        /**
+         * The whole ledger's balance, sign as `Customer.balance`: positive is owed
+         * by the customer, negative is credit the store holds for them.
+         */
+        balance: number;
+    }
+    /**
+     * Web `POST /payments/balance-attempts` body. Any other key — an amount
+     * included — is dropped by the parse: the server prices the selection.
+     */
+    interface StartBalanceAttemptRequest {
+        /** 1–{@link BALANCE_ATTEMPT_MAX_DEBITS} distinct `OpenAccountDebit.accountId`s; exactly one for `order`. */
+        accountIds: string[];
+        mode: BalanceAttemptMode;
+    }
+    /** `data` of web `POST /payments/balance-attempts`. */
+    interface StartBalanceAttemptResponse {
+        /** `BAT-{customerId}-{seq}`. */
+        attemptId: string;
+        /** The Mercado Pago checkout URL to send the buyer to. */
+        redirectUrl: string;
+        /** ISO 8601. After it the checkout no longer takes a payment. */
+        expiresAt: string;
+        /** Decimal pesos — what the checkout charges, computed by the server. */
+        amount: number;
+    }
+    /** `data` of `409 BALANCE_SELECTION_STALE`: the fresh payable list, as `GET /account?mode=open-debits` answers it. */
+    interface BalanceSelectionStaleData {
+        debits: OpenAccountDebit[];
+        prefixLength: number;
+    }
+    /** `data` of web `GET /payments/balance-attempts/{attemptId}` — the caller's own attempt only. */
+    interface BalanceAttemptView {
+        state: BalanceAttemptState;
+        /** Decimal pesos, frozen at the start. */
+        amount: number;
+        /** Unix ms the payment was approved. Set with `approved`. */
+        paidAt?: number;
+        /** The «Comprobante de pago» number, `CPG-{n}`. Set with `approved`. */
+        receiptNo?: string;
+        /** The debits the start priced, as sent. */
+        accountIds: string[];
+    }
+    /**
+     * `data` of the `balancePaymentAttempt` socket frame — sent to the attempt's
+     * OWN customer (`wsPostCustomer`) once per committed state move. Ids and the
+     * state only: re-read `GET /payments/balance-attempts/{attemptId}` for the
+     * rest. An approval also sends the existing `account` frame (the customer row
+     * with its new balance).
+     */
+    interface BalancePaymentAttemptFrameData {
+        attemptId: string;
+        state: BalanceAttemptState;
+        /** The «Comprobante de pago» number, `CPG-{n}`. Set from `approved` on. */
+        receiptNo?: string;
+    }
+}
+/** Every `mode` of {@link StartBalanceAttemptRequest}. */
+export declare const BALANCE_ATTEMPT_MODES: readonly ["prefix", "order"];
+/** Every {@link BalanceAttemptState}. */
+export declare const BALANCE_ATTEMPT_STATES: readonly ["created", "pending", "rejected", "approved", "expired", "resolution", "refunded", "charged_back"];
+/** The most debits one start may name. */
+export declare const BALANCE_ATTEMPT_MAX_DEBITS = 50;
+/**
+ * The refusals of the balance-payment routes, beside the shared ones they reuse
+ * (`PAYMENT_PROVIDER_NOT_CONNECTED` 412, `PAYMENT_PROVIDER_TOKEN_EXPIRED` 412,
+ * `MP_PREFERENCE_CREATE_FAILED` 502, `PLATFORM_INTEGRATION_DISABLED` 503,
+ * `CUSTOMER_LEDGER_TRUNCATED` 503, `VALIDATION_FAILED` 400):
+ *
+ * - `BALANCE_PAYMENT_DISABLED` · 403 — the store does not take online balance
+ *   payments: the switch is off or the `customerAccounts` module is. On
+ *   `GET /account?mode=open-debits` also when Mercado Pago is not linked or the
+ *   ledger is not in pesos (the start answers those 412 / 422).
+ * - `BALANCE_CURRENCY_UNSUPPORTED` · 422 — the ledger is not in pesos.
+ * - `BALANCE_SELECTION_STALE` · 409 — a selected debit is not among the payable
+ *   open debits any more (paid meanwhile, or never offered); `data` is
+ *   {@link BalanceSelectionStaleData}.
+ * - `BALANCE_SELECTION_NOT_PREFIX` · 409 — every debit is payable, but not in
+ *   this shape: `prefix` — not the first N of the list, or past `prefixLength`;
+ *   `order` — an orderless debit, or not the oldest open debit of its order.
+ * - `BALANCE_NOTHING_OWED` · 409 — the selection owes nothing.
+ * - `BALANCE_ATTEMPT_NOT_FOUND` · 404 — no such attempt of the caller's.
+ */
+export declare const BALANCE_PAYMENT_ERROR_CODES: readonly ["BALANCE_PAYMENT_DISABLED", "BALANCE_CURRENCY_UNSUPPORTED", "BALANCE_SELECTION_STALE", "BALANCE_SELECTION_NOT_PREFIX", "BALANCE_NOTHING_OWED", "BALANCE_ATTEMPT_NOT_FOUND"];
+export {};

package/dist/balancePayment.js

@@ -0,0 +1,72 @@
+/**
+ * Online cuenta-corriente payment — a signed-in storefront buyer pays open
+ * debits of their own ledger through the store's Mercado Pago Checkout Pro.
+ *
+ * Available while `Ecommerce.config.onlineBalancePayment` reads `true` on the
+ * public store frame: that key carries the VERDICT there (the stored switch AND
+ * the `customerAccounts` module on AND Mercado Pago linked AND a peso ledger),
+ * never the stored value alone.
+ *
+ * Which debits can be paid, and in what shape:
+ *
+ * - `prefix` — the OLDEST open debits, in the order {@link OpenAccountDebitsResponse}
+ *   lists them, from the first one on, with no gap. The payment credits the
+ *   customer, and an unstamped credit settles debits oldest-first, so any
+ *   other selection would settle debits the buyer did not pick.
+ * - `order` — exactly one debit linked to an order; the payment credits that
+ *   order and settles its debit.
+ *
+ * The amount is always the server's: the remaining balance of the selection,
+ * whole. No partial payment of a debit, no free amount, pesos only.
+ *
+ * ⚠️ Not offered, ever: a refund-in-transit debit (`RIT#…`), and a debit whose
+ * order carries a factura de crédito electrónica MiPyME (FCE, `CbteTipo`
+ * 201–213 that ARCA did not reject) — collected outside this flow. An orderless
+ * debit cannot be tied to a voucher, so it is offered whatever was invoiced.
+ *
+ * The document the buyer gets is a non-fiscal «Comprobante de pago»
+ * numbered `CPG-{n}` per store (`receiptNo`), never a «Recibo».
+ */
+/** Every `mode` of {@link StartBalanceAttemptRequest}. */
+export const BALANCE_ATTEMPT_MODES = ['prefix', 'order'];
+/** Every {@link BalanceAttemptState}. */
+export const BALANCE_ATTEMPT_STATES = [
+    'created',
+    'pending',
+    'rejected',
+    'approved',
+    'expired',
+    'resolution',
+    'refunded',
+    'charged_back',
+];
+/** The most debits one start may name. */
+export const BALANCE_ATTEMPT_MAX_DEBITS = 50;
+/**
+ * The refusals of the balance-payment routes, beside the shared ones they reuse
+ * (`PAYMENT_PROVIDER_NOT_CONNECTED` 412, `PAYMENT_PROVIDER_TOKEN_EXPIRED` 412,
+ * `MP_PREFERENCE_CREATE_FAILED` 502, `PLATFORM_INTEGRATION_DISABLED` 503,
+ * `CUSTOMER_LEDGER_TRUNCATED` 503, `VALIDATION_FAILED` 400):
+ *
+ * - `BALANCE_PAYMENT_DISABLED` · 403 — the store does not take online balance
+ *   payments: the switch is off or the `customerAccounts` module is. On
+ *   `GET /account?mode=open-debits` also when Mercado Pago is not linked or the
+ *   ledger is not in pesos (the start answers those 412 / 422).
+ * - `BALANCE_CURRENCY_UNSUPPORTED` · 422 — the ledger is not in pesos.
+ * - `BALANCE_SELECTION_STALE` · 409 — a selected debit is not among the payable
+ *   open debits any more (paid meanwhile, or never offered); `data` is
+ *   {@link BalanceSelectionStaleData}.
+ * - `BALANCE_SELECTION_NOT_PREFIX` · 409 — every debit is payable, but not in
+ *   this shape: `prefix` — not the first N of the list, or past `prefixLength`;
+ *   `order` — an orderless debit, or not the oldest open debit of its order.
+ * - `BALANCE_NOTHING_OWED` · 409 — the selection owes nothing.
+ * - `BALANCE_ATTEMPT_NOT_FOUND` · 404 — no such attempt of the caller's.
+ */
+export const BALANCE_PAYMENT_ERROR_CODES = [
+    'BALANCE_PAYMENT_DISABLED',
+    'BALANCE_CURRENCY_UNSUPPORTED',
+    'BALANCE_SELECTION_STALE',
+    'BALANCE_SELECTION_NOT_PREFIX',
+    'BALANCE_NOTHING_OWED',
+    'BALANCE_ATTEMPT_NOT_FOUND',
+];

package/dist/cjs/balancePayment.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Online cuenta-corriente payment — a signed-in storefront buyer pays open
+ * debits of their own ledger through the store's Mercado Pago Checkout Pro.
+ *
+ * Available while `Ecommerce.config.onlineBalancePayment` reads `true` on the
+ * public store frame: that key carries the VERDICT there (the stored switch AND
+ * the `customerAccounts` module on AND Mercado Pago linked AND a peso ledger),
+ * never the stored value alone.
+ *
+ * Which debits can be paid, and in what shape:
+ *
+ * - `prefix` — the OLDEST open debits, in the order {@link OpenAccountDebitsResponse}
+ *   lists them, from the first one on, with no gap. The payment credits the
+ *   customer, and an unstamped credit settles debits oldest-first, so any
+ *   other selection would settle debits the buyer did not pick.
+ * - `order` — exactly one debit linked to an order; the payment credits that
+ *   order and settles its debit.
+ *
+ * The amount is always the server's: the remaining balance of the selection,
+ * whole. No partial payment of a debit, no free amount, pesos only.
+ *
+ * ⚠️ Not offered, ever: a refund-in-transit debit (`RIT#…`), and a debit whose
+ * order carries a factura de crédito electrónica MiPyME (FCE, `CbteTipo`
+ * 201–213 that ARCA did not reject) — collected outside this flow. An orderless
+ * debit cannot be tied to a voucher, so it is offered whatever was invoiced.
+ *
+ * The document the buyer gets is a non-fiscal «Comprobante de pago»
+ * numbered `CPG-{n}` per store (`receiptNo`), never a «Recibo».
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BALANCE_PAYMENT_ERROR_CODES = exports.BALANCE_ATTEMPT_MAX_DEBITS = exports.BALANCE_ATTEMPT_STATES = exports.BALANCE_ATTEMPT_MODES = void 0;
+/** Every `mode` of {@link StartBalanceAttemptRequest}. */
+exports.BALANCE_ATTEMPT_MODES = ['prefix', 'order'];
+/** Every {@link BalanceAttemptState}. */
+exports.BALANCE_ATTEMPT_STATES = [
+    'created',
+    'pending',
+    'rejected',
+    'approved',
+    'expired',
+    'resolution',
+    'refunded',
+    'charged_back',
+];
+/** The most debits one start may name. */
+exports.BALANCE_ATTEMPT_MAX_DEBITS = 50;
+/**
+ * The refusals of the balance-payment routes, beside the shared ones they reuse
+ * (`PAYMENT_PROVIDER_NOT_CONNECTED` 412, `PAYMENT_PROVIDER_TOKEN_EXPIRED` 412,
+ * `MP_PREFERENCE_CREATE_FAILED` 502, `PLATFORM_INTEGRATION_DISABLED` 503,
+ * `CUSTOMER_LEDGER_TRUNCATED` 503, `VALIDATION_FAILED` 400):
+ *
+ * - `BALANCE_PAYMENT_DISABLED` · 403 — the store does not take online balance
+ *   payments: the switch is off or the `customerAccounts` module is. On
+ *   `GET /account?mode=open-debits` also when Mercado Pago is not linked or the
+ *   ledger is not in pesos (the start answers those 412 / 422).
+ * - `BALANCE_CURRENCY_UNSUPPORTED` · 422 — the ledger is not in pesos.
+ * - `BALANCE_SELECTION_STALE` · 409 — a selected debit is not among the payable
+ *   open debits any more (paid meanwhile, or never offered); `data` is
+ *   {@link BalanceSelectionStaleData}.
+ * - `BALANCE_SELECTION_NOT_PREFIX` · 409 — every debit is payable, but not in
+ *   this shape: `prefix` — not the first N of the list, or past `prefixLength`;
+ *   `order` — an orderless debit, or not the oldest open debit of its order.
+ * - `BALANCE_NOTHING_OWED` · 409 — the selection owes nothing.
+ * - `BALANCE_ATTEMPT_NOT_FOUND` · 404 — no such attempt of the caller's.
+ */
+exports.BALANCE_PAYMENT_ERROR_CODES = [
+    'BALANCE_PAYMENT_DISABLED',
+    'BALANCE_CURRENCY_UNSUPPORTED',
+    'BALANCE_SELECTION_STALE',
+    'BALANCE_SELECTION_NOT_PREFIX',
+    'BALANCE_NOTHING_OWED',
+    'BALANCE_ATTEMPT_NOT_FOUND',
+];

package/dist/cjs/index.js

@@ -32,6 +32,7 @@ __exportStar(require("./audit.js"), exports);
 __exportStar(require("./auditEnvelope.js"), exports);
 __exportStar(require("./attendance.js"), exports);
 __exportStar(require("./auth.js"), exports);
+__exportStar(require("./balancePayment.js"), exports);
 __exportStar(require("./basket.js"), exports);
 __exportStar(require("./attributes.js"), exports);
 __exportStar(require("./brands.js"), exports);

package/dist/cjs/messaging.js

@@ -8,7 +8,7 @@
  * modification, or distribution is strictly prohibited.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STORE_MESSAGE_SKIP_REASONS = exports.STORE_MESSAGE_STATUSES = exports.MESSAGE_DELIVERY_STAMPS = exports.MESSAGE_LEDGER_KINDS = exports.MESSAGE_CREDITS_PER_CHANNEL = exports.MESSAGE_ALLOWANCE_UNLIMITED = exports.SMS_FALLBACK_CREDITS = exports.WHATSAPP_MESSAGE_CREDITS = exports.MESSAGE_LEDGER_OPERATOR_ONLY_FIELDS = void 0;
+exports.STORE_MESSAGE_SKIP_REASONS = exports.STORE_MESSAGE_STATUSES = exports.MESSAGE_DELIVERY_STAMPS = exports.MESSAGE_PACK_CURRENCY = exports.MESSAGE_LEDGER_KINDS = exports.MESSAGE_CREDITS_PER_CHANNEL = exports.MESSAGE_ALLOWANCE_UNLIMITED = exports.SMS_FALLBACK_CREDITS = exports.WHATSAPP_MESSAGE_CREDITS = exports.MESSAGE_LEDGER_OPERATOR_ONLY_FIELDS = void 0;
 /**
  * Fields a store's own ledger read drops from an `adjustment` entry: it is a
  * platform operator act, and its `actor`, `reason` and `refId` (the
@@ -41,7 +41,10 @@ exports.MESSAGE_LEDGER_KINDS = [
     'allowance-grant',
     'purchase',
     'adjustment',
+    'reversal',
 ];
+/** `MessagePack.currency` — the only one a pack is sold in. */
+exports.MESSAGE_PACK_CURRENCY = 'ARS';
 exports.MESSAGE_DELIVERY_STAMPS = [
     'delivered',
     'read',

package/dist/cjs/notification.js

@@ -6,7 +6,7 @@ exports.WEB_NOTIFICATIONS_MAX_LIMIT = exports.CUSTOMER_NOTIFICATION_TYPES = expo
 // 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 /
-// PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
+// PAYMENT_ATTEMPT_RESOLUTION / BALANCE_PAID_ONLINE / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
 // SERVICE_QUOTE_DECIDED /
 // REFUND_OBLIGATION_OVERDUE / MESSAGE_CREDITS_LOW / MESSAGE_SKIPPED_NO_CREDITS do not select a
 // producer subscriber audience;
@@ -202,6 +202,18 @@ var NotificationTypeEnum;
      * re-opens rings again.
      */
     NotificationTypeEnum["PAYMENT_ATTEMPT_RESOLUTION"] = "PAYMENT_ATTEMPT_RESOLUTION";
+    /**
+     * A signed-in buyer paid open cuenta-corriente debits online through Mercado
+     * Pago, and the credit landed on their ledger with its «Comprobante de pago»
+     * number. Carries {@link NotificationInterface.customerRef} and
+     * {@link NotificationInterface.balanceAttemptId} — pointers, never the buyer's
+     * name or contact.
+     *
+     * ⚠️ ADMIN-ONLY, as `PAYMENT_ATTEMPT_RESOLUTION`: one bell per non-disabled
+     * ADMIN of the store (`listActiveAdmins`), after the credit committed,
+     * best-effort. Its own preference key, default-on when absent; seeded nowhere.
+     */
+    NotificationTypeEnum["BALANCE_PAID_ONLINE"] = "BALANCE_PAID_ONLINE";
     /**
      * A signed-in storefront buyer asked for a wholesale account
      * (`POST /user { mode: 'wholesale-request' }`) and the request waits in the

package/dist/cjs/socket.js

@@ -519,6 +519,15 @@ exports.SOCKET_ACTIONS = [
      * customer broadcast. Sent once per committed state move of the attempt.
      */
     'orderPaymentAttempt',
+    /**
+     * A signed-in buyer's online cuenta-corriente payment attempt changed state.
+     * `data` is `BalancePaymentAttemptFrameData` (`balancePayment.ts`) — the
+     * attempt id, its state and, once approved, its receipt number.
+     *
+     * ⚠️ To the attempt's OWN customer only (`wsPostCustomer`), never a
+     * store-wide customer broadcast. Sent once per committed state move.
+     */
+    'balancePaymentAttempt',
     /**
      * A storefront order's delivery was created or moved. `data` is
      * `OrderDeliveryFrameData` (`delivery.ts`) — the order id and the minimised

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './audit.ts';
 export * from './auditEnvelope.ts';
 export * from './attendance.ts';
 export * from './auth.ts';
+export * from './balancePayment.ts';
 export * from './basket.ts';
 export * from './attributes.ts';
 export * from './brands.ts';

package/dist/index.js

@@ -16,6 +16,7 @@ export * from "./audit.js";
 export * from "./auditEnvelope.js";
 export * from "./attendance.js";
 export * from "./auth.js";
+export * from "./balancePayment.js";
 export * from "./basket.js";
 export * from "./attributes.js";
 export * from "./brands.js";

package/dist/messaging.d.ts

@@ -14,8 +14,12 @@ declare global {
      * - `adjustment` — a MANAGER/SUPERVISOR correction of the bought balance,
      *   either sign, with `actor` and `reason` — operator-only, with its `refId`:
      *   the store's own ledger read drops them (`MESSAGE_LEDGER_OPERATOR_ONLY_FIELDS`).
+     * - `reversal` — a pack payment refunded or charged back: the credits its
+     *   `purchase` added are taken back (`credits` < 0, `refId` the provider
+     *   payment id). Credits already spent are not refused: the bought balance
+     *   goes below zero by the rest, and only this kind can take it there.
      */
-    type MessageLedgerKind = 'debit' | 'refund' | 'allowance-grant' | 'purchase' | 'adjustment';
+    type MessageLedgerKind = 'debit' | 'refund' | 'allowance-grant' | 'purchase' | 'adjustment' | 'reversal';
     /**
      * How a debited message ended, stamped on its `debit` entry by the sending
      * pipeline — the ONE field written after the entry lands. Absent means
@@ -51,7 +55,7 @@ declare global {
         /** The allowance period (`YYYY-MM`, Buenos Aires) the entry was written in. */
         period: string;
         createdAt: number;
-        /** The reservation a `debit`/`refund` belongs to, the purchase id, or the adjustment id. */
+        /** The reservation a `debit`/`refund` belongs to, the purchase id, the adjustment id, or a `reversal`'s payment id. */
         refId?: string;
         /** `debit` and `refund` only. */
         noticeType?: StoreMessageNotice;
@@ -71,7 +75,12 @@ declare global {
     }
     /** The store's credits right now, the period already rolled forward when it has ended. */
     interface MessageBalanceView {
-        /** Bought credits, never below zero. */
+        /**
+         * Bought credits. Below zero only after a pack payment was reversed when
+         * its credits were already spent (`reversal`): then nothing more is
+         * spent from it until a purchase brings it back up, and `available`
+         * counts it as `0`.
+         */
         balance: number;
         /** The current allowance period (`YYYY-MM`, Buenos Aires). */
         period: string;
@@ -80,7 +89,7 @@ declare global {
         allowanceUsed: number;
         /** `max(0, allowanceLimit - allowanceUsed)`; `-1` when unlimited. */
         allowanceLeft: number;
-        /** `allowanceLeft + balance` — what the next messages can spend; `-1` when unlimited. */
+        /** `allowanceLeft + max(0, balance)` — what the next messages can spend; `-1` when unlimited. */
         available: number;
     }
     /** One page of the ledger, newest first. `cursor` present only when more may follow. */
@@ -209,6 +218,74 @@ declare global {
         serviceOrderId?: string;
         messageNotices: MessageNoticeListItem[];
     }
+    /**
+     * One message pack of the platform catalogue (`MSG_PACK` / `PACK00n`), as a
+     * MANAGER reads it on `GET /platform/billing/message-packs`. Prices are the
+     * operator's: a reprice is a `PATCH`, never a release. A pack already paid
+     * keeps the credits it was bought with — the checkout freezes them.
+     */
+    interface MessagePack {
+        /** `PACK001`, `PACK002`, … — minted on create, never reused. */
+        packId: string;
+        name: string;
+        /** Whole credits the pack adds to the bought balance, 1–1 000 000. */
+        credits: number;
+        /** The price in centavos, at least 1 (MercadoPago refuses a zero price). */
+        priceCents: number;
+        currency: MessagePackCurrency;
+        /** An inactive pack is not listed to stores and cannot be checked out. */
+        active: boolean;
+        /** Ascending order on the store's list. */
+        displayOrder: number;
+        createdAt: number;
+        updatedAt: number;
+    }
+    /** The only currency a pack is sold in. */
+    type MessagePackCurrency = 'ARS';
+    /** A pack as a STORE reads it (`GET /message-credits?mode=packs`): active packs only, no bookkeeping. */
+    interface StoreMessagePack {
+        packId: string;
+        name: string;
+        credits: number;
+        priceCents: number;
+        currency: MessagePackCurrency;
+        displayOrder: number;
+    }
+    /** `POST /platform/billing/message-packs` (managerToken). */
+    interface MessagePackCreateRequest {
+        name: string;
+        credits: number;
+        priceCents: number;
+        /** Defaults to `ARS`, the only value accepted. */
+        currency?: MessagePackCurrency;
+        /** Defaults to `true`. */
+        active?: boolean;
+        /** Defaults to `0`. */
+        displayOrder?: number;
+        /** 10–500 characters, no personal data — lands on the permanent `AUDIT#MSG_PACK#` row. */
+        reason: string;
+    }
+    /** `PATCH /platform/billing/message-packs/{packId}` (managerToken): at least one field besides `reason`. */
+    interface MessagePackUpdateRequest {
+        name?: string;
+        credits?: number;
+        priceCents?: number;
+        active?: boolean;
+        displayOrder?: number;
+        /** 10–500 characters, no personal data — lands on the permanent `AUDIT#MSG_PACK#` row. */
+        reason: string;
+    }
+    /** `POST /subscription/message-packs/checkout` (adminToken). */
+    interface MessagePackCheckoutRequest {
+        packId: string;
+        successUrl: string;
+        cancelUrl: string;
+    }
+    /** The MercadoPago Checkout the store pays the pack on; redirect to `initPoint`. */
+    interface MessagePackCheckoutResult {
+        initPoint: string;
+        preferenceId: string;
+    }
     interface MessageCreditAdjustmentResult {
         storeId: string;
         /** The `adjustment` ledger entry. */
@@ -241,7 +318,9 @@ export declare const MESSAGE_CREDITS_PER_CHANNEL: {
     readonly whatsapp: 1;
     readonly sms: 3;
 };
-export declare const MESSAGE_LEDGER_KINDS: readonly ["debit", "refund", "allowance-grant", "purchase", "adjustment"];
+export declare const MESSAGE_LEDGER_KINDS: readonly ["debit", "refund", "allowance-grant", "purchase", "adjustment", "reversal"];
+/** `MessagePack.currency` — the only one a pack is sold in. */
+export declare const MESSAGE_PACK_CURRENCY: "ARS";
 export declare const MESSAGE_DELIVERY_STAMPS: readonly ["delivered", "read", "failed"];
 export declare const STORE_MESSAGE_STATUSES: readonly ["queued", "sending", "sent", "delivered", "read", "failed", "undelivered", "skipped"];
 export declare const STORE_MESSAGE_SKIP_REASONS: readonly ["switched-off", "no-consent", "no-phone", "no-credits", "not-configured", "messaging-disabled"];

package/dist/messaging.js

@@ -38,7 +38,10 @@ export const MESSAGE_LEDGER_KINDS = [
     'allowance-grant',
     'purchase',
     'adjustment',
+    'reversal',
 ];
+/** `MessagePack.currency` — the only one a pack is sold in. */
+export const MESSAGE_PACK_CURRENCY = 'ARS';
 export const MESSAGE_DELIVERY_STAMPS = [
     'delivered',
     'read',

package/dist/notification.d.ts

@@ -178,6 +178,18 @@ export declare enum NotificationTypeEnum {
      * re-opens rings again.
      */
     PAYMENT_ATTEMPT_RESOLUTION = "PAYMENT_ATTEMPT_RESOLUTION",
+    /**
+     * A signed-in buyer paid open cuenta-corriente debits online through Mercado
+     * Pago, and the credit landed on their ledger with its «Comprobante de pago»
+     * number. Carries {@link NotificationInterface.customerRef} and
+     * {@link NotificationInterface.balanceAttemptId} — pointers, never the buyer's
+     * name or contact.
+     *
+     * ⚠️ ADMIN-ONLY, as `PAYMENT_ATTEMPT_RESOLUTION`: one bell per non-disabled
+     * ADMIN of the store (`listActiveAdmins`), after the credit committed,
+     * best-effort. Its own preference key, default-on when absent; seeded nowhere.
+     */
+    BALANCE_PAID_ONLINE = "BALANCE_PAID_ONLINE",
     /**
      * A signed-in storefront buyer asked for a wholesale account
      * (`POST /user { mode: 'wholesale-request' }`) and the request waits in the
@@ -344,6 +356,14 @@ declare global {
         /** The row's `emailVerified` at registration — `false` when the address is still unproven. */
         emailVerified: boolean;
     }
+    /**
+     * Which customer a `BALANCE_PAID_ONLINE` bell is about. A POINTER, never an
+     * audience — the top-level `customerId` would deliver the bell to the buyer.
+     * Operator surfaces only.
+     */
+    interface BalancePaidCustomerRef {
+        customerId: string;
+    }
     interface NotificationInterface {
         storeId: string;
         notificationId: string;
@@ -406,6 +426,16 @@ declare global {
          * an audience — see {@link ServiceOrderRef}. Operator surfaces only.
          */
         serviceOrderRef?: ServiceOrderRef;
+        /**
+         * `BALANCE_PAID_ONLINE` only: which customer paid. A POINTER, not an
+         * audience — see {@link BalancePaidCustomerRef}. Operator surfaces only.
+         */
+        customerRef?: BalancePaidCustomerRef;
+        /**
+         * `BALANCE_PAID_ONLINE` only: the online balance-payment attempt
+         * (`BAT-{customerId}-{seq}`). Operator surfaces only.
+         */
+        balanceAttemptId?: string;
         /** `MENTION` only: the colleague who wrote the mention (a snapshot). */
         actor?: NotificationActor;
         userId?: string;

package/dist/notification.js

@@ -3,7 +3,7 @@
 // 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 /
-// PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
+// PAYMENT_ATTEMPT_RESOLUTION / BALANCE_PAID_ONLINE / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
 // SERVICE_QUOTE_DECIDED /
 // REFUND_OBLIGATION_OVERDUE / MESSAGE_CREDITS_LOW / MESSAGE_SKIPPED_NO_CREDITS do not select a
 // producer subscriber audience;
@@ -199,6 +199,18 @@ export var NotificationTypeEnum;
      * re-opens rings again.
      */
     NotificationTypeEnum["PAYMENT_ATTEMPT_RESOLUTION"] = "PAYMENT_ATTEMPT_RESOLUTION";
+    /**
+     * A signed-in buyer paid open cuenta-corriente debits online through Mercado
+     * Pago, and the credit landed on their ledger with its «Comprobante de pago»
+     * number. Carries {@link NotificationInterface.customerRef} and
+     * {@link NotificationInterface.balanceAttemptId} — pointers, never the buyer's
+     * name or contact.
+     *
+     * ⚠️ ADMIN-ONLY, as `PAYMENT_ATTEMPT_RESOLUTION`: one bell per non-disabled
+     * ADMIN of the store (`listActiveAdmins`), after the credit committed,
+     * best-effort. Its own preference key, default-on when absent; seeded nowhere.
+     */
+    NotificationTypeEnum["BALANCE_PAID_ONLINE"] = "BALANCE_PAID_ONLINE";
     /**
      * A signed-in storefront buyer asked for a wholesale account
      * (`POST /user { mode: 'wholesale-request' }`) and the request waits in the

package/dist/payment.d.ts

@@ -136,6 +136,13 @@ declare global {
         externalReference?: string;
         reconciled?: boolean;
         reconcileReason?: string;
+        /**
+         * The non-fiscal «Comprobante de pago» number, `CPG-{n}`, sequential per
+         * store — set only on a payment a buyer made online against their cuenta
+         * corriente (`POST /payments/balance-attempts`), stamped with the ledger
+         * credit. Never a fiscal «Recibo». Absent on every other payment.
+         */
+        receiptNo?: string;
         /**
          * MercadoPago's own money breakdown, in major units of `currency`: `gross` is
          * `transaction_amount`, `net` is `transaction_details.net_received_amount`

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", "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", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "orderReturnRequest", "purchaseWithdrawalChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print-service-order", "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", "wholesaleRequests"];
+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", "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", "balancePaymentAttempt", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "orderReturnRequest", "purchaseWithdrawalChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print-service-order", "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", "wholesaleRequests"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
 /**

package/dist/socket.js

@@ -516,6 +516,15 @@ export const SOCKET_ACTIONS = [
      * customer broadcast. Sent once per committed state move of the attempt.
      */
     'orderPaymentAttempt',
+    /**
+     * A signed-in buyer's online cuenta-corriente payment attempt changed state.
+     * `data` is `BalancePaymentAttemptFrameData` (`balancePayment.ts`) — the
+     * attempt id, its state and, once approved, its receipt number.
+     *
+     * ⚠️ To the attempt's OWN customer only (`wsPostCustomer`), never a
+     * store-wide customer broadcast. Sent once per committed state move.
+     */
+    'balancePaymentAttempt',
     /**
      * A storefront order's delivery was created or moved. `data` is
      * `OrderDeliveryFrameData` (`delivery.ts`) — the order id and the minimised

package/dist/store.d.ts

@@ -227,6 +227,21 @@ declare global {
              * they see the attempt's `expiresAt` instead.
              */
             paymentHoldMinutes?: number;
+            /**
+             * Whether a signed-in storefront buyer may pay open cuenta-corriente
+             * debits online through the store's Mercado Pago (Checkout Pro). Absent
+             * or `false` = off. Written by `PATCH /store` (ADMIN) and
+             * `PUT /platform/stores/{storeId}` (MANAGER) as a plain boolean; storing
+             * `true` is never refused.
+             *
+             * ⚠️ SENT TO SHOPPERS AS THE VERDICT, under this same key (web `GET /store`
+             * and the customer `stores` frame): `true` only while the stored value is
+             * `true` AND `config.modules.customerAccounts` is not `false` AND Mercado
+             * Pago is linked AND the ledger (`config.displayCurrency`) is the peso.
+             * Web `GET /account?mode=open-debits` and `POST /payments/balance-attempts`
+             * judge the same verdict server-side (`BalancePaymentErrorCode`).
+             */
+            onlineBalancePayment?: boolean;
             showStocks?: boolean;
         };
         sidebar?: {
@@ -273,7 +288,7 @@ declare global {
      * (Responsable Inscripto) refuses 409 NET_PLUS_IVA_REQUIRES_RI; nothing written.
      */
     interface EcommercePatchInput {
-        config?: Pick<NonNullable<Ecommerce['config']>, 'showDefaultPriceList' | 'newCustomerPriceList' | 'registrationMode' | 'wholesaleRequests' | 'serviceTracking' | 'paymentHoldMinutes'> & StorefrontLiveSettingsPatch;
+        config?: Pick<NonNullable<Ecommerce['config']>, 'showDefaultPriceList' | 'newCustomerPriceList' | 'registrationMode' | 'wholesaleRequests' | 'serviceTracking' | 'paymentHoldMinutes' | 'onlineBalancePayment'> & StorefrontLiveSettingsPatch;
         sidebar?: Ecommerce['sidebar'];
         home?: Omit<NonNullable<Ecommerce['home']>, 'displayOrders' | 'displayProfile'>;
         themeColors?: Ecommerce['themeColors'];

package/package.json

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