@pisell/pisellos 2.3.39 → 2.3.41

package/lib/solution/BaseSales/index.js

@@ -40,6 +40,8 @@ var import_decimal = __toESM(require("decimal.js"));
 var import_lodash_es = require("lodash-es");
 var import_types2 = require("../BookingByStep/types");
 var import_utils = require("../../modules/Order/utils");
+var import_payment_utils = require("../../modules/Order/payment-utils");
+var import_payment_number = require("../../utils/payment-number");
 var import_orderCollectionIdentity = require("../../modules/Order/utils/orderCollectionIdentity");
 var import_dayjs = __toESM(require("dayjs"));
 __reExport(BaseSales_exports, require("./types"), module.exports);
@@ -47,6 +49,88 @@ var import_Quotation = require("../../modules/Quotation");
 var import_transformBaseProductToOrderProduct = require("./utils/transformBaseProductToOrderProduct");
 var import_quotationPrice = require("./utils/quotationPrice");
 var SERVER_ORDER_CHANGED_EVENT = "order:onOrdersChanged";
+var WALLET_PAYMENT_CODE_BY_TAG = {
+  product_voucher: "PRODUCTVOUCHER",
+  gift_card: "GIFTCARD",
+  point_card: "POINTCARD"
+};
+function getSharedWalletAssetId(asset) {
+  return (asset == null ? void 0 : asset.id) ?? (asset == null ? void 0 : asset.voucher_id) ?? (asset == null ? void 0 : asset.code);
+}
+function getSharedWalletAssetAmount(asset) {
+  const value = (asset == null ? void 0 : asset.edit_current_amount) ?? (asset == null ? void 0 : asset._available_max_amount) ?? ((asset == null ? void 0 : asset.tag) === "point_card" ? asset == null ? void 0 : asset.recommended_usage_amount : asset == null ? void 0 : asset.available_max_amount) ?? (asset == null ? void 0 : asset.actualDeduction) ?? (asset == null ? void 0 : asset.amount) ?? 0;
+  const amount = Number(value);
+  return Number.isFinite(amount) && amount > 0 ? amount : 0;
+}
+function isRejectedSalesSubmitResult(result) {
+  var _a, _b;
+  const candidates = [
+    result,
+    result == null ? void 0 : result.data,
+    (_a = result == null ? void 0 : result.response) == null ? void 0 : _a.data,
+    (_b = result == null ? void 0 : result.response) == null ? void 0 : _b.body
+  ];
+  return candidates.some((candidate) => {
+    if (!candidate || typeof candidate !== "object")
+      return false;
+    const responseCode = Number(candidate.code ?? candidate.statusCode);
+    if (Number.isFinite(responseCode) && responseCode >= 400)
+      return true;
+    if (candidate.status === false || candidate.success === false || candidate.result === false) {
+      return true;
+    }
+    return ["failed", "error"].includes(
+      String(candidate.status || "").toLowerCase()
+    );
+  });
+}
+function getSalesSubmitErrorMessage(result) {
+  var _a, _b;
+  return (result == null ? void 0 : result.message) || (result == null ? void 0 : result.msg) || ((_a = result == null ? void 0 : result.data) == null ? void 0 : _a.message) || ((_b = result == null ? void 0 : result.data) == null ? void 0 : _b.msg) || "Wallet 支付确认失败";
+}
+function toWalletFundValue(value) {
+  try {
+    return new import_decimal.default(value || 0).toDecimalPlaces(2).toFixed(2);
+  } catch {
+    return "0.00";
+  }
+}
+function subtractWalletFundValue(left, right) {
+  try {
+    return new import_decimal.default(left || 0).minus(right || 0).toDecimalPlaces(2).toFixed(2);
+  } catch {
+    return "0.00";
+  }
+}
+function getSharedWalletPassUseValue(params) {
+  const { asset, amount, paymentMethod } = params;
+  const configuredValue = Number(asset == null ? void 0 : asset.wallet_pass_use_value);
+  if (Number.isFinite(configuredValue) && configuredValue > 0) {
+    return configuredValue;
+  }
+  const isPointCard = (asset == null ? void 0 : asset.tag) === "point_card" || paymentMethod.code === "POINTCARD";
+  const usageUnit = asset == null ? void 0 : asset.wallet_pass_usage_unit;
+  if (isPointCard && (usageUnit == null ? void 0 : usageUnit.points) && (usageUnit == null ? void 0 : usageUnit.price)) {
+    return new import_decimal.default(amount).div(usageUnit.price).mul(usageUnit.points).toDecimalPlaces(2, import_decimal.default.ROUND_DOWN).toNumber();
+  }
+  return amount;
+}
+function buildSharedWalletFundRecord(params) {
+  const { asset, amount, paymentMethod } = params;
+  const isPointCard = (asset == null ? void 0 : asset.tag) === "point_card" || paymentMethod.code === "POINTCARD";
+  const usingBeforeValue = (asset == null ? void 0 : asset.balance_par_value) ?? (asset == null ? void 0 : asset.balance) ?? (asset == null ? void 0 : asset.using_before_value) ?? 0;
+  const walletPassUseValue = getSharedWalletPassUseValue(params);
+  const usingValue = isPointCard ? walletPassUseValue : amount;
+  const walletPassName = (asset == null ? void 0 : asset.wallet_pass_name) || (asset == null ? void 0 : asset.format_title) || (asset == null ? void 0 : asset.product_name) || (asset == null ? void 0 : asset.name) || paymentMethod.name;
+  return {
+    voucher_id: (asset == null ? void 0 : asset.voucher_id) ?? (asset == null ? void 0 : asset.id),
+    wallet_pass_name: walletPassName && typeof walletPassName === "object" ? walletPassName : { default: walletPassName || "" },
+    code: (asset == null ? void 0 : asset.code) || (asset == null ? void 0 : asset.tag),
+    encoded: asset == null ? void 0 : asset.encoded,
+    using_before_value: toWalletFundValue(usingBeforeValue),
+    using_after_value: subtractWalletFundValue(usingBeforeValue, usingValue)
+  };
+}
 function isBaseSalesManualProductDiscountProduct(product) {
   var _a, _b;
   return ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.is_manual_discount) === true || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.is_manual_discount) === 1 || ((product == null ? void 0 : product.discount_list) || []).some((item) => (item == null ? void 0 : item.type) === "product");
@@ -77,6 +161,11 @@ function isBaseSalesHistoricalDiscountEntry(discount) {
     (discount == null ? void 0 : discount.isEditMode) || (discount == null ? void 0 : discount.isDisabled) || (discount == null ? void 0 : discount.order_discount_id) != null
   );
 }
+function getBaseSalesUniqueArrayMetadataKey(key) {
+  if (key === "products" || key === "bookings")
+    return "unique_identification_number";
+  return null;
+}
 var BASE_SALES_PERSISTENT_ID_FIELD_BY_KIND = {
   product: "order_detail_id",
   booking: "schedule_event_id",
@@ -150,6 +239,15 @@ function mergeBaseSalesCollectionItem(kind, currentItem, incomingItem, uidRemaps
   return kind === "product" ? mergeBaseSalesProductSnapshotFields(currentItem, mergedItem) : mergedItem;
 }
 function mergeBaseSalesOrderCollection(kind, currentValue, incomingValue, strategy, uidRemaps) {
+  if (kind === "payment") {
+    return (0, import_payment_utils.mergeOrderPaymentListsByIdentity)(
+      currentValue,
+      incomingValue,
+      strategy === "preserve-local" ? { preserveUnmatchedExisting: true } : {
+        preserveUnmatchedExistingWhen: (payment) => (0, import_payment_utils.isIdentifiedPendingOrderPayment)(payment) || !(0, import_orderCollectionIdentity.getOrderCollectionPersistentId)("payment", payment)
+      }
+    );
+  }
   const currentItems = (0, import_orderCollectionIdentity.normalizeOrderCollection)(kind, currentValue, {
     ensureUid: false
   }).items;
@@ -209,6 +307,35 @@ function normalizeBaseSalesRecordCollections(sourceRecord, options) {
   }
   return normalizedRecord;
 }
+function getBaseSalesMetadataUid(item, metadataKey) {
+  var _a;
+  const uid = ((_a = item == null ? void 0 : item.metadata) == null ? void 0 : _a[metadataKey]) ?? (item == null ? void 0 : item[metadataKey]);
+  if (uid === void 0 || uid === null || uid === "")
+    return null;
+  return String(uid);
+}
+function mergeBaseSalesUniqueArray(currentValue, loadedValue, metadataKey) {
+  const result = [];
+  const indexByUid = /* @__PURE__ */ new Map();
+  const appendOrReplaceByUid = (item) => {
+    const clonedItem = (0, import_lodash_es.cloneDeep)(item);
+    const uid = getBaseSalesMetadataUid(clonedItem, metadataKey);
+    if (!uid) {
+      result.push(clonedItem);
+      return;
+    }
+    const existingIndex = indexByUid.get(uid);
+    if (existingIndex !== void 0) {
+      result[existingIndex] = clonedItem;
+      return;
+    }
+    indexByUid.set(uid, result.length);
+    result.push(clonedItem);
+  };
+  currentValue.forEach(appendOrReplaceByUid);
+  loadedValue.forEach(appendOrReplaceByUid);
+  return result;
+}
 function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, strategy) {
   const normalizedLoadedRecord = normalizeBaseSalesRecordCollections(
     loadedRecord || {},
@@ -237,6 +364,15 @@ function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, str
         );
       }
       if (Array.isArray(currentValue) && Array.isArray(loadedValue)) {
+        if (key === "payments" || key === "payment") {
+          return (0, import_payment_utils.mergeOrderPaymentListsByIdentity)(currentValue, loadedValue, {
+            preserveUnmatchedExisting: true
+          });
+        }
+        const metadataKey = getBaseSalesUniqueArrayMetadataKey(key);
+        if (metadataKey) {
+          return mergeBaseSalesUniqueArray(currentValue, loadedValue, metadataKey);
+        }
         return [
           ...(0, import_lodash_es.cloneDeep)(currentValue),
           ...(0, import_lodash_es.cloneDeep)(loadedValue)
@@ -255,6 +391,18 @@ function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, str
     (0, import_orderCollectionIdentity.applyOrderCollectionUidRemaps)(mergedRecord, uidRemaps)
   );
 }
+function filterPendingPaymentsFromLoadedSalesDetail(sourceRecord) {
+  if (!sourceRecord || typeof sourceRecord !== "object")
+    return sourceRecord;
+  const record = { ...sourceRecord };
+  if (Array.isArray(sourceRecord.payments)) {
+    record.payments = sourceRecord.payments.filter((payment) => !(0, import_payment_utils.isPendingOrderPayment)(payment));
+  }
+  if (Array.isArray(sourceRecord.payment)) {
+    record.payment = sourceRecord.payment.filter((payment) => !(0, import_payment_utils.isPendingOrderPayment)(payment));
+  }
+  return record;
+}
 var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
@@ -266,6 +414,11 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       order: void 0
     };
     this.otherParams = {};
+    /**
+     * 由已在初始化阶段解析过设备短号的业务解决方案写入。
+     * 未设置时，支付编号仍按原逻辑实时读取设备信息。
+     */
+    this.paymentNumberDevicePrefix = null;
     // 当前缓存中已加载的最新 SalesDetail；只读 getter 走它对外暴露详情数据。
     this.currentSalesDetail = null;
     this.discountConfigCacheKey = null;
@@ -277,6 +430,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.autoPaymentSyncTimer = null;
     this.salesDetailLoadInFlightCount = 0;
     this.salesDetailLoadSequence = 0;
+    this.walletAssetsRefreshSequence = 0;
     this.salesDetailHydrateQueue = Promise.resolve();
     this.serverOrderChangeUnsubscribe = null;
     this.serverOrderChangeHydrateInFlight = null;
@@ -796,6 +950,27 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     const coreData = (_f = (_d = (_c = app == null ? void 0 : app.models) == null ? void 0 : _c.getStore) == null ? void 0 : (_e = _d.call(_c)).getDataByModel) == null ? void 0 : _f.call(_e, "core", "core");
     return coreData == null ? void 0 : coreData[key];
   }
+  /**
+   * 复用业务解决方案初始化时已解析的支付设备短号。
+   * 空值会清除缓存，使后续支付恢复实时读取设备信息的兼容路径。
+   */
+  setPaymentNumberDevicePrefix(prefix) {
+    const normalized = String(prefix ?? "").trim();
+    this.paymentNumberDevicePrefix = normalized || null;
+  }
+  getPaymentNumberDevicePrefixSync() {
+    if (!this.appPlugin)
+      return "LOCAL";
+    return (0, import_payment_number.resolvePaymentNumberDevicePrefixFromDeviceId)((key) => this.getAppData(key));
+  }
+  getPaymentNumberDevicePrefixAsync() {
+    if (!this.appPlugin)
+      return Promise.resolve("LOCAL");
+    if (this.paymentNumberDevicePrefix) {
+      return Promise.resolve(this.paymentNumberDevicePrefix);
+    }
+    return (0, import_payment_number.resolvePaymentNumberDevicePrefix)((key) => this.getAppData(key));
+  }
   syncAppDataToTempOrder(tempOrder) {
     const isPriceIncludeTax = this.getAppData("is_price_include_tax");
     const taxCountryCode = this.getAppData("tax_country_code");
@@ -833,9 +1008,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     return isChanged;
   }
   async initialize(core, options = {}) {
-    var _a, _b, _c, _d;
+    var _a, _b;
     this.core = core;
     this.initializeOptions = options || {};
+    this.paymentNumberDevicePrefix = null;
     this.otherParams = options.otherParams || {};
     this.cacheId = (_a = this.otherParams) == null ? void 0 : _a.cacheId;
     this.reusedSharedSubModuleNames.clear();
@@ -843,9 +1019,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.request = core.getPlugin("request");
     this.appPlugin = core.getPlugin("app");
     if (!this.appPlugin) {
+      throw new Error("Checkout 解决方案需要 app 插件支持");
     }
-    const app = (_c = (_b = this.appPlugin) == null ? void 0 : _b.getApp) == null ? void 0 : _c.call(_b);
-    this.logger = app == null ? void 0 : app.logger;
+    const app = this.appPlugin.getApp();
+    this.logger = app.logger;
     const targetCacheData = this.readSessionCacheData();
     const moduleNames = this.getRegisteredModuleNames();
     moduleNames.forEach((step) => {
@@ -870,7 +1047,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     if (this.store.schedule && !this.isScheduleListLoaded(this.store.schedule)) {
       await this.store.schedule.loadAllSchedule();
     }
-    if (this.store.order && typeof ((_d = this.otherParams) == null ? void 0 : _d.enableTempOrderPersist) === "boolean") {
+    if (this.store.order && typeof ((_b = this.otherParams) == null ? void 0 : _b.enableTempOrderPersist) === "boolean") {
       this.store.order.setEnableTempOrderPersist(
         this.otherParams.enableTempOrderPersist
       );
@@ -896,8 +1073,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       }
     });
     this.currentSalesDetail = null;
+    this.paymentNumberDevicePrefix = null;
     this.queuedServerOrderChanges = [];
     this.salesDetailLoadSequence += 1;
+    this.walletAssetsRefreshSequence += 1;
     await this.core.effects.emit(`${this.name}:onDestroy`, {});
     super.destroy();
   }
@@ -929,13 +1108,16 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         const message = loadedRecord && (loadedRecord.message || loadedRecord.msg) || `加载销售详情失败: ${lookup}`;
         throw new Error(message);
       }
-      const remoteRecord = preloadedSalesDetail ?? loadedRecord.data;
+      const remoteRecord = filterPendingPaymentsFromLoadedSalesDetail(
+        preloadedSalesDetail ?? loadedRecord.data
+      );
       const currentTempOrder = params.merge ? this.store.order.getTempOrder() : null;
-      const record = params.merge ? mergeSalesDetailRecordWithTempOrder(
+      const mergedRecord = params.merge ? mergeSalesDetailRecordWithTempOrder(
         currentTempOrder,
         remoteRecord,
         "preserve-local"
       ) : remoteRecord;
+      const record = filterPendingPaymentsFromLoadedSalesDetail(mergedRecord);
       return await this.hydrateLatestLoadedSalesDetail(record, loadSequence);
     } finally {
       this.salesDetailLoadInFlightCount = Math.max(
@@ -1111,6 +1293,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   // 重置 tempOrder 与与上一单强相关的运行态（resource/entryPaxNumber/enabledReservationRuleProducts），
   // 适用于从支付页通过 react-router 跳回继续下单时清理残留数据
   async restoreOrder() {
+    var _a;
     try {
       if (!this.store.order) {
         throw new Error("scanOrder 解决方案需要 order 模块支持");
@@ -1119,6 +1302,12 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       this.currentSalesDetail = null;
       this.discountConfigCacheKey = null;
       this.hasManualDiscountSelection = false;
+      const wallet = (_a = this.store.payment) == null ? void 0 : _a.wallet;
+      if (wallet) {
+        this.walletAssetsRefreshSequence += 1;
+        wallet.clearAllCache();
+        await this.publishWalletAssetsState(wallet.getWalletAssetsState());
+      }
       await this.effectsEmit("onTempOrderReplaced", { tempOrder });
       if (this.syncAppDataToTempOrder(tempOrder) && this.isTempOrderPersistEnabled()) {
         this.store.order.persistTempOrder();
@@ -1711,7 +1900,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("BaseSales 解决方案需要 order 模块支持");
     }
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
-    const smallTicketDataFlag = (params == null ? void 0 : params.smallTicketDataFlag) ?? this.getDefaultCheckoutSmallTicketDataFlag();
     const submitParams = {
       cacheId: this.cacheId,
       platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
@@ -1721,11 +1909,25 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       request_unique_idempotency_token: this.store.order.generateIdempotencyToken(),
       ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
       ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
-      ...smallTicketDataFlag !== void 0 ? { smallTicketDataFlag } : {},
+      ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
       ...(params == null ? void 0 : params.confirmPendingVoucherPayments) !== void 0 ? { confirmPendingVoucherPayments: params.confirmPendingVoucherPayments } : {},
       ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
     };
-    return this.shouldUseCheckoutSyncTask() ? this.store.order.submitTempOrder(submitParams) : this.store.order.submitTempOrderAsync(submitParams);
+    return this.store.order.submitTempOrder(submitParams);
+  }
+  async saveSalesOrderDraft(params) {
+    var _a, _b, _c, _d;
+    if (!this.store.order) {
+      throw new Error("BaseSales 解决方案需要 order 模块支持");
+    }
+    return this.store.order.saveTempOrderAsDraft({
+      cacheId: this.cacheId,
+      platform: (params == null ? void 0 : params.platform) ?? ((_a = this.otherParams) == null ? void 0 : _a.platform),
+      businessCode: (params == null ? void 0 : params.businessCode) || ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      channel: (params == null ? void 0 : params.channel) ?? this.getSubmitOrderSalesChannel(),
+      type: (params == null ? void 0 : params.type) ?? ((_d = this.otherParams) == null ? void 0 : _d.type),
+      ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
+    });
   }
   async submitTempOrderAsync(params) {
     var _a, _b, _c, _d;
@@ -1733,35 +1935,20 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("BaseSales 解决方案需要 order 模块支持");
     }
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
-    const smallTicketDataFlag = (params == null ? void 0 : params.smallTicketDataFlag) ?? this.getDefaultCheckoutSmallTicketDataFlag();
     const submitParams = {
       cacheId: this.cacheId,
       platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
       businessCode: ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
       channel: this.getSubmitOrderSalesChannel(),
       type: (_d = this.otherParams) == null ? void 0 : _d.type,
-      request_unique_idempotency_token: this.store.order.generateIdempotencyToken(),
       ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
       ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
-      ...smallTicketDataFlag !== void 0 ? { smallTicketDataFlag } : {},
+      ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
       ...(params == null ? void 0 : params.confirmPendingVoucherPayments) !== void 0 ? { confirmPendingVoucherPayments: params.confirmPendingVoucherPayments } : {},
       ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
     };
     return this.store.order.submitTempOrderAsync(submitParams);
   }
-  /**
-   * 默认保持 WebPOS 的本地待同步订单模式；需要云端确认后才算成功的渠道可覆盖此策略。
-   * otherParams.checkoutSyncTaskEnabled 优先，便于同一 solution 按入口恢复旧行为。
-   */
-  shouldUseCheckoutSyncTask() {
-    var _a;
-    const configured = (_a = this.otherParams) == null ? void 0 : _a.checkoutSyncTaskEnabled;
-    return typeof configured === "boolean" ? configured : true;
-  }
-  /** 可由特定 solution 为真实 checkout 补充默认收据数据请求。 */
-  getDefaultCheckoutSmallTicketDataFlag() {
-    return void 0;
-  }
   async printLocalOrderReceipt(lookup) {
     var _a, _b, _c, _d, _e, _f, _g;
     if (!this.store.order) {
@@ -1821,7 +2008,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     const channel = params.channel ?? this.getSubmitOrderSalesChannel();
     const syncParams = {
       ...params,
-      checkoutSyncTaskEnabled: this.shouldUseCheckoutSyncTask(),
       ...businessCode !== void 0 ? { businessCode } : {},
       ...channel !== void 0 ? { channel } : {}
     };
@@ -1943,8 +2129,29 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       }
     }
   }
-  /** 追加单个支付项到当前订单。 */
+  /**
+   * 同步兼容入口。无法等待 IoT 短号时，按调用当下的 device_id 或 LOCAL 生成。
+   */
   addOrderPayment(payment) {
+    const hasPaymentNumber = String(
+      payment.payment_number || ""
+    ).trim() !== "";
+    return this.addOrderPaymentWithDevicePrefix(
+      payment,
+      hasPaymentNumber ? "LOCAL" : this.getPaymentNumberDevicePrefixSync()
+    );
+  }
+  /**
+   * 创建新支付项时优先使用业务解决方案初始化阶段缓存的设备短号；
+   * 未缓存的通用 BaseSales 保持实时读取设备信息的兼容语义。
+   */
+  async addOrderPaymentAsync(payment) {
+    const paymentRecord = payment;
+    const hasPaymentNumber = String(paymentRecord.payment_number || "").trim() !== "";
+    const devicePrefix = hasPaymentNumber ? "LOCAL" : await this.getPaymentNumberDevicePrefixAsync();
+    return this.addOrderPaymentWithDevicePrefix(payment, devicePrefix);
+  }
+  addOrderPaymentWithDevicePrefix(payment, devicePrefix) {
     var _a;
     if (!this.store.order)
       throw new Error("order 模块未初始化");
@@ -1961,21 +2168,26 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     if (shopWalletPassId !== void 0 && shopWalletPassId !== null) {
       metadata.shop_wallet_pass_id = shopWalletPassId;
     }
-    if (!metadata.unique_payment_number) {
-      metadata.unique_payment_number = (0, import_utils.createUuidV4)();
-    }
+    const normalizedPaymentRecord = (0, import_payment_utils.ensureOrderPaymentNumber)(
+      paymentRecord,
+      devicePrefix,
+      import_utils.createUuidV4
+    );
     const paymentTimestamp = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
     const paymentTime = paymentRecord.payment_time ?? paymentTimestamp;
     const createdAt = paymentRecord.created_at ?? paymentTimestamp;
     const serviceCharge = paymentRecord.service_charge && typeof paymentRecord.service_charge === "object" ? paymentRecord.service_charge : null;
     const calculatedServiceFee = serviceCharge ? new import_decimal.default(paymentRecord.origin_amount ?? paymentRecord.amount ?? 0).times(serviceCharge.percentage || 0).plus(serviceCharge.amount || 0).toDecimalPlaces(2).toFixed(2) : void 0;
     const payments = this.store.order.addOrderPayment({
-      ...paymentRecord,
+      ...normalizedPaymentRecord,
       ...calculatedServiceFee !== void 0 ? { service_fee: calculatedServiceFee } : {},
       metadata,
       payment_time: paymentTime,
       created_at: createdAt
     });
+    if (paymentRecord.status === "payment_pending") {
+      return payments;
+    }
     const amountSnapshot = this.store.order.getOrderAmountSnapshot();
     const syncState = this.store.order.getOrderSyncState();
     if (amountSnapshot) {
@@ -1997,10 +2209,73 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     return payments;
   }
   /** 更新当前订单中的指定支付项。 */
-  updateOrderPayment(paymentIdentity, updates) {
+  async updateOrderPayment(paymentIdentity, updates, options = {}) {
+    var _a, _b, _c;
     if (!this.store.order)
       throw new Error("order 模块未初始化");
-    return this.store.order.updateOrderPayment(paymentIdentity, updates);
+    const matchMode = options.matchBy === "compat" || options.matchBy === "legacy" ? "compat" : "payment_number";
+    const previousMatch = (0, import_payment_utils.resolveOrderPaymentIdentity)(
+      this.store.order.getOrderPayments(),
+      paymentIdentity,
+      matchMode
+    );
+    const previousPayment = previousMatch == null ? void 0 : previousMatch.payment;
+    if ((previousPayment == null ? void 0 : previousPayment.status) === "paid" && !options.applyUpdatesWhenPaid) {
+      const currentPayments = this.store.order.getOrderPayments();
+      let syncResult2;
+      if (options.submitWhenPaid && options.forceSubmitIfPaid) {
+        syncResult2 = await this.syncPaymentsToOrder({
+          payments: currentPayments,
+          paymentStatus: this.getPaymentStatusForSync(currentPayments),
+          submitWhenPaid: true,
+          smallTicketDataFlag: options.smallTicketDataFlag ?? 1
+        });
+      }
+      return {
+        updated: false,
+        payment: previousPayment,
+        payments: currentPayments,
+        summary: ((_a = this.store.order.getOrderAmountSnapshot()) == null ? void 0 : _a.summary) || null,
+        ...syncResult2 !== void 0 ? { syncResult: syncResult2 } : {}
+      };
+    }
+    const result = await this.store.order.updateOrderPayment(paymentIdentity, updates, {
+      matchBy: matchMode
+    });
+    let draftResult;
+    let draftError;
+    if (options.persistDraft !== false) {
+      try {
+        draftResult = await this.saveSalesOrderDraft();
+      } catch (error) {
+        draftError = error;
+        this.logError("updateOrderPayment: 保存支付草稿失败", {
+          paymentIdentity,
+          error: error instanceof Error ? error.message : String(error)
+        });
+        if (!options.submitWhenPaid)
+          throw error;
+      }
+    }
+    const becamePaid = (previousPayment == null ? void 0 : previousPayment.status) !== "paid" && ((_b = result.payment) == null ? void 0 : _b.status) === "paid";
+    const shouldSubmit = Boolean(
+      options.submitWhenPaid && ((_c = result.payment) == null ? void 0 : _c.status) === "paid" && (becamePaid || options.forceSubmitIfPaid)
+    );
+    let syncResult;
+    if (shouldSubmit) {
+      syncResult = await this.syncPaymentsToOrder({
+        payments: result.payments,
+        paymentStatus: this.getPaymentStatusForSync(result.payments),
+        submitWhenPaid: true,
+        smallTicketDataFlag: options.smallTicketDataFlag ?? 1
+      });
+    }
+    return {
+      ...result,
+      ...draftResult !== void 0 ? { draftResult } : {},
+      ...draftError !== void 0 ? { draftError } : {},
+      ...syncResult !== void 0 ? { syncResult } : {}
+    };
   }
   /** 删除当前订单中的指定支付项。 */
   deleteOrderPayment(paymentIdentity) {
@@ -2014,10 +2289,24 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("order 模块未初始化");
     return this.store.order.updateVoucherOrderPayments(payments, options);
   }
+  async updateVoucherOrderPaymentsAsync(payments, options) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    return this.store.order.updateVoucherOrderPaymentsAsync(payments, options);
+  }
   confirmPendingVoucherPayments() {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
-    return this.store.order.confirmPendingVoucherPayments();
+    const payments = this.store.order.confirmPendingVoucherPayments();
+    if (this.store.payment) {
+      const committed = this.getCommittedWalletAssets();
+      const state = this.store.payment.wallet.setCommittedWalletAssets(
+        committed.ids,
+        committed.assets
+      );
+      void this.publishWalletAssetsState(state);
+    }
+    return payments;
   }
   discardPendingVoucherPayments() {
     if (!this.store.order)
@@ -2078,24 +2367,14 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     });
     return walletProducts;
   }
-  async initWalletData(params) {
-    if (!this.store.order)
-      throw new Error("order 模块未初始化");
-    if (!this.store.payment)
-      throw new Error("payment 模块未初始化");
-    const snapshot = this.store.order.getOrderSnapshot();
+  buildWalletInitBusinessData(params) {
+    var _a;
+    const snapshot = (_a = this.store.order) == null ? void 0 : _a.getOrderSnapshot();
     const tempOrder = snapshot == null ? void 0 : snapshot.tempOrder;
     const amount = snapshot == null ? void 0 : snapshot.amount;
-    if (!tempOrder || !amount) {
-      return {
-        walletRecommendList: [],
-        userIdentificationCodes: [],
-        transformList: [],
-        noApplicableVoucher: [],
-        products: []
-      };
-    }
-    const walletBusinessData = {
+    if (!tempOrder || !amount)
+      return null;
+    return {
       customer_id: tempOrder.customer_id ? Number(tempOrder.customer_id) : void 0,
       holder: tempOrder.holder,
       amountInfo: {
@@ -2109,11 +2388,29 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       is_price_include_tax: tempOrder.is_price_include_tax ?? this.otherParams.is_price_include_tax ?? 1,
       ...snapshot.identity.orderId ? { payment_order_id: String(snapshot.identity.orderId) } : {}
     };
+  }
+  async initWalletData(params) {
+    var _a;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const snapshot = this.store.order.getOrderSnapshot();
+    const walletBusinessData = this.buildWalletInitBusinessData(params);
+    if (!walletBusinessData) {
+      return {
+        walletRecommendList: [],
+        userIdentificationCodes: [],
+        transformList: [],
+        noApplicableVoucher: [],
+        products: []
+      };
+    }
     const result = await this.store.payment.wallet.initializeWalletDataFromBusinessAsync(
       walletBusinessData
     );
     await this.core.effects.emit(`${this.name}:onWalletDataInitialized`, {
-      orderId: snapshot.identity.orderId,
+      orderId: (_a = snapshot == null ? void 0 : snapshot.identity) == null ? void 0 : _a.orderId,
       customerId: walletBusinessData.customer_id,
       walletBusinessData: {
         customer_id: walletBusinessData.customer_id,
@@ -2124,6 +2421,202 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     });
     return result;
   }
+  getCommittedWalletAssets() {
+    var _a, _b;
+    const payments = ((_b = (_a = this.store.order) == null ? void 0 : _a.getOrderPayments) == null ? void 0 : _b.call(_a)) || [];
+    const committed = payments.filter((payment) => {
+      const voucherId = payment == null ? void 0 : payment.voucher_id;
+      if (voucherId === void 0 || voucherId === null || voucherId === 0) {
+        return false;
+      }
+      return (payment == null ? void 0 : payment.status) === "paid" || (payment == null ? void 0 : payment.isSynced) === true || (payment == null ? void 0 : payment.order_payment_id) !== void 0 && (payment == null ? void 0 : payment.order_payment_id) !== null && (payment == null ? void 0 : payment.order_payment_id) !== "";
+    });
+    return {
+      ids: committed.map((payment) => payment.voucher_id),
+      assets: committed.map((payment) => {
+        var _a2;
+        const fundRecord = (payment == null ? void 0 : payment.fund_record) || {};
+        const walletPassName = fundRecord.wallet_pass_name;
+        const title = walletPassName && typeof walletPassName === "object" ? walletPassName.default || Object.values(walletPassName)[0] : walletPassName;
+        const code = String((payment == null ? void 0 : payment.code) || "").toUpperCase();
+        const tag = ((_a2 = Object.entries(WALLET_PAYMENT_CODE_BY_TAG).find(
+          ([, paymentCode]) => paymentCode === code
+        )) == null ? void 0 : _a2[0]) || fundRecord.tag;
+        return {
+          id: payment.voucher_id,
+          voucher_id: payment.voucher_id,
+          code: fundRecord.code,
+          tag,
+          product_name: title || payment.name,
+          name: title || payment.name,
+          amount: Number(payment.amount || 0),
+          _available_max_amount: Number(payment.amount || 0),
+          unified_available_status: 1,
+          _unified_available_status: 1,
+          _committed_payment: payment
+        };
+      })
+    };
+  }
+  async publishWalletAssetsState(state) {
+    await this.effectsEmit(import_types.BaseSalesHookNames.onWalletAssetsStateChanged, {
+      state
+    });
+    return state;
+  }
+  async syncSelectedWalletAssets(state) {
+    if (!this.store.order || !this.store.payment) {
+      throw new Error("订单或支付模块未初始化");
+    }
+    let paymentMethods = this.getPaymentMethods();
+    if (!paymentMethods.length && state.selectedItems.length) {
+      paymentMethods = await this.getPaymentMethodsAsync();
+    }
+    const methodByCode = new Map(
+      paymentMethods.map((method) => [String(method.code || "").toUpperCase(), method])
+    );
+    const preparePayments = this.store.payment.wallet.formatWalletPassList2PreparePayments(
+      state.selectedItems
+    );
+    const selectedAssetById = new Map(
+      state.selectedItems.map((asset) => [
+        String(getSharedWalletAssetId(asset)),
+        asset
+      ])
+    );
+    const voucherPayments = preparePayments.flatMap((item) => {
+      const asset = selectedAssetById.get(String(item.voucher_id));
+      const paymentCode = WALLET_PAYMENT_CODE_BY_TAG[String(item.tag || (asset == null ? void 0 : asset.tag) || "")] || String(item.tag || (asset == null ? void 0 : asset.tag) || "").toUpperCase();
+      const paymentMethod = methodByCode.get(paymentCode);
+      const formattedAmount = Number(item.amount);
+      const amount = Number.isFinite(formattedAmount) && formattedAmount > 0 ? formattedAmount : getSharedWalletAssetAmount(asset);
+      if (!asset || !paymentMethod || !Number.isFinite(amount) || amount <= 0) {
+        return [];
+      }
+      const walletPassUseValue = getSharedWalletPassUseValue({
+        asset,
+        amount,
+        paymentMethod
+      });
+      return [
+        {
+          amount: amount.toFixed(2),
+          code: paymentMethod.code,
+          custom_payment_id: paymentMethod.id,
+          name: paymentMethod.name,
+          type: paymentMethod.type,
+          voucher_id: item.voucher_id,
+          wallet_pass_usage_unit: item.wallet_pass_usage_unit,
+          wallet_pass_use_value: walletPassUseValue,
+          fund_record: buildSharedWalletFundRecord({
+            asset,
+            amount,
+            paymentMethod
+          })
+        }
+      ];
+    });
+    const payments = this.updateVoucherOrderPayments(voucherPayments, {
+      status: "payment_pending"
+    });
+    await this.store.order.recalculateSummary({ createIfMissing: true });
+    return payments;
+  }
+  /** 读取购物车与 Shared Checkout 共用的钱包资产状态。 */
+  getWalletAssetsState() {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    return this.store.payment.wallet.getWalletAssetsState();
+  }
+  /** 导出 Shared Checkout 跨运行时恢复所需的钱包状态与搜索缓存。 */
+  exportWalletAssetsSnapshot() {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    return this.store.payment.wallet.exportWalletAssetsSnapshot();
+  }
+  /**
+   * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
+   */
+  async importWalletAssetsSnapshot(snapshot) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const state = this.store.payment.wallet.importWalletAssetsSnapshot(snapshot);
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
+  /**
+   * 基于当前订单快照刷新钱包资产。商品变化保留并重验选择；客户变化强制清空。
+   */
+  async refreshWalletAssets(params) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const refreshSequence = ++this.walletAssetsRefreshSequence;
+    const wallet = this.store.payment.wallet;
+    const businessData = this.buildWalletInitBusinessData(params);
+    if (!businessData) {
+      wallet.clearAllCache();
+      const emptyState = wallet.getWalletAssetsState();
+      this.updateVoucherOrderPayments([], { status: "payment_pending" });
+      return this.publishWalletAssetsState(emptyState);
+    }
+    const previousState = wallet.getWalletAssetsState();
+    const hasPreviousWalletContext = previousState.status !== "idle" || previousState.items.length > 0 || previousState.selectedIds.length > 0 || previousState.customerId !== void 0;
+    const customerChanged = hasPreviousWalletContext && String(previousState.customerId ?? "") !== String(businessData.customer_id ?? "");
+    if (customerChanged) {
+      const clearedState = wallet.clearWalletAssetSelection();
+      this.updateVoucherOrderPayments([], { status: "payment_pending" });
+      await this.publishWalletAssetsState(clearedState);
+    }
+    const refreshTask = wallet.refreshWalletAssetsFromBusinessAsync(
+      businessData,
+      {
+        preserveSelection: (params == null ? void 0 : params.preserveSelection) !== false && !customerChanged
+      }
+    );
+    await this.publishWalletAssetsState(wallet.getWalletAssetsState());
+    let state = await refreshTask;
+    if (refreshSequence !== this.walletAssetsRefreshSequence) {
+      return wallet.getWalletAssetsState();
+    }
+    if (state.status !== "error") {
+      const committed = this.getCommittedWalletAssets();
+      state = wallet.setCommittedWalletAssets(committed.ids, committed.assets);
+    }
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
+  /** 选择或取消单张钱包资产，并立即同步 pending wallet payments。 */
+  async selectWalletAsset(params) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const state = this.store.payment.wallet.selectWalletAsset(params.assetId, {
+      selected: params.selected,
+      source: params.source
+    });
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
+  /** 扫码精确查券；仅可用资产会被自动选中。 */
+  async scanWalletAsset(code) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const result = await this.store.payment.wallet.scanWalletAssetAsync(code);
+    if (result.type === "normalCode") {
+      await this.syncSelectedWalletAssets(result.state);
+      await this.publishWalletAssetsState(result.state);
+    }
+    return result;
+  }
+  /** 清空全部未确认钱包选择，已支付钱包项由 Order 模块继续保留。 */
+  async clearWalletAssetSelection() {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const state = this.store.payment.wallet.clearWalletAssetSelection();
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
   /**
    * 更新当前订单客户字段。
    *
@@ -2160,29 +2653,349 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   getPaymentMethods() {
     return [...this.paymentMethodsCache];
   }
-  /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
-  roundAmount(params) {
-    const amount = new import_decimal.default(params.amount || 0);
-    const interval = new import_decimal.default(params.interval || 0.05);
-    const rule = params.rule || "standard_rounding";
-    const quotient = amount.div(interval);
-    let roundedQuotient;
-    if (rule === "always_up") {
-      roundedQuotient = quotient.ceil();
-    } else if (rule === "always_down") {
-      roundedQuotient = quotient.floor();
-    } else if (rule === "standard_down") {
-      roundedQuotient = quotient.toDecimalPlaces(0, import_decimal.default.ROUND_HALF_DOWN);
-    } else {
-      roundedQuotient = quotient.toDecimalPlaces(0, import_decimal.default.ROUND_HALF_UP);
+  findCashPaymentMethod(paymentMethods) {
+    return paymentMethods.find((method) => {
+      const identifiers = [method == null ? void 0 : method.code, method == null ? void 0 : method.type, method == null ? void 0 : method.tag].map(
+        (value) => String(value || "").toUpperCase()
+      );
+      return identifiers.includes("CASHMANUAL") && (method == null ? void 0 : method.enabled) !== false && (method == null ? void 0 : method.enable) !== false;
+    });
+  }
+  getPendingWalletPaymentAmount(payments = ((_b) => (_b = ((_a) => (_a = this.store.order) == null ? void 0 : _a.getOrderPayments)()) == null ? void 0 : _b.call(_a))() || []) {
+    return payments.reduce((total, payment) => {
+      if ((payment == null ? void 0 : payment.status) !== "payment_pending" || (payment == null ? void 0 : payment.voucher_id) === void 0 || Number(payment.voucher_id) === 0) {
+        return total;
+      }
+      try {
+        return total.plus(payment.amount || 0).plus(payment.rounding_amount || 0);
+      } catch {
+        return total;
+      }
+    }, new import_decimal.default(0));
+  }
+  /** 读取现金 action 所需的支付方式、待付金额和快捷金额。 */
+  async getCashPaymentConfig() {
+    var _a, _b, _c, _d, _e, _f;
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    let paymentMethods = this.getPaymentMethods();
+    let paymentMethod = this.findCashPaymentMethod(paymentMethods);
+    if (!paymentMethod) {
+      paymentMethods = await this.getPaymentMethodsAsync();
+      paymentMethod = this.findCashPaymentMethod(paymentMethods);
     }
-    const roundedAmount = roundedQuotient.times(interval).toDecimalPlaces(2);
+    const amountSnapshot = (_b = (_a = this.store.order) == null ? void 0 : _a.getOrderAmountSnapshot) == null ? void 0 : _b.call(_a);
+    const pendingWalletAmount = this.getPendingWalletPaymentAmount();
+    const amountDue = import_decimal.default.max(
+      new import_decimal.default((amountSnapshot == null ? void 0 : amountSnapshot.amountGap) || 0).minus(pendingWalletAmount),
+      0
+    ).toDecimalPlaces(2).toNumber();
+    const currency = ((_e = (_d = (_c = this.store.order) == null ? void 0 : _c.getTempOrder) == null ? void 0 : _d.call(_c)) == null ? void 0 : _e.currency_code) || ((_f = this.otherParams) == null ? void 0 : _f.currency) || "USD";
+    const recommendedAmounts = amountDue > 0 ? this.store.payment.cash.getRecommendedAmount(amountDue, currency) : [];
     return {
-      originalAmount: amount.toFixed(2),
-      roundedAmount: roundedAmount.toFixed(2),
-      roundingDifference: roundedAmount.minus(amount).toFixed(2)
+      available: Boolean(paymentMethod && amountDue > 0),
+      paymentMethod,
+      amountDue,
+      recommendedAmounts
     };
   }
+  /**
+   * 确认足额覆盖订单的 pending Wallet 支付并提交订单。
+   *
+   * Order 模块在构造提交参数时将 pending voucher 转为 paid；只有提交成功后
+   * 才同步 Wallet committed 状态。失败时恢复调用前 payments，允许用户重试。
+   */
+  async confirmWalletPayment() {
+    var _a, _b, _c, _d, _e;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const beforePayments = (0, import_lodash_es.cloneDeep)(this.store.order.getOrderPayments());
+    const pendingWalletAmount = this.getPendingWalletPaymentAmount(beforePayments);
+    if (pendingWalletAmount.lte(0)) {
+      throw new Error("当前订单没有待确认的 Wallet 支付");
+    }
+    const amountSnapshot = (_b = (_a = this.store.order).getOrderAmountSnapshot) == null ? void 0 : _b.call(_a);
+    const effectiveAmountDue = import_decimal.default.max(
+      new import_decimal.default((amountSnapshot == null ? void 0 : amountSnapshot.amountGap) || 0).minus(pendingWalletAmount),
+      0
+    );
+    if (effectiveAmountDue.gt(0.01)) {
+      throw new Error("Wallet 支付尚未覆盖全部待支付金额");
+    }
+    const beforePaymentStatus = (_c = this.store.order.getTempOrder()) == null ? void 0 : _c.payment_status;
+    let submitResult;
+    try {
+      submitResult = await this.submitSalesOrder({
+        smallTicketDataFlag: 1,
+        confirmPendingVoucherPayments: true
+      });
+      if (isRejectedSalesSubmitResult(submitResult)) {
+        throw new Error(getSalesSubmitErrorMessage(submitResult));
+      }
+    } catch (error) {
+      this.store.order.setOrderPayments(beforePayments);
+      const restoredTempOrder = this.store.order.getTempOrder();
+      if (restoredTempOrder && beforePaymentStatus !== void 0) {
+        restoredTempOrder.payment_status = beforePaymentStatus;
+        this.store.order.persistTempOrder();
+      }
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      throw error;
+    }
+    if (this.store.payment) {
+      try {
+        const committed = this.getCommittedWalletAssets();
+        const walletState = this.store.payment.wallet.setCommittedWalletAssets(
+          committed.ids,
+          committed.assets
+        );
+        await this.publishWalletAssetsState(walletState);
+      } catch (error) {
+        this.logWarning("confirmWalletPayment: Wallet committed 状态同步失败", {
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    const latestAmountSnapshot = (_e = (_d = this.store.order).getOrderAmountSnapshot) == null ? void 0 : _e.call(_d);
+    return {
+      submitResult,
+      payments: this.store.order.getOrderPayments(),
+      isOrderFullyPaid: new import_decimal.default(
+        (latestAmountSnapshot == null ? void 0 : latestAmountSnapshot.amountGap) || 0
+      ).lte(0)
+    };
+  }
+  /**
+   * 购物车现金直付：写入现金记录并等待支付同步完成。
+   * 同步失败会恢复调用前 payments（包含 Wallet pending 状态）。
+   */
+  async payCash(params) {
+    var _a, _b, _c, _d, _e, _f;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const amount = Number(params.amount || 0);
+    if (!Number.isFinite(amount) || amount <= 0) {
+      throw new Error("现金支付金额必须大于 0");
+    }
+    const config = await this.getCashPaymentConfig();
+    const paymentMethod = config.paymentMethod;
+    if (!paymentMethod)
+      throw new Error("未找到可用的 CASHMANUAL 支付方式");
+    if (config.amountDue <= 0)
+      throw new Error("当前订单没有待支付金额");
+    const roundingAmount = Number(params.roundingAmount || 0);
+    const effectivePaymentAmount = new import_decimal.default(amount).minus(roundingAmount);
+    if (effectivePaymentAmount.gt(new import_decimal.default(config.amountDue).plus(0.01))) {
+      throw new Error("现金支付金额超过当前待支付金额");
+    }
+    const beforePayments = (0, import_lodash_es.cloneDeep)(this.store.order.getOrderPayments());
+    const beforePaymentStatus = (_a = this.store.order.getTempOrder()) == null ? void 0 : _a.payment_status;
+    const uniquePaymentNumber = (0, import_utils.createUuidV4)();
+    const paymentTimestamp = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    const actualPaidAmount = Number(params.actualPaidAmount ?? amount);
+    const changeAmount = Number(params.changeAmount || 0);
+    const shopWalletPassId = (_b = this.otherParams) == null ? void 0 : _b.shop_wallet_pass_id;
+    if (!Number.isFinite(actualPaidAmount) || actualPaidAmount + 0.01 < amount) {
+      throw new Error("顾客实收现金不能小于支付金额");
+    }
+    (_f = (_e = (_d = (_c = this.window) == null ? void 0 : _c.interaction) == null ? void 0 : _d.utils) == null ? void 0 : _e.postMessageToApp) == null ? void 0 : _f.call(_e, {
+      module: "till",
+      key: "open_till",
+      data: { type: "cash" }
+    });
+    const payments = this.store.order.addOrderPayment({
+      amount: amount.toFixed(2),
+      code: paymentMethod.code,
+      custom_payment_id: paymentMethod.id,
+      name: paymentMethod.name,
+      custom_payment_type: paymentMethod.type,
+      voucher_id: 0,
+      rounding_amount: roundingAmount.toFixed(2),
+      metadata: {
+        unique_payment_number: uniquePaymentNumber,
+        ...shopWalletPassId !== void 0 && shopWalletPassId !== null ? { shop_wallet_pass_id: shopWalletPassId } : {},
+        actual_paid_amount: Number.isFinite(actualPaidAmount) ? actualPaidAmount : amount,
+        change_given_amount: Number.isFinite(changeAmount) ? changeAmount : 0
+      },
+      payment_time: paymentTimestamp,
+      created_at: paymentTimestamp
+    });
+    const payment = payments.find(
+      (item) => {
+        var _a2;
+        return ((_a2 = item == null ? void 0 : item.metadata) == null ? void 0 : _a2.unique_payment_number) === uniquePaymentNumber;
+      }
+    );
+    try {
+      const syncResult = await this.syncPaymentsToOrder({
+        payments,
+        submitWhenPaid: true,
+        smallTicketDataFlag: 1,
+        confirmPendingVoucherPayments: true
+      });
+      if (this.store.payment) {
+        const committed = this.getCommittedWalletAssets();
+        const walletState = this.store.payment.wallet.setCommittedWalletAssets(
+          committed.ids,
+          committed.assets
+        );
+        await this.publishWalletAssetsState(walletState);
+      }
+      return {
+        payment: payment || {},
+        payments: this.store.order.getOrderPayments(),
+        syncResult,
+        isOrderFullyPaid: syncResult.isOrderFullyPaid
+      };
+    } catch (error) {
+      this.store.order.setOrderPayments(beforePayments);
+      const restoredTempOrder = this.store.order.getTempOrder();
+      if (restoredTempOrder && beforePaymentStatus !== void 0) {
+        restoredTempOrder.payment_status = beforePaymentStatus;
+        this.store.order.persistTempOrder();
+      }
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      throw error;
+    }
+  }
+  /**
+   * 提交一次已由支付设备确认成功的非 Wallet 支付。
+   *
+   * 与 addOrderPayment 不同，本入口不会启动后台 fire-and-forget 同步；调用方会等待
+   * 本次 payment、当前 pending Wallet 以及订单提交共同完成。任何同步失败都会恢复
+   * 调用前的 payments 与 payment_status，便于 UI 安全解锁并重试。
+   */
+  async commitPaymentMethodPayment(params) {
+    var _a, _b, _c, _d;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const amount = Number(params.amount || 0);
+    if (!Number.isFinite(amount) || amount <= 0) {
+      throw new Error("支付金额必须大于 0");
+    }
+    let paymentMethods = this.getPaymentMethods();
+    const findPaymentMethod = () => {
+      const methodCode = String(params.paymentMethodCode || "").toUpperCase();
+      return paymentMethods.find((method) => {
+        const idMatched = params.paymentMethodId !== void 0 && String(method.id) === String(params.paymentMethodId);
+        const codeMatched = Boolean(methodCode) && String(method.code || "").toUpperCase() === methodCode;
+        return (idMatched || codeMatched) && method.enabled !== false && method.enable !== false;
+      });
+    };
+    let paymentMethod = findPaymentMethod();
+    if (!paymentMethod) {
+      paymentMethods = await this.getPaymentMethodsAsync();
+      paymentMethod = findPaymentMethod();
+    }
+    if (!paymentMethod) {
+      throw new Error(
+        `未找到可用的支付方式：${params.paymentMethodCode || params.paymentMethodId || ""}`
+      );
+    }
+    const amountSnapshot = (_b = (_a = this.store.order).getOrderAmountSnapshot) == null ? void 0 : _b.call(_a);
+    const pendingWalletAmount = this.getPendingWalletPaymentAmount();
+    const amountDue = import_decimal.default.max(
+      new import_decimal.default((amountSnapshot == null ? void 0 : amountSnapshot.amountGap) || 0).minus(pendingWalletAmount),
+      0
+    );
+    if (amountDue.lte(0))
+      throw new Error("当前订单没有待支付金额");
+    if (new import_decimal.default(amount).gt(amountDue.plus(0.01))) {
+      throw new Error("支付金额超过当前待支付金额");
+    }
+    const beforePayments = (0, import_lodash_es.cloneDeep)(this.store.order.getOrderPayments());
+    const beforePaymentStatus = (_c = this.store.order.getTempOrder()) == null ? void 0 : _c.payment_status;
+    const paymentTimestamp = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    const metadata = {
+      ...params.metadata || {},
+      unique_payment_number: ((_d = params.metadata) == null ? void 0 : _d.unique_payment_number) || (0, import_utils.createUuidV4)()
+    };
+    const serviceCharge = params.serviceCharge ? {
+      amount: String(params.serviceCharge.amount || 0),
+      percentage: String(params.serviceCharge.percentage || 0)
+    } : void 0;
+    const serviceFee = serviceCharge ? new import_decimal.default(params.originAmount ?? amount).times(serviceCharge.percentage || 0).plus(serviceCharge.amount || 0).toDecimalPlaces(2).toFixed(2) : void 0;
+    const payments = this.store.order.addOrderPayment({
+      ...params.paymentData || {},
+      amount: amount.toFixed(2),
+      ...params.originAmount !== void 0 ? { origin_amount: Number(params.originAmount).toFixed(2) } : {},
+      code: paymentMethod.code,
+      custom_payment_id: paymentMethod.id,
+      name: paymentMethod.name,
+      custom_payment_type: paymentMethod.type,
+      voucher_id: 0,
+      ...serviceCharge ? { service_charge: serviceCharge } : {},
+      ...serviceFee !== void 0 ? { service_fee: serviceFee } : {},
+      metadata,
+      payment_time: paymentTimestamp,
+      created_at: paymentTimestamp
+    });
+    const payment = payments.find(
+      (item) => {
+        var _a2;
+        return ((_a2 = item == null ? void 0 : item.metadata) == null ? void 0 : _a2.unique_payment_number) === metadata.unique_payment_number;
+      }
+    );
+    try {
+      const syncResult = await this.syncPaymentsToOrder({
+        payments,
+        submitWhenPaid: true,
+        smallTicketDataFlag: 1,
+        confirmPendingVoucherPayments: true
+      });
+      if (this.store.payment) {
+        const committed = this.getCommittedWalletAssets();
+        const walletState = this.store.payment.wallet.setCommittedWalletAssets(
+          committed.ids,
+          committed.assets
+        );
+        await this.publishWalletAssetsState(walletState);
+      }
+      return {
+        payment: payment || {},
+        payments: this.store.order.getOrderPayments(),
+        syncResult,
+        isOrderFullyPaid: syncResult.isOrderFullyPaid
+      };
+    } catch (error) {
+      this.store.order.setOrderPayments(beforePayments);
+      const restoredTempOrder = this.store.order.getTempOrder();
+      if (restoredTempOrder && beforePaymentStatus !== void 0) {
+        restoredTempOrder.payment_status = beforePaymentStatus;
+        this.store.order.persistTempOrder();
+      }
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      throw error;
+    }
+  }
+  /**
+   * 按当前店铺的现金舍入配置计算金额，供现金支付 UI 使用。
+   *
+   * 舍入开关取自 CASHMANUAL 支付方式；舍入规则取自
+   * otherParams.order_rounding_setting，金额算法统一由 PaymentModule 维护。
+   */
+  async roundAmount(params) {
+    var _a, _b, _c;
+    const amount = params.amount;
+    const cashManualPayment = this.paymentMethodsCache.find(
+      (paymentMethod) => paymentMethod.code === "CASHMANUAL"
+    );
+    if (!((_a = cashManualPayment == null ? void 0 : cashManualPayment.metadata) == null ? void 0 : _a.order_rounding_switch)) {
+      return {
+        originalAmount: amount.toString(),
+        roundedAmount: amount.toString(),
+        roundingDifference: "0.00"
+      };
+    }
+    if (!this.payment) {
+      throw new Error("payment 模块未初始化");
+    }
+    return this.payment.roundAmountAsync(
+      amount,
+      (_b = this.otherParams.order_rounding_setting) == null ? void 0 : _b.interval,
+      (_c = this.otherParams.order_rounding_setting) == null ? void 0 : _c.type
+    );
+  }
   /**
    * 发送支付链接。
    *