@pisell/pisellos 0.10.8 → 0.10.9

package/lib/modules/Order/types.d.ts

@@ -1,7 +1,7 @@
 import { CartItem } from '../Cart/types';
 import type { DiscountModule } from '../Discount';
 import type { RulesModule } from '../Rules';
-import type { Discount } from '../Discount/types';
+import type { Discount, VirtualCurrencyAsset } from '../Discount/types';
 import type { UnavailableReason } from '../Rules/types';
 import type { SubmitPayloadEnhancer } from './utils';
 import type { PaymentItem } from '../Payment/types';
@@ -194,6 +194,7 @@ export interface OrderProduct extends OrderProductIdentity {
     gift_card?: number;
     selling_price: string;
     original_price: string;
+    payment_price?: string;
     tax_fee: string;
     is_charge_tax: number;
     discount_list: OrderProductDiscountItem[];
@@ -275,6 +276,7 @@ export interface OrderTempOrder {
     products: OrderProduct[];
     bookings: any[];
     payments: any[];
+    refunds?: any[];
     surcharges: any[];
     discount_list?: any[];
     relation_forms: any[];
@@ -312,6 +314,7 @@ export interface OrderState {
     syncState?: OrderSyncState;
     discountList: any[];
     availableWalletIds?: number[];
+    virtualCurrencyList?: VirtualCurrencyAsset[];
     discount: DiscountModule | null;
     rules: RulesModule | null;
 }
@@ -709,6 +712,8 @@ export interface OrderModuleAPI {
     addNewOrder: () => Promise<OrderTempOrder>;
     restoreOrder: () => OrderTempOrder;
     getOrderProducts: () => OrderProduct[];
+    getVirtualCurrencyList: () => VirtualCurrencyAsset[];
+    clearOrderForSettlementSwitch: () => Promise<OrderTempOrder>;
     getOrderSummary: () => Promise<OrderSummary>;
     recalculateSummary: (options?: {
         createIfMissing?: boolean;

package/lib/modules/Order/utils/virtualSettlement.d.ts

@@ -0,0 +1,56 @@
+import type { OrderProduct, OrderTempOrder } from '../types';
+export interface SelectedSettlementSnapshot extends Record<string, any> {
+    settlement_type: 'legal_currency' | 'virtual_currency';
+    currency_product_id?: number;
+    price: string | number;
+    unit_label?: any;
+    symbol?: any;
+    amount_format?: string;
+}
+export interface LegalCurrencySnapshot {
+    currency_code: string;
+    currency_symbol: string;
+    currency_format: string;
+}
+export declare function resolveSettlementDisplayValue(value: unknown): string;
+export declare class OrderSettlementConflictError extends Error {
+    readonly currentSettlementKey: string;
+    readonly incomingSettlementKey: string;
+    readonly code = "ORDER_SETTLEMENT_CONFLICT";
+    constructor(currentSettlementKey: string, incomingSettlementKey: string);
+}
+export declare class VirtualCurrencyAssetNotFoundError extends Error {
+    readonly currencyProductId: number;
+    readonly code = "VIRTUAL_CURRENCY_ASSET_NOT_FOUND";
+    constructor(currencyProductId: number);
+}
+export declare class VirtualCurrencyBalanceError extends Error {
+    readonly balance: string;
+    readonly requiredAmount: string;
+    readonly code = "VIRTUAL_CURRENCY_BALANCE_INSUFFICIENT";
+    constructor(balance: string, requiredAmount: string);
+}
+export declare function getSelectedSettlementSnapshot(product: Partial<OrderProduct> | null | undefined): SelectedSettlementSnapshot | null;
+export declare function getTempOrderSettlementSnapshot(tempOrder: OrderTempOrder | null | undefined): SelectedSettlementSnapshot | null;
+export declare function isVirtualSettlementProduct(product: Partial<OrderProduct> | null | undefined): boolean;
+export declare function getSettlementKey(snapshot: SelectedSettlementSnapshot | null | undefined): string | null;
+export declare function getTempOrderSettlementKey(tempOrder: OrderTempOrder | null | undefined): string | null;
+export declare function isVirtualSettlementOrder(tempOrder: OrderTempOrder | null | undefined): boolean;
+/**
+ * 详情展示识别同时支持已提交订单的 currency_settlement_config。
+ * cart_settlement_* 是交易过程内部状态，服务端详情不保证返回。
+ */
+export declare function isVirtualSettlementDisplayOrder(tempOrder: OrderTempOrder | null | undefined): boolean;
+/**
+ * 将购物车锁定的结算单位提升为订单级状态。
+ * 商品行快照只负责价格归一化；展示与提交统一读取 tempOrder.currency_*。
+ */
+export declare function applyTempOrderSettlementState(tempOrder: OrderTempOrder, snapshot: SelectedSettlementSnapshot): void;
+/** 清空购物车结算锁，并恢复进入虚拟币结算前的店铺法币。 */
+export declare function releaseTempOrderSettlementState(tempOrder: OrderTempOrder): void;
+/**
+ * 将已选择虚拟币的订单商品行固化为最终价语义。
+ * 函数幂等，可安全用于加车、合并、hydrate 和提交前兜底。
+ */
+export declare function normalizeVirtualSettlementOrderProduct<T extends Partial<OrderProduct>>(product: T): T;
+export declare function normalizeVirtualSettlementProducts<T extends Partial<OrderProduct>>(products: T[]): T[];

package/lib/modules/Order/utils/virtualSettlement.js

@@ -0,0 +1,300 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Order/utils/virtualSettlement.ts
+var virtualSettlement_exports = {};
+__export(virtualSettlement_exports, {
+  OrderSettlementConflictError: () => OrderSettlementConflictError,
+  VirtualCurrencyAssetNotFoundError: () => VirtualCurrencyAssetNotFoundError,
+  VirtualCurrencyBalanceError: () => VirtualCurrencyBalanceError,
+  applyTempOrderSettlementState: () => applyTempOrderSettlementState,
+  getSelectedSettlementSnapshot: () => getSelectedSettlementSnapshot,
+  getSettlementKey: () => getSettlementKey,
+  getTempOrderSettlementKey: () => getTempOrderSettlementKey,
+  getTempOrderSettlementSnapshot: () => getTempOrderSettlementSnapshot,
+  isVirtualSettlementDisplayOrder: () => isVirtualSettlementDisplayOrder,
+  isVirtualSettlementOrder: () => isVirtualSettlementOrder,
+  isVirtualSettlementProduct: () => isVirtualSettlementProduct,
+  normalizeVirtualSettlementOrderProduct: () => normalizeVirtualSettlementOrderProduct,
+  normalizeVirtualSettlementProducts: () => normalizeVirtualSettlementProducts,
+  releaseTempOrderSettlementState: () => releaseTempOrderSettlementState,
+  resolveSettlementDisplayValue: () => resolveSettlementDisplayValue
+});
+module.exports = __toCommonJS(virtualSettlement_exports);
+var import_decimal = __toESM(require("decimal.js"));
+function resolveSettlementDisplayValue(value) {
+  if (value === void 0 || value === null)
+    return "";
+  if (typeof value === "string" || typeof value === "number") {
+    return String(value);
+  }
+  const localized = value;
+  return String(
+    localized.auto ?? localized.default ?? localized.original ?? localized.en ?? localized["zh-CN"] ?? localized["zh-HK"] ?? ""
+  );
+}
+var OrderSettlementConflictError = class extends Error {
+  constructor(currentSettlementKey, incomingSettlementKey) {
+    super("Different currencies and WalletPass units cannot be mixed in one cart.");
+    this.currentSettlementKey = currentSettlementKey;
+    this.incomingSettlementKey = incomingSettlementKey;
+    this.code = "ORDER_SETTLEMENT_CONFLICT";
+    this.name = "OrderSettlementConflictError";
+  }
+};
+var VirtualCurrencyAssetNotFoundError = class extends Error {
+  constructor(currencyProductId) {
+    super("No matching virtual currency card is available.");
+    this.currencyProductId = currencyProductId;
+    this.code = "VIRTUAL_CURRENCY_ASSET_NOT_FOUND";
+    this.name = "VirtualCurrencyAssetNotFoundError";
+  }
+};
+var VirtualCurrencyBalanceError = class extends Error {
+  constructor(balance, requiredAmount) {
+    super("Insufficient virtual currency balance.");
+    this.balance = balance;
+    this.requiredAmount = requiredAmount;
+    this.code = "VIRTUAL_CURRENCY_BALANCE_INSUFFICIENT";
+    this.name = "VirtualCurrencyBalanceError";
+  }
+};
+function getSelectedSettlementSnapshot(product) {
+  var _a;
+  const snapshot = (_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.selected_settlement_snapshot;
+  if (!snapshot || typeof snapshot !== "object")
+    return null;
+  if (snapshot.settlement_type !== "legal_currency" && snapshot.settlement_type !== "virtual_currency") {
+    return null;
+  }
+  return snapshot;
+}
+function getTempOrderSettlementSnapshot(tempOrder) {
+  var _a, _b;
+  const snapshot = (_a = tempOrder == null ? void 0 : tempOrder.metadata) == null ? void 0 : _a.cart_settlement_snapshot;
+  if (snapshot && typeof snapshot === "object" && (snapshot.settlement_type === "legal_currency" || snapshot.settlement_type === "virtual_currency")) {
+    return snapshot;
+  }
+  return getSelectedSettlementSnapshot((_b = tempOrder == null ? void 0 : tempOrder.products) == null ? void 0 : _b[0]);
+}
+function isVirtualSettlementProduct(product) {
+  var _a;
+  return ((_a = getSelectedSettlementSnapshot(product)) == null ? void 0 : _a.settlement_type) === "virtual_currency";
+}
+function getSettlementKey(snapshot) {
+  if (!snapshot)
+    return null;
+  if (snapshot.settlement_type === "legal_currency")
+    return "legal_currency";
+  const currencyProductId = Number(snapshot.currency_product_id);
+  return Number.isFinite(currencyProductId) && currencyProductId > 0 ? `virtual_currency:${currencyProductId}` : null;
+}
+function getTempOrderSettlementKey(tempOrder) {
+  var _a, _b;
+  if (!((_a = tempOrder == null ? void 0 : tempOrder.products) == null ? void 0 : _a.length))
+    return null;
+  const storedKey = (_b = tempOrder.metadata) == null ? void 0 : _b.cart_settlement_key;
+  if (typeof storedKey === "string" && storedKey)
+    return storedKey;
+  return getSettlementKey(getTempOrderSettlementSnapshot(tempOrder)) || "legal_currency";
+}
+function isVirtualSettlementOrder(tempOrder) {
+  var _a;
+  return ((_a = getTempOrderSettlementKey(tempOrder)) == null ? void 0 : _a.startsWith("virtual_currency:")) === true;
+}
+function isVirtualSettlementDisplayOrder(tempOrder) {
+  var _a, _b;
+  return ((_b = (_a = tempOrder == null ? void 0 : tempOrder.metadata) == null ? void 0 : _a.currency_settlement_config) == null ? void 0 : _b.settlement_type) === "virtual_currency" || isVirtualSettlementOrder(tempOrder);
+}
+function getLegalCurrencySnapshot(tempOrder) {
+  var _a;
+  const snapshot = (_a = tempOrder.metadata) == null ? void 0 : _a.legal_currency_snapshot;
+  if (!snapshot || typeof snapshot !== "object")
+    return null;
+  return {
+    currency_code: String(snapshot.currency_code || ""),
+    currency_symbol: String(snapshot.currency_symbol || ""),
+    currency_format: String(snapshot.currency_format || "symbol_first")
+  };
+}
+function captureLegalCurrencySnapshot(tempOrder) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  if (getLegalCurrencySnapshot(tempOrder))
+    return;
+  tempOrder.metadata.legal_currency_snapshot = {
+    currency_code: String(tempOrder.currency_code || ""),
+    currency_symbol: String(tempOrder.currency_symbol || ""),
+    currency_format: String(tempOrder.currency_format || "symbol_first")
+  };
+}
+function applyTempOrderSettlementState(tempOrder, snapshot) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  const settlementKey = getSettlementKey(snapshot) || "legal_currency";
+  if (snapshot.settlement_type === "virtual_currency") {
+    captureLegalCurrencySnapshot(tempOrder);
+    const currencyProductId = Number(snapshot.currency_product_id);
+    tempOrder.metadata.currency_settlement_config = {
+      settlement_type: "virtual_currency",
+      settlement_ids: Number.isFinite(currencyProductId) && currencyProductId > 0 ? [currencyProductId] : []
+    };
+  } else {
+    delete tempOrder.metadata.currency_settlement_config;
+  }
+  tempOrder.metadata.cart_settlement_key = settlementKey;
+  tempOrder.metadata.cart_settlement_snapshot = { ...snapshot };
+  tempOrder.currency_code = resolveSettlementDisplayValue(snapshot.unit_label) || tempOrder.currency_code;
+  tempOrder.currency_symbol = resolveSettlementDisplayValue(snapshot.symbol) || tempOrder.currency_symbol;
+  tempOrder.currency_format = String(
+    snapshot.amount_format || tempOrder.currency_format || "symbol_first"
+  );
+}
+function releaseTempOrderSettlementState(tempOrder) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  const legalCurrency = getLegalCurrencySnapshot(tempOrder);
+  if (legalCurrency) {
+    tempOrder.currency_code = legalCurrency.currency_code;
+    tempOrder.currency_symbol = legalCurrency.currency_symbol;
+    tempOrder.currency_format = legalCurrency.currency_format;
+  }
+  delete tempOrder.metadata.cart_settlement_key;
+  delete tempOrder.metadata.cart_settlement_snapshot;
+  delete tempOrder.metadata.currency_settlement_config;
+}
+function toMoney(value) {
+  try {
+    return new import_decimal.default(String(value ?? 0)).toDecimalPlaces(2).toFixed(2);
+  } catch {
+    return "0.00";
+  }
+}
+function zeroOptions(options) {
+  if (!Array.isArray(options))
+    return [];
+  return options.map((option) => ({
+    ...option,
+    add_price: 0
+  }));
+}
+function zeroBundles(bundles) {
+  if (!Array.isArray(bundles))
+    return [];
+  return bundles.map((bundle) => ({
+    ...bundle,
+    price: 0,
+    custom_price: 0,
+    bundle_selling_price: 0,
+    bundle_payment_price: 0,
+    surcharge_fee: 0,
+    tax_fee: 0,
+    original_tax_fee: 0,
+    is_charge_tax: 0,
+    discount_list: [],
+    relation_surcharge_ids: [],
+    option: zeroOptions(bundle == null ? void 0 : bundle.option),
+    metadata: {
+      ...(bundle == null ? void 0 : bundle.metadata) || {},
+      surcharge_fee: "0.00",
+      relation_surcharge_ids: [],
+      product_discount_difference: "",
+      tax_fee_rounding_remainder: "0.00",
+      surcharge_rounding_remainder: "0.00"
+    }
+  }));
+}
+function normalizeVirtualSettlementOrderProduct(product) {
+  var _a;
+  const snapshot = getSelectedSettlementSnapshot(product);
+  if ((snapshot == null ? void 0 : snapshot.settlement_type) !== "virtual_currency")
+    return product;
+  const virtualPrice = toMoney(snapshot.price);
+  const metadata = {
+    ...product.metadata || {},
+    source_product_price: virtualPrice,
+    main_product_original_price: virtualPrice,
+    main_product_selling_price: virtualPrice,
+    main_product_attached_bundle_selling_price: virtualPrice,
+    main_product_attached_bundle_payment_price: virtualPrice,
+    main_product_attached_bundle_surcharge_fee: "0.00",
+    main_product_attached_bundle_tax_fee: "0.00",
+    surcharge_rounding_remainder: "0.00",
+    tax_fee_rounding_remainder: "0.00",
+    relation_surcharge_ids: [],
+    average_discount_amount_rate: "1",
+    product_discount_difference: "",
+    discountable_flag: 0,
+    price_schema_version: 2,
+    selected_settlement_snapshot: {
+      ...snapshot,
+      price: virtualPrice
+    }
+  };
+  return {
+    ...product,
+    selling_price: virtualPrice,
+    original_price: virtualPrice,
+    payment_price: virtualPrice,
+    discount_list: [],
+    is_charge_tax: 0,
+    tax_fee: "0.00",
+    original_tax_fee: 0,
+    tax_fee_rounding_remainder: 0,
+    original_tax_fee_rounding_remainder: 0,
+    surcharge_fee: "0.00",
+    surcharge_rounding_remainder: 0,
+    relation_surcharge_ids: [],
+    product_sku: {
+      ...product.product_sku || {},
+      option: zeroOptions((_a = product.product_sku) == null ? void 0 : _a.option)
+    },
+    product_bundle: zeroBundles(product.product_bundle),
+    metadata
+  };
+}
+function normalizeVirtualSettlementProducts(products) {
+  return (products || []).map(
+    (product) => normalizeVirtualSettlementOrderProduct(product)
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OrderSettlementConflictError,
+  VirtualCurrencyAssetNotFoundError,
+  VirtualCurrencyBalanceError,
+  applyTempOrderSettlementState,
+  getSelectedSettlementSnapshot,
+  getSettlementKey,
+  getTempOrderSettlementKey,
+  getTempOrderSettlementSnapshot,
+  isVirtualSettlementDisplayOrder,
+  isVirtualSettlementOrder,
+  isVirtualSettlementProduct,
+  normalizeVirtualSettlementOrderProduct,
+  normalizeVirtualSettlementProducts,
+  releaseTempOrderSettlementState,
+  resolveSettlementDisplayValue
+});

package/lib/modules/Order/utils.js

@@ -705,7 +705,7 @@ function normalizeSubmitPlatform(platform) {
     return "H5";
   return value;
 }
-function formatSubmitOptionItems(options) {
+function formatSubmitOptionItems(options, formatOptions = {}) {
   if (!Array.isArray(options))
     return [];
   return options.map((d) => {
@@ -716,8 +716,11 @@ function formatSubmitOptionItems(options) {
       option_group_id: d == null ? void 0 : d.option_group_id
     };
     const addPrice = (d == null ? void 0 : d.add_price) ?? (d == null ? void 0 : d.price);
-    if (addPrice !== void 0)
+    if (formatOptions.virtualSettlementMode) {
+      option.add_price = 0;
+    } else if (addPrice !== void 0) {
       option.add_price = String(addPrice);
+    }
     delete option.price;
     return option;
   });
@@ -734,7 +737,7 @@ function toMoneyString(value) {
     return "0.00";
   return String(value);
 }
-function formatSubmitBundleItems(bundle) {
+function formatSubmitBundleItems(bundle, formatOptions = {}) {
   if (!Array.isArray(bundle))
     return [];
   return bundle.map((b) => {
@@ -744,9 +747,9 @@ function formatSubmitBundleItems(bundle) {
       custom_product_bundle_map_id: _customProductBundleMapId,
       ...submitMetadata
     } = existedMetadata;
-    const sellingPrice = getBundleSellingMagnitude(rawBundle).toFixed(2);
-    const paymentPrice = rawBundle.bundle_payment_price !== void 0 && rawBundle.bundle_payment_price !== null && rawBundle.bundle_payment_price !== "" ? toMoneyString(rawBundle.bundle_payment_price) : sellingPrice;
-    const priceValue = rawBundle.price ?? rawBundle.custom_price ?? rawBundle.bundle_selling_price;
+    const sellingPrice = formatOptions.virtualSettlementMode ? "0.00" : getBundleSellingMagnitude(rawBundle).toFixed(2);
+    const paymentPrice = formatOptions.virtualSettlementMode ? "0.00" : rawBundle.bundle_payment_price !== void 0 && rawBundle.bundle_payment_price !== null && rawBundle.bundle_payment_price !== "" ? toMoneyString(rawBundle.bundle_payment_price) : sellingPrice;
+    const priceValue = formatOptions.virtualSettlementMode ? 0 : rawBundle.price ?? rawBundle.custom_price ?? rawBundle.bundle_selling_price;
     const relationSurchargeIds = Array.isArray(rawBundle.relation_surcharge_ids) ? rawBundle.relation_surcharge_ids : Array.isArray(existedMetadata.relation_surcharge_ids) ? existedMetadata.relation_surcharge_ids : [];
     const surchargeFee = toMoneyString(
       rawBundle.surcharge_fee ?? existedMetadata.surcharge_fee
@@ -759,7 +762,7 @@ function formatSubmitBundleItems(bundle) {
     const bundleMapId = resolveSubmitBundleMapId(rawBundle);
     const hasSubmitBundleDiscounts = Array.isArray(rawBundle.discount_list) && rawBundle.discount_list.length > 0;
     return {
-      is_charge_tax: rawBundle.is_charge_tax ?? 0,
+      is_charge_tax: formatOptions.virtualSettlementMode ? 0 : rawBundle.is_charge_tax ?? 0,
       bundle_variant_id: rawBundle.bundle_variant_id ?? 0,
       num,
       quantity: toBundleNumber(rawBundle.quantity ?? rawBundle.num, num),
@@ -770,7 +773,7 @@ function formatSubmitBundleItems(bundle) {
       price_type_ext: rawBundle.price_type_ext ?? rawBundle.custom_price_type_ext ?? "",
       bundle_selling_price: sellingPrice,
       bundle_payment_price: paymentPrice,
-      option: formatSubmitOptionItems(rawBundle.option),
+      option: formatSubmitOptionItems(rawBundle.option, formatOptions),
       bundle_group_id: (rawBundle == null ? void 0 : rawBundle.bundle_group_id) ?? (rawBundle == null ? void 0 : rawBundle.group_id),
       bundle_id: (rawBundle == null ? void 0 : rawBundle.bundle_id) ?? (rawBundle == null ? void 0 : rawBundle.id),
       bundle_product_id: (rawBundle == null ? void 0 : rawBundle.bundle_product_id) ?? (rawBundle == null ? void 0 : rawBundle._bundle_product_id),
@@ -778,15 +781,15 @@ function formatSubmitBundleItems(bundle) {
       metadata: {
         ...submitMetadata,
         ...hasSubmitBundleDiscounts && bundleMapId !== void 0 ? { custom_product_bundle_map_id: bundleMapId } : {},
-        surcharge_fee: surchargeFee,
-        relation_surcharge_ids: relationSurchargeIds,
-        product_discount_difference: productDiscountDifference
+        surcharge_fee: formatOptions.virtualSettlementMode ? "0.00" : surchargeFee,
+        relation_surcharge_ids: formatOptions.virtualSettlementMode ? [] : relationSurchargeIds,
+        product_discount_difference: formatOptions.virtualSettlementMode ? "" : productDiscountDifference
       }
     };
   });
 }
-function normalizeSubmitProduct(product) {
-  var _a;
+function normalizeSubmitProduct(product, formatOptions = {}) {
+  var _a, _b;
   const { unique_identification_number: _runtimeUid, ...submitProduct } = product;
   const {
     num,
@@ -801,6 +804,8 @@ function normalizeSubmitProduct(product) {
   delete productRest[`product_${"option"}_item`];
   const rawMetadata = submitProduct.metadata || {};
   const bookingUid = rawMetadata.booking_uid;
+  const hasProductBundle = Array.isArray(submitProduct.product_bundle) && submitProduct.product_bundle.length > 0;
+  const bundleEdit = submitProduct.bundle_edit ?? rawMetadata.bundle_edit ?? (hasProductBundle ? 0 : void 0);
   const cleanMetadata = {};
   if (rawMetadata.unique_identification_number) {
     cleanMetadata.unique_identification_number = rawMetadata.unique_identification_number;
@@ -818,8 +823,10 @@ function normalizeSubmitProduct(product) {
     "tax_fee_rounding_remainder",
     "relation_surcharge_ids",
     "discountable_flag",
+    "price_schema_version",
     "parent_unique_identification_number",
-    "product_add_schedule_time"
+    "product_add_schedule_time",
+    "data_variant_ids"
   ];
   for (const key of priceMetaKeys) {
     if (rawMetadata[key] !== void 0) {
@@ -836,21 +843,54 @@ function normalizeSubmitProduct(product) {
   if (rawMetadata.holder_config !== void 0) {
     cleanMetadata.holder_config = rawMetadata.holder_config;
   }
+  const virtualPrice = toMoneyString(
+    ((_a = rawMetadata.selected_settlement_snapshot) == null ? void 0 : _a.price) ?? submitProduct.selling_price
+  );
+  if (formatOptions.virtualSettlementMode) {
+    Object.assign(cleanMetadata, {
+      source_product_price: virtualPrice,
+      main_product_original_price: virtualPrice,
+      main_product_selling_price: virtualPrice,
+      main_product_attached_bundle_selling_price: virtualPrice,
+      main_product_attached_bundle_payment_price: virtualPrice,
+      main_product_attached_bundle_surcharge_fee: "0.00",
+      main_product_attached_bundle_tax_fee: "0.00",
+      surcharge_rounding_remainder: "0.00",
+      tax_fee_rounding_remainder: "0.00",
+      relation_surcharge_ids: [],
+      average_discount_amount_rate: "1",
+      product_discount_difference: "",
+      discountable_flag: 0,
+      price_schema_version: 2
+    });
+  }
   const productSku = {
     ...submitProduct.product_sku && typeof submitProduct.product_sku === "object" ? submitProduct.product_sku : {},
-    option: formatSubmitOptionItems((_a = submitProduct.product_sku) == null ? void 0 : _a.option)
+    option: formatSubmitOptionItems(
+      (_b = submitProduct.product_sku) == null ? void 0 : _b.option,
+      formatOptions
+    )
   };
   return {
     ...productRest,
+    ...formatOptions.virtualSettlementMode ? {
+      selling_price: virtualPrice,
+      original_price: virtualPrice,
+      is_charge_tax: 0
+    } : {},
     ...bookingUid ? { booking_uid: bookingUid } : {},
+    ...bundleEdit !== void 0 ? { bundle_edit: bundleEdit } : {},
     product_quantity: toBundleNumber(num ?? submitProduct.product_quantity, 1),
     product_sku: productSku,
-    discount_list: collectSubmitProductDiscountList(submitProduct),
-    product_bundle: formatSubmitBundleItems(submitProduct.product_bundle),
+    discount_list: formatOptions.virtualSettlementMode ? [] : collectSubmitProductDiscountList(submitProduct),
+    product_bundle: formatSubmitBundleItems(
+      submitProduct.product_bundle,
+      formatOptions
+    ),
     metadata: cleanMetadata,
     // 出站兼容：后端消费 payment_price 字段（行 composite 已减整单折扣均摊）。
     // 由整单折扣均摊层产出；缺省（无折扣）时与 selling_price 同义。
-    payment_price: submitProduct.payment_price ?? submitProduct.selling_price
+    payment_price: formatOptions.virtualSettlementMode ? virtualPrice : submitProduct.payment_price ?? submitProduct.selling_price
   };
 }
 var SUBMIT_BOOKING_METADATA_WHITELIST = [
@@ -953,7 +993,7 @@ function createDefaultTempOrder(params) {
   };
 }
 function buildSubmitPayload(params) {
-  var _a;
+  var _a, _b, _c;
   const {
     tempOrder,
     cacheId,
@@ -967,6 +1007,7 @@ function buildSubmitPayload(params) {
   } = params;
   const scheduleDate = tempOrder.schedule_date || tempOrder.created_at || formatDateTime(now);
   const bookingUuid = (0, import_orderCollectionIdentity.createUuidV4)();
+  const virtualSettlementMode = ((_b = (_a = tempOrder.metadata) == null ? void 0 : _a.currency_settlement_config) == null ? void 0 : _b.settlement_type) === "virtual_currency";
   const {
     _extend,
     relation_id: _relationId,
@@ -990,7 +1031,7 @@ function buildSubmitPayload(params) {
   } = tempOrder;
   let submitType = type ?? tempOrder.type;
   if (!submitType) {
-    if ((_a = tempOrder == null ? void 0 : tempOrder.bookings) == null ? void 0 : _a.length) {
+    if ((_c = tempOrder == null ? void 0 : tempOrder.bookings) == null ? void 0 : _c.length) {
       submitType = "appointment_booking";
     } else {
       submitType = "virtual";
@@ -1038,12 +1079,15 @@ function buildSubmitPayload(params) {
       const {
         collect_pax: _collectPax,
         table_occupancy_duration: _tableOccupancyDuration,
+        cart_settlement_key: _cartSettlementKey,
+        cart_settlement_snapshot: _cartSettlementSnapshot,
+        legal_currency_snapshot: _legalCurrencySnapshot,
         ...rest
       } = tempOrder.metadata || {};
       return { ...rest };
     })(),
     products: (tempOrder.products || []).map(
-      (product) => normalizeSubmitProduct(product)
+      (product) => normalizeSubmitProduct(product, { virtualSettlementMode })
     )
   };
   if (!enhance)

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

@@ -486,6 +486,8 @@ export interface WalletPassPayment {
     importWalletAssetsSnapshot: (snapshot: WalletAssetsSnapshot) => WalletAssetsState;
     /** 设置单张钱包资产的选择状态并重新计算其实际抵扣额。 */
     selectWalletAsset: (assetId: WalletAssetId, options: SelectWalletAssetOptions) => WalletAssetsState;
+    /** 更新已选钱包资产的手动使用金额，并保持原有选择顺序重新计算。 */
+    updateWalletAssetAmount: (assetId: WalletAssetId, amount: number) => WalletAssetsState;
     /** 精确搜索钱包资产；仅当前券可用时自动选择。 */
     scanWalletAssetAsync: (code: string) => Promise<ScanWalletAssetResult>;
     /** 清空未确认的钱包资产选择。 */

package/lib/modules/Payment/utils.js

@@ -34,7 +34,11 @@ var formatWalletPassList2PreparePayments = (list) => {
   const formatted = (list || []).map((item) => {
     return {
       voucher_id: item.id || 0,
-      amount: Number(item.edit_current_amount || getAvailableMaxAmount(item)) || 0,
+      // 前端策略重算后的 actualDeduction 才是最终可同步金额；
+      // edit_current_amount 只是用户请求值，仍可能被策略和订单剩余金额裁剪。
+      amount: Number(
+        item.actualDeduction ?? item.edit_current_amount ?? getAvailableMaxAmount(item)
+      ) || 0,
       tag: item.tag || "",
       wallet_pass_usage_unit: item.wallet_pass_usage_unit || {},
       wallet_pass_use_value: item.wallet_pass_use_value || void 0

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

@@ -24,6 +24,11 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     private emitEvent;
     private publishWalletAssetsState;
     private recalculateWalletAssets;
+    /**
+     * 搜索接口只返回后端 Wallet Pass 数据，不包含前端策略 config。
+     * 在资产进入共享选择状态前补齐策略结果，避免增量重算回退到接口状态。
+     */
+    private formatSearchedWalletPaymentAssets;
     /** 获取当前缓存中所有支付类 Wallet 资产的扫码 code。 */
     private getSearchedWalletAssetCodes;
     /**
@@ -106,7 +111,13 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     getWalletAssetsState(): WalletAssetsState;
     exportWalletAssetsSnapshot(): WalletAssetsSnapshot;
     importWalletAssetsSnapshot(snapshot: WalletAssetsSnapshot): WalletAssetsState;
+    private updateWalletAssetEditAmountInCaches;
     selectWalletAsset(assetId: WalletAssetId, options: SelectWalletAssetOptions): WalletAssetsState;
+    /**
+     * 更新已选资产的手动金额。只允许在当前实际抵扣额内向下调整，
+     * 金额为 0 时沿用 legacy 行为取消选择。
+     */
+    updateWalletAssetAmount(assetId: WalletAssetId, amount: number): WalletAssetsState;
     scanWalletAssetAsync(code: string): Promise<ScanWalletAssetResult>;
     clearWalletAssetSelection(): WalletAssetsState;
     setCommittedWalletAssets(committedIds: WalletAssetId[], committedAssets?: any[]): WalletAssetsState;