@pisell/pisellos 2.3.39 → 2.3.41

package/dist/modules/Payment/index.js

@@ -27,6 +27,9 @@ import { CashPaymentImpl } from "./cash";
 import { EftposPaymentImpl } from "./eftpos";
 import { WalletPassPaymentImpl } from "./walletpass";
 import { Decimal } from 'decimal.js';
+import { ensureOrderPaymentNumber } from "../Order/payment-utils";
+import { createUuidV4 } from "../Order/utils";
+import { resolvePaymentNumberDevicePrefix } from "../../utils/payment-number";
 export * from "./types";
 export { generateRequestUniqueId };
 
@@ -102,6 +105,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "request", void 0);
     _defineProperty(_assertThisInitialized(_this), "app", void 0);
     // App instance
+    _defineProperty(_assertThisInitialized(_this), "appPlugin", void 0);
     _defineProperty(_assertThisInitialized(_this), "store", void 0);
     _defineProperty(_assertThisInitialized(_this), "window", void 0);
     // WindowPlugin 实例
@@ -168,7 +172,6 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
     key: "initialize",
     value: function () {
       var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(core, options) {
-        var appPlugin;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
@@ -178,7 +181,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
 
               // 获取依赖的插件
               this.request = core.getPlugin('request');
-              appPlugin = core.getPlugin('app');
+              this.appPlugin = core.getPlugin('app');
               this.window = core.getPlugin('window');
               if (this.request) {
                 _context.next = 8;
@@ -186,13 +189,13 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('支付模块需要 request 插件支持');
             case 8:
-              if (appPlugin) {
+              if (this.appPlugin) {
                 _context.next = 10;
                 break;
               }
               throw new Error('支付模块需要 app 插件支持');
             case 10:
-              this.app = appPlugin.getApp();
+              this.app = this.appPlugin.getApp();
               this.dbManager = this.app.dbManager;
               this.logger = this.app.logger;
 
@@ -228,6 +231,15 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
     value: function updateOtherParams(params) {
       this.otherParams = params || {};
     }
+  }, {
+    key: "getPaymentNumberAppData",
+    value: function getPaymentNumberAppData(key) {
+      var _this$appPlugin, _this$appPlugin$getDa, _this$app, _this$app$getStore, _this$app$getStore$ca, _this$app$getStore$ca2;
+      var getData = (_this$appPlugin = this.appPlugin) === null || _this$appPlugin === void 0 || (_this$appPlugin$getDa = _this$appPlugin.getData) === null || _this$appPlugin$getDa === void 0 ? void 0 : _this$appPlugin$getDa.call(_this$appPlugin);
+      if (typeof getData === 'function') return getData(key);
+      var coreData = (_this$app = this.app) === null || _this$app === void 0 || (_this$app = _this$app.models) === null || _this$app === void 0 || (_this$app$getStore = _this$app.getStore) === null || _this$app$getStore === void 0 || (_this$app$getStore$ca = (_this$app$getStore$ca2 = _this$app$getStore.call(_this$app)).getDataByModel) === null || _this$app$getStore$ca === void 0 ? void 0 : _this$app$getStore$ca.call(_this$app$getStore$ca2, 'core', 'core');
+      return coreData === null || coreData === void 0 ? void 0 : coreData[key];
+    }
 
     /**
      * 记录信息日志
@@ -884,7 +896,8 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
     key: "addPaymentItemAsync",
     value: (function () {
       var _addPaymentItemAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee12(orderUuid, paymentItem) {
-        var _paymentItem$metadata, _newPaymentItem$metad, _newPaymentItem$metad2, _newPaymentItem$metad3, order, expectAmount, paidDepositAmount, expectedDepositAmount, warningMessage, paymentUuid, currentTime, newPaymentItem;
+        var _this5 = this;
+        var _paymentItem$metadata, _newPaymentItem$metad, _newPaymentItem$metad2, _newPaymentItem$metad3, order, expectAmount, paidDepositAmount, expectedDepositAmount, warningMessage, paymentUuid, currentTime, hasPaymentNumber, paymentNumberDevicePrefix, paymentNumber, newPaymentItem;
         return _regeneratorRuntime().wrap(function _callee12$(_context12) {
           while (1) switch (_context12.prev = _context12.next) {
             case 0:
@@ -940,14 +953,29 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
               });
               throw new Error(warningMessage);
             case 17:
-              if ((_paymentItem$metadata = paymentItem.metadata) !== null && _paymentItem$metadata !== void 0 && _paymentItem$metadata.unique_payment_number) {
-                paymentUuid = paymentItem.metadata.unique_payment_number;
-              } else {
-                paymentUuid = getUniqueId('payment_');
-              }
+              paymentUuid = paymentItem.uuid || ((_paymentItem$metadata = paymentItem.metadata) === null || _paymentItem$metadata === void 0 ? void 0 : _paymentItem$metadata.unique_payment_number) || getUniqueId('payment_');
               currentTime = formatDateTime(new Date());
+              hasPaymentNumber = String(paymentItem.payment_number || '').trim() !== '';
+              if (!hasPaymentNumber) {
+                _context12.next = 24;
+                break;
+              }
+              _context12.t0 = 'LOCAL';
+              _context12.next = 27;
+              break;
+            case 24:
+              _context12.next = 26;
+              return resolvePaymentNumberDevicePrefix(function (key) {
+                return _this5.getPaymentNumberAppData(key);
+              });
+            case 26:
+              _context12.t0 = _context12.sent;
+            case 27:
+              paymentNumberDevicePrefix = _context12.t0;
+              paymentNumber = ensureOrderPaymentNumber(paymentItem, paymentNumberDevicePrefix, createUuidV4).payment_number;
               newPaymentItem = {
                 uuid: paymentUuid,
+                payment_number: paymentNumber,
                 custom_payment_id: normalizeCustomPaymentId(paymentItem),
                 name: paymentItem.name,
                 code: paymentItem.code,
@@ -966,10 +994,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                 // 创建时间
                 updated_at: currentTime,
                 // 更新时间
-                metadata: _objectSpread(_objectSpread({}, paymentItem.metadata), {}, {
-                  // 保留传入的所有 metadata 字段
-                  unique_payment_number: paymentUuid // 设置唯一支付号为支付项的 uuid
-                })
+                metadata: _objectSpread({}, paymentItem.metadata)
               };
               order.payment.push(newPaymentItem);
               this.recalculateOrderAmount(order);
@@ -977,9 +1002,9 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                 orderUuid: orderUuid,
                 order: order
               });
-              _context12.next = 25;
+              _context12.next = 35;
               return this.dbManager.update('order', order, true);
-            case 25:
+            case 35:
               this.logInfo('更新订单支付项完成', {
                 orderUuid: orderUuid
               });
@@ -1000,22 +1025,22 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                 actualPaidAmount: (_newPaymentItem$metad2 = newPaymentItem.metadata) === null || _newPaymentItem$metad2 === void 0 ? void 0 : _newPaymentItem$metad2.actual_paid_amount,
                 changeGivenAmount: (_newPaymentItem$metad3 = newPaymentItem.metadata) === null || _newPaymentItem$metad3 === void 0 ? void 0 : _newPaymentItem$metad3.change_given_amount
               });
-              _context12.next = 35;
+              _context12.next = 45;
               break;
-            case 30:
-              _context12.prev = 30;
-              _context12.t0 = _context12["catch"](1);
-              console.error('[PaymentModule] 添加支付项失败', _context12.t0);
-              this.logError('addPaymentItemAsync failed', _context12.t0, {
+            case 40:
+              _context12.prev = 40;
+              _context12.t1 = _context12["catch"](1);
+              console.error('[PaymentModule] 添加支付项失败', _context12.t1);
+              this.logError('addPaymentItemAsync failed', _context12.t1, {
                 orderUuid: orderUuid,
                 paymentItem: paymentItem
               });
-              throw _context12.t0;
-            case 35:
+              throw _context12.t1;
+            case 45:
             case "end":
               return _context12.stop();
           }
-        }, _callee12, this, [[1, 30]]);
+        }, _callee12, this, [[1, 40]]);
       }));
       function addPaymentItemAsync(_x13, _x14) {
         return _addPaymentItemAsync.apply(this, arguments);
@@ -1135,17 +1160,17 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
     key: "updateVoucherPaymentItemsAsync",
     value: (function () {
       var _updateVoucherPaymentItemsAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee15(orderUuid, voucherPaymentItems) {
-        var _this5 = this;
+        var _this6 = this;
         return _regeneratorRuntime().wrap(function _callee15$(_context15) {
           while (1) switch (_context15.prev = _context15.next) {
             case 0:
               return _context15.abrupt("return", this.runVoucherUpdateLocked(orderUuid, /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee14() {
-                var _this5$normalizeVouch, normalizedVoucherItems, originalCount, normalizedCount, order, existingVoucherItems, _iterator2, _step2, voucherItem, orderAfterDelete, existingActiveVoucherKeys, _iterator3, _step3, _voucherItem, orderPaymentType, key, updatedOrder;
+                var _this6$normalizeVouch, normalizedVoucherItems, originalCount, normalizedCount, order, existingVoucherItems, _iterator2, _step2, voucherItem, orderAfterDelete, existingActiveVoucherKeys, _iterator3, _step3, _voucherItem, orderPaymentType, key, updatedOrder;
                 return _regeneratorRuntime().wrap(function _callee14$(_context14) {
                   while (1) switch (_context14.prev = _context14.next) {
                     case 0:
-                      _this5$normalizeVouch = _this5.normalizeVoucherPaymentItems(voucherPaymentItems), normalizedVoucherItems = _this5$normalizeVouch.items, originalCount = _this5$normalizeVouch.originalCount, normalizedCount = _this5$normalizeVouch.normalizedCount;
-                      _this5.logInfo('Starting updateVoucherPaymentItemsAsync', {
+                      _this6$normalizeVouch = _this6.normalizeVoucherPaymentItems(voucherPaymentItems), normalizedVoucherItems = _this6$normalizeVouch.items, originalCount = _this6$normalizeVouch.originalCount, normalizedCount = _this6$normalizeVouch.normalizedCount;
+                      _this6.logInfo('Starting updateVoucherPaymentItemsAsync', {
                         orderUuid: orderUuid,
                         originalVoucherCount: originalCount,
                         normalizedVoucherCount: normalizedCount,
@@ -1167,7 +1192,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                       }
                       _context14.prev = 3;
                       _context14.next = 6;
-                      return _this5.getPaymentOrderByUuidAsync(orderUuid);
+                      return _this6.getPaymentOrderByUuidAsync(orderUuid);
                     case 6:
                       order = _context14.sent;
                       if (order) {
@@ -1207,7 +1232,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                       voucherItem = _step2.value;
                       console.log("[PaymentModule] \u5220\u9664\u73B0\u6709\u4EE3\u91D1\u5238\u652F\u4ED8\u9879: ".concat(voucherItem.uuid));
                       _context14.next = 19;
-                      return _this5.deletePaymentAsync(orderUuid, voucherItem.uuid);
+                      return _this6.deletePaymentAsync(orderUuid, voucherItem.uuid);
                     case 19:
                       _context14.next = 14;
                       break;
@@ -1224,7 +1249,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                       return _context14.finish(26);
                     case 29:
                       _context14.next = 31;
-                      return _this5.getPaymentOrderByUuidAsync(orderUuid);
+                      return _this6.getPaymentOrderByUuidAsync(orderUuid);
                     case 31:
                       orderAfterDelete = _context14.sent;
                       if (orderAfterDelete) {
@@ -1271,7 +1296,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                         order_payment_type: orderPaymentType
                       }));
                       _context14.next = 49;
-                      return _this5.addPaymentItemAsync(orderUuid, _voucherItem);
+                      return _this6.addPaymentItemAsync(orderUuid, _voucherItem);
                     case 49:
                       existingActiveVoucherKeys.add(key);
                     case 50:
@@ -1290,17 +1315,17 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                       return _context14.finish(57);
                     case 60:
                       _context14.next = 62;
-                      return _this5.getPaymentOrderByUuidAsync(orderUuid);
+                      return _this6.getPaymentOrderByUuidAsync(orderUuid);
                     case 62:
                       updatedOrder = _context14.sent;
                       _context14.next = 65;
-                      return _this5.core.effects.emit("".concat(_this5.name, ":onPaymentAdded"), {
+                      return _this6.core.effects.emit("".concat(_this6.name, ":onPaymentAdded"), {
                         orderUuid: orderUuid,
                         order: updatedOrder,
                         payment: null // 批量操作不提供单个支付项
                       });
                     case 65:
-                      _this5.logInfo('updateVoucherPaymentItemsAsync completed successfully', {
+                      _this6.logInfo('updateVoucherPaymentItemsAsync completed successfully', {
                         orderUuid: orderUuid,
                         removedVoucherCount: existingVoucherItems.length,
                         addedVoucherCount: normalizedVoucherItems.length,
@@ -1312,7 +1337,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                       _context14.prev = 68;
                       _context14.t2 = _context14["catch"](3);
                       console.error('[PaymentModule] 批量更新代金券支付项失败:', _context14.t2);
-                      _this5.logError('updateVoucherPaymentItemsAsync failed', _context14.t2, {
+                      _this6.logError('updateVoucherPaymentItemsAsync failed', _context14.t2, {
                         orderUuid: orderUuid,
                         voucherPaymentItems: voucherPaymentItems
                       });
@@ -1361,7 +1386,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                 return payment.uuid === paymentUuid;
               });
               if (!paymentItem) {
-                _context16.next = 18;
+                _context16.next = 19;
                 break;
               }
               // 如果更新参数中包含 amount，先格式化
@@ -1369,40 +1394,43 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
               if ('amount' in formattedParams && formattedParams.amount !== undefined) {
                 formattedParams.amount = formatAmount(formattedParams.amount);
               }
+              if (formattedParams.metadata && _typeof(formattedParams.metadata) === 'object') {
+                formattedParams.metadata = _objectSpread(_objectSpread({}, paymentItem.metadata || {}), formattedParams.metadata);
+              }
               Object.assign(paymentItem, formattedParams);
 
               // 重新计算待付金额
               this.recalculateOrderAmount(order);
 
               // 更新到 IndexDB
-              _context16.next = 14;
+              _context16.next = 15;
               return this.dbManager.update('order', order);
-            case 14:
-              _context16.next = 16;
+            case 15:
+              _context16.next = 17;
               return this.core.effects.emit("".concat(this.name, ":onPaymentUpdated"), {
                 order: order,
                 paymentItem: paymentItem
               });
-            case 16:
-              _context16.next = 18;
+            case 17:
+              _context16.next = 19;
               return this.core.effects.emit("".concat(this.name, ":onOrderChanged"), {
                 action: 'payment_update',
                 order: order,
                 paymentItem: paymentItem
               });
-            case 18:
-              _context16.next = 24;
+            case 19:
+              _context16.next = 25;
               break;
-            case 20:
-              _context16.prev = 20;
+            case 21:
+              _context16.prev = 21;
               _context16.t0 = _context16["catch"](0);
               console.error('[PaymentModule] 更新支付项失败', _context16.t0);
               throw _context16.t0;
-            case 24:
+            case 25:
             case "end":
               return _context16.stop();
           }
-        }, _callee16, this, [[0, 20]]);
+        }, _callee16, this, [[0, 21]]);
       }));
       function updatePaymentAsync(_x19, _x20, _x21) {
         return _updatePaymentAsync.apply(this, arguments);
@@ -1518,6 +1546,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                 payments: order.payment.map(function (payment) {
                   return {
                     uuid: payment.uuid,
+                    payment_number: payment.payment_number,
                     amount: payment.amount,
                     code: payment.code,
                     custom_payment_id: payment.custom_payment_id,
@@ -1980,7 +2009,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
               baseValue = amount.div(roundingInterval);
               console.log("[PaymentModule] \u820D\u5165\u8BA1\u7B97 - \u539F\u59CB\u91D1\u989D: ".concat(amount.toString(), ", \u95F4\u9694: ").concat(intervalValue, ", \u57FA\u7840\u503C: ").concat(baseValue.toString(), ", \u89C4\u5219: ").concat(rule));
               _context26.t0 = rule;
-              _context26.next = _context26.t0 === RoundingRule.Standard ? 13 : _context26.t0 === 'standard' ? 13 : _context26.t0 === RoundingRule.StandardDown ? 15 : _context26.t0 === 'standard_down' ? 15 : _context26.t0 === RoundingRule.AlwaysUp ? 17 : _context26.t0 === 'always_up' ? 17 : _context26.t0 === RoundingRule.AlwaysDown ? 19 : _context26.t0 === 'always_down' ? 19 : 21;
+              _context26.next = _context26.t0 === RoundingRule.Standard ? 13 : _context26.t0 === 'standard' ? 13 : _context26.t0 === RoundingRule.StandardDown ? 15 : _context26.t0 === 'standard_rounding_midpoint_down' ? 15 : _context26.t0 === RoundingRule.AlwaysUp ? 17 : _context26.t0 === 'always_up' ? 17 : _context26.t0 === RoundingRule.AlwaysDown ? 19 : _context26.t0 === 'always_down' ? 19 : 21;
               break;
             case 13:
               // 标准舍入（中点向上）

package/dist/modules/Payment/types.d.ts

@@ -40,11 +40,11 @@ export declare enum RoundingRule {
     /** 标准舍入（中点向上） */
     Standard = "standard_rounding",
     /** 标准舍入（中点向下） */
-    StandardDown = "standard_down",
+    StandardDown = "standard_rounding_midpoint_down",
     /** 总是向上舍入 */
-    AlwaysUp = "always_up",
+    AlwaysUp = "round_up",
     /** 总是向下舍入 */
-    AlwaysDown = "always_down"
+    AlwaysDown = "round_down"
 }
 /**
  * 舍入结果
@@ -87,12 +87,30 @@ export interface PaymentMethod {
     /** 其他配置信息 */
     [key: string]: any;
 }
+/** 支付项扩展元数据 */
+export interface PaymentItemMetadata {
+    /** 钱箱 ID */
+    shop_wallet_pass_id?: string;
+    /** 三方支付交易流水号 */
+    unique_payment_number?: string;
+    /** 刷卡机设备快照；PaymentModule 不解析内部字段 */
+    card_reader_snapshot?: Record<string, unknown>;
+    /** rounding 规则 */
+    rounding_rule?: any;
+    /** 实付金额（现金支付时的实际给出金额） */
+    actual_paid_amount?: number;
+    /** 找零金额（现金支付时的找零金额） */
+    change_given_amount?: number;
+    [key: string]: unknown;
+}
 /**
  * 支付项
  */
 export interface PaymentItem {
     /** 当前支付项的唯一 ID */
     uuid: string;
+    /** 支付项稳定唯一号 */
+    payment_number?: string;
     /** 当前支付方式付出去多少钱 */
     amount: string;
     /** 支付类型，跟支付列表上对应的支付方式保持一致 */
@@ -110,18 +128,7 @@ export interface PaymentItem {
     /** Wallet Pass 本次使用值 */
     wallet_pass_use_value?: string | number | null;
     /** 拓展参数字段 */
-    metadata?: {
-        /** 钱箱 ID */
-        shop_wallet_pass_id?: string;
-        /** 唯一支付号 */
-        unique_payment_number?: string;
-        /** rouding规则 */
-        rounding_rule?: any;
-        /** 实付金额（现金支付时的实际给出金额） */
-        actual_paid_amount?: number;
-        /** 找零金额（现金支付时的找零金额） */
-        change_given_amount?: number;
-    };
+    metadata?: PaymentItemMetadata;
     /** rouding金额 */
     rounding_amount?: string;
     /** 三方支付手续费 */
@@ -228,6 +235,10 @@ export interface UpdateOrderParams {
  * 支付项输入类型（允许 amount 为数字）
  */
 export interface PaymentItemInput {
+    /** 调用方已有的支付项运行态 UUID；存在时复用为 payment_number 的唯一号段 */
+    uuid?: string;
+    /** 支付项稳定唯一号 */
+    payment_number?: string;
     /** 当前支付方式付出去多少钱 */
     amount: string | number;
     /** 支付类型，跟支付列表上对应的支付方式保持一致 */
@@ -256,18 +267,7 @@ export interface PaymentItemInput {
     /** 订单支付类型 */
     order_payment_type?: 'normal' | 'deposit';
     /** 扩展参数字段 */
-    metadata?: {
-        /** 钱箱 ID */
-        shop_wallet_pass_id?: string;
-        /** 唯一支付号 */
-        unique_payment_number?: string;
-        /** rounding规则 */
-        rounding_rule?: any;
-        /** 实付金额（现金支付时的实际给出金额） */
-        actual_paid_amount?: number;
-        /** 找零金额（现金支付时的找零金额） */
-        change_given_amount?: number;
-    };
+    metadata?: PaymentItemMetadata;
     /** 支付项创建时间 (格式: YYYY-MM-DD HH:mm:ss, 可选，不传则自动生成) */
     created_at?: string;
     /** 支付项更新时间 (格式: YYYY-MM-DD HH:mm:ss, 可选，不传则自动生成) */
@@ -302,6 +302,8 @@ export interface PaymentUpdateFields {
     voucher_id?: string;
     /** 该支付项是否已经同步给后端服务器（只有网络请求成功后才为true） */
     isSynced?: boolean;
+    /** 支付项扩展元数据；更新时与原 metadata 浅合并 */
+    metadata?: PaymentItemMetadata;
     /** 同步错误信息（业务错误时记录错误信息，用于区分"未同步"和"同步失败"） */
     syncError?: {
         error: string;
@@ -338,6 +340,8 @@ export interface CashPayment {
     processCashPayment: (amount: number, orderUuid: string) => Promise<void>;
     /** 获取现金余额 */
     getCashBalance: () => Promise<number>;
+    /** 根据币种面额生成现金快捷金额。 */
+    getRecommendedAmount: (money: number, currency: string) => number[];
 }
 /**
  * Eftpos支付接口
@@ -363,6 +367,56 @@ export interface WalletStoredInitData {
     noApplicableVoucher: any[];
     products: any[];
 }
+export type WalletAssetId = string | number;
+export type WalletAssetSelectionSource = 'manual' | 'scan';
+export type WalletAssetsStatus = 'idle' | 'loading' | 'ready' | 'error';
+/**
+ * 购物车与结账共享的钱包资产状态。
+ *
+ * 原始券字段完整保留在 items / selectedItems 中，Payment 只补充统一的
+ * 可用性、选择和加载状态，不在此层引入 UI ViewModel。
+ */
+export interface WalletAssetsState {
+    status: WalletAssetsStatus;
+    items: any[];
+    selectedIds: WalletAssetId[];
+    selectedItems: any[];
+    committedIds: WalletAssetId[];
+    selectionSources: Record<string, WalletAssetSelectionSource>;
+    totalSelectedAmount: number;
+    customerId?: string | number;
+    error: string | null;
+    revision: number;
+}
+/**
+ * Shared Wallet Assets 的可序列化运行时快照。
+ *
+ * state 供购物车 / Checkout 直接恢复展示与选择；searchResults 和
+ * calculationContext 用于商品变化后继续重验扫码搜索过的 Wallet。
+ */
+export interface WalletAssetsSnapshot {
+    state: WalletAssetsState;
+    searchResults: SearchIdentificationCodeItem[];
+    walletParams: WalletDeductionRecommendParams | null;
+    calculationContext: {
+        orderTotalAmount: number;
+        products: any[];
+    };
+}
+export interface RefreshWalletAssetsOptions {
+    /** 商品/金额变化默认保留并重验选择；客户变化由实现层强制清空。 */
+    preserveSelection?: boolean;
+}
+export interface SelectWalletAssetOptions {
+    selected: boolean;
+    source?: WalletAssetSelectionSource;
+}
+export interface ScanWalletAssetResult {
+    type: SearchIdentificationCodeResult['type'];
+    asset?: any;
+    selected: boolean;
+    state: WalletAssetsState;
+}
 export interface WalletPassPayment {
     /** 生成钱包API默认参数 */
     generateWalletParams: (businessData: WalletInitBusinessData) => WalletDeductionRecommendParams;
@@ -414,6 +468,22 @@ export interface WalletPassPayment {
     processWalletPayment: (amount: number, orderUuid: string, voucherId?: string) => Promise<void>;
     /** 获取钱包余额 */
     getWalletBalance: (voucherId: string) => Promise<number>;
+    /** 刷新购物车/结账共享的钱包资产，刷新本身不会默认选券。 */
+    refreshWalletAssetsFromBusinessAsync: (businessData: WalletInitBusinessData, options?: RefreshWalletAssetsOptions) => Promise<WalletAssetsState>;
+    /** 获取共享钱包资产状态快照。 */
+    getWalletAssetsState: () => WalletAssetsState;
+    /** 导出供 Shared Checkout 跨运行时传递的 Wallet Assets 快照。 */
+    exportWalletAssetsSnapshot: () => WalletAssetsSnapshot;
+    /** 恢复 Shared Checkout 传回的 Wallet Assets 快照。 */
+    importWalletAssetsSnapshot: (snapshot: WalletAssetsSnapshot) => WalletAssetsState;
+    /** 设置单张钱包资产的选择状态并重新计算其实际抵扣额。 */
+    selectWalletAsset: (assetId: WalletAssetId, options: SelectWalletAssetOptions) => WalletAssetsState;
+    /** 精确搜索钱包资产；仅当前券可用时自动选择。 */
+    scanWalletAssetAsync: (code: string) => Promise<ScanWalletAssetResult>;
+    /** 清空未确认的钱包资产选择。 */
+    clearWalletAssetSelection: () => WalletAssetsState;
+    /** 同步订单中已经支付、不可撤销的钱包资产。 */
+    setCommittedWalletAssets: (committedIds: WalletAssetId[], committedAssets?: any[]) => WalletAssetsState;
 }
 /**
  * 支付模块API接口
@@ -606,7 +676,8 @@ export declare enum WalletPassHooks {
     OnSearchIdentificationCodeCompleted = "wallet:onSearchIdentificationCodeCompleted",
     OnWalletInitializationStarted = "wallet:onWalletInitializationStarted",
     OnWalletInitializationCompleted = "wallet:onWalletInitializationCompleted",
-    OnWalletInitializationFailed = "wallet:onWalletInitializationFailed"
+    OnWalletInitializationFailed = "wallet:onWalletInitializationFailed",
+    OnWalletAssetsStateChanged = "wallet:onWalletAssetsStateChanged"
 }
 /**
  * 支付钩子事件（统一接口）

package/dist/modules/Payment/types.js

@@ -40,9 +40,9 @@ export var TaskRunStatus = /*#__PURE__*/function (TaskRunStatus) {
  */
 export var RoundingRule = /*#__PURE__*/function (RoundingRule) {
   RoundingRule["Standard"] = "standard_rounding";
-  RoundingRule["StandardDown"] = "standard_down";
-  RoundingRule["AlwaysUp"] = "always_up";
-  RoundingRule["AlwaysDown"] = "always_down";
+  RoundingRule["StandardDown"] = "standard_rounding_midpoint_down";
+  RoundingRule["AlwaysUp"] = "round_up";
+  RoundingRule["AlwaysDown"] = "round_down";
   return RoundingRule;
 }({});
 
@@ -65,6 +65,8 @@ export var RoundingInterval = /*#__PURE__*/function (RoundingInterval) {
  * 支付方式信息
  */
 
+/** 支付项扩展元数据 */
+
 /**
  * 支付项
  */
@@ -121,6 +123,20 @@ export var RoundingInterval = /*#__PURE__*/function (RoundingInterval) {
  * 钱包支付接口
  */
 
+/**
+ * 购物车与结账共享的钱包资产状态。
+ *
+ * 原始券字段完整保留在 items / selectedItems 中，Payment 只补充统一的
+ * 可用性、选择和加载状态，不在此层引入 UI ViewModel。
+ */
+
+/**
+ * Shared Wallet Assets 的可序列化运行时快照。
+ *
+ * state 供购物车 / Checkout 直接恢复展示与选择；searchResults 和
+ * calculationContext 用于商品变化后继续重验扫码搜索过的 Wallet。
+ */
+
 /**
  * 支付模块API接口
  */
@@ -182,6 +198,7 @@ export var WalletPassHooks = /*#__PURE__*/function (WalletPassHooks) {
   WalletPassHooks["OnWalletInitializationStarted"] = "wallet:onWalletInitializationStarted";
   WalletPassHooks["OnWalletInitializationCompleted"] = "wallet:onWalletInitializationCompleted";
   WalletPassHooks["OnWalletInitializationFailed"] = "wallet:onWalletInitializationFailed";
+  WalletPassHooks["OnWalletAssetsStateChanged"] = "wallet:onWalletAssetsStateChanged";
   return WalletPassHooks;
 }({});
 

package/dist/modules/Payment/walletpass.d.ts

@@ -1,4 +1,4 @@
-import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData } from './types';
+import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData, WalletAssetId, WalletAssetsSnapshot, WalletAssetsState, RefreshWalletAssetsOptions, SelectWalletAssetOptions, ScanWalletAssetResult } from './types';
 import type { PaymentModule } from './index';
 /**
  * 钱包支付实现
@@ -10,12 +10,22 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     private searchResults;
     private walletParams;
     private walletInitData;
+    private walletAssetsState;
+    private walletAssetsRequestSequence;
+    private walletAssetsCalculationContext;
     constructor(paymentModule: PaymentModule);
     /**
      * 发送事件的辅助方法
      * 支持使用WalletPassHooks或PaymentHooks
      */
     private emitEvent;
+    private publishWalletAssetsState;
+    private recalculateWalletAssets;
+    /**
+     * 使用最新订单参数重验扫码搜索过的支付类 Wallet 资产。
+     * 请求失败或暂时无匹配结果时保留旧资产，避免商品变化造成列表闪空。
+     */
+    private revalidateSearchedWalletAssets;
     /**
      * 生成钱包API默认参数
      * 根据业务数据生成标准的钱包API参数，并存储在模块中
@@ -73,6 +83,20 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     searchIdentificationCodeAsync(params: SearchIdentificationCodeParams, config?: {
         noCache?: boolean;
     }): Promise<SearchIdentificationCodeResult>;
+    /**
+     * 刷新购物车与结账共享的钱包资产。
+     *
+     * 与 legacy initializeWalletDataFromBusinessAsync 不同，这里维护选择状态；
+     * 推荐结果只作为可用性/金额计算输入，不会自动成为 selectedIds。
+     */
+    refreshWalletAssetsFromBusinessAsync(businessData: WalletInitBusinessData, options?: RefreshWalletAssetsOptions): Promise<WalletAssetsState>;
+    getWalletAssetsState(): WalletAssetsState;
+    exportWalletAssetsSnapshot(): WalletAssetsSnapshot;
+    importWalletAssetsSnapshot(snapshot: WalletAssetsSnapshot): WalletAssetsState;
+    selectWalletAsset(assetId: WalletAssetId, options: SelectWalletAssetOptions): WalletAssetsState;
+    scanWalletAssetAsync(code: string): Promise<ScanWalletAssetResult>;
+    clearWalletAssetSelection(): WalletAssetsState;
+    setCommittedWalletAssets(committedIds: WalletAssetId[], committedAssets?: any[]): WalletAssetsState;
     processWalletPayment(amount: number, orderUuid: string, voucherId?: string): Promise<void>;
     getWalletBalance(voucherId: string): Promise<number>;
     /**