@be-link/ecommerce-trade-service-node-sdk 0.1.95 → 0.1.97

package/consts.d.ts

@@ -26,6 +26,13 @@ export declare const PromotionToReverseResourceTypeMap: {
 };
 /** 逆向订单优惠券资源类型集合（包含单品券和订单券，兼容历史数据） */
 export declare const ReverseResourceCouponTypeList: ENUM.ReverseResourceType[];
+/** Redis Key 前缀常量 */
+export declare const REDIS_KEY: {
+    /** 支付参数限流计数器: TRADE:PAYMENT_PARAM:RATE_LIMIT:{timestamp_second} */
+    readonly PAYMENT_PARAM_RATE_LIMIT: "TRADE:PAYMENT_PARAM:RATE_LIMIT";
+    /** 支付参数缓存: TRADE:PAYMENT_PARAM:CACHE:{orderId} */
+    readonly PAYMENT_PARAM_CACHE: "TRADE:PAYMENT_PARAM:CACHE";
+};
 /** Redis 锁 Key 前缀常量 */
 export declare const REDIS_LOCK_KEY: {
     /** 逆向订单操作锁（订单维度） - 用于所有退款相关操作 */
@@ -38,6 +45,8 @@ export declare const REDIS_LOCK_KEY: {
     readonly ROS_BATCH_REFUND: "TRADE:ROS:BATCH_REFUND_LOCK";
     /** 正向订单创建锁（用户维度） */
     readonly POS_ORDER_CREATE: "TRADE:POS:ORDER_CREATE_LOCK";
+    /** 支付参数锁（订单维度）: TRADE:PAYMENT_PARAM:LOCK:{orderId} */
+    readonly PAYMENT_PARAM: "TRADE:PAYMENT_PARAM:LOCK";
 };
 /** 交易 MQ */
 export declare const TradeVHOST = "ecommerce";

package/consts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ForeverEnd = exports.ROSTopicName = exports.POSTopicName = exports.TradeVHOST = exports.REDIS_LOCK_KEY = exports.ReverseResourceCouponTypeList = exports.PromotionToReverseResourceTypeMap = exports.PromotionCouponTypeMap = exports.PromotionCouponTypeList = exports.PayWayMap = exports.PayPlatformMap = exports.PayChannelMap = exports.ReverseRefundWayMap = exports.ReverseRefundTypeMap = exports.ReverseArrivalStatusMap = exports.ReverseOrderStatusMap = exports.ReverseResourceTypeMap = exports.OrderVerificationStatusMap = exports.OrderRefundStatusMap = exports.OrderPayStatusMap = exports.OrderStatusMap = exports.OrderOsTypeMap = exports.OrderPlatformMap = exports.OrderSourceMap = void 0;
+exports.ForeverEnd = exports.ROSTopicName = exports.POSTopicName = exports.TradeVHOST = exports.REDIS_LOCK_KEY = exports.REDIS_KEY = exports.ReverseResourceCouponTypeList = exports.PromotionToReverseResourceTypeMap = exports.PromotionCouponTypeMap = exports.PromotionCouponTypeList = exports.PayWayMap = exports.PayPlatformMap = exports.PayChannelMap = exports.ReverseRefundWayMap = exports.ReverseRefundTypeMap = exports.ReverseArrivalStatusMap = exports.ReverseOrderStatusMap = exports.ReverseResourceTypeMap = exports.OrderVerificationStatusMap = exports.OrderRefundStatusMap = exports.OrderPayStatusMap = exports.OrderStatusMap = exports.OrderOsTypeMap = exports.OrderPlatformMap = exports.OrderSourceMap = void 0;
 const ecommerce_promotion_service_node_sdk_1 = require("@be-link/ecommerce-promotion-service-node-sdk");
 const enums_1 = require("./enums");
 exports.OrderSourceMap = {
@@ -121,6 +121,13 @@ exports.ReverseResourceCouponTypeList = [
     enums_1.ENUM.ReverseResourceType.ORDER_DISCOUNT, // 订单券（新值）
     enums_1.ENUM.ReverseResourceType.VOUCHER, // 核销券
 ];
+/** Redis Key 前缀常量 */
+exports.REDIS_KEY = {
+    /** 支付参数限流计数器: TRADE:PAYMENT_PARAM:RATE_LIMIT:{timestamp_second} */
+    PAYMENT_PARAM_RATE_LIMIT: 'TRADE:PAYMENT_PARAM:RATE_LIMIT',
+    /** 支付参数缓存: TRADE:PAYMENT_PARAM:CACHE:{orderId} */
+    PAYMENT_PARAM_CACHE: 'TRADE:PAYMENT_PARAM:CACHE',
+};
 /** Redis 锁 Key 前缀常量 */
 exports.REDIS_LOCK_KEY = {
     /** 逆向订单操作锁（订单维度） - 用于所有退款相关操作 */
@@ -133,6 +140,8 @@ exports.REDIS_LOCK_KEY = {
     ROS_BATCH_REFUND: 'TRADE:ROS:BATCH_REFUND_LOCK',
     /** 正向订单创建锁（用户维度） */
     POS_ORDER_CREATE: 'TRADE:POS:ORDER_CREATE_LOCK',
+    /** 支付参数锁（订单维度）: TRADE:PAYMENT_PARAM:LOCK:{orderId} */
+    PAYMENT_PARAM: 'TRADE:PAYMENT_PARAM:LOCK',
 };
 /** 交易 MQ */
 exports.TradeVHOST = 'ecommerce';

package/enums.d.ts

@@ -231,6 +231,15 @@ export declare namespace ENUM {
         /** 核销券 */
         VOUCHER = "VOUCHER"
     }
+    /** 支付参数状态 */
+    enum PaymentParamStatus {
+        /** 处理中 */
+        PROCESSING = "PROCESSING",
+        /** 成功 */
+        SUCCESS = "SUCCESS",
+        /** 失败 */
+        FAILED = "FAILED"
+    }
     /** 申请退款状态 */
     enum ApplyRefundStatus {
         /** 极速退款 */
@@ -383,7 +392,9 @@ export declare namespace EXCHANGE_ENUM {
         /** 取消交易 */
         CANCELED = "trade.order.positive.canceled",
         /** 已关闭 */
-        CLOSED = "trade.order.positive.closed"
+        CLOSED = "trade.order.positive.closed",
+        /** 获取支付参数 */
+        FETCH_PAYMENT_PARAM = "trade.order.positive.fetch_payment_param"
     }
     /** 逆向订单交换机路由 */
     enum RosRoutingKeyEnum {

package/enums.js

@@ -257,6 +257,16 @@ var ENUM;
         /** 核销券 */
         PayWay["VOUCHER"] = "VOUCHER";
     })(PayWay = ENUM.PayWay || (ENUM.PayWay = {}));
+    /** 支付参数状态 */
+    let PaymentParamStatus;
+    (function (PaymentParamStatus) {
+        /** 处理中 */
+        PaymentParamStatus["PROCESSING"] = "PROCESSING";
+        /** 成功 */
+        PaymentParamStatus["SUCCESS"] = "SUCCESS";
+        /** 失败 */
+        PaymentParamStatus["FAILED"] = "FAILED";
+    })(PaymentParamStatus = ENUM.PaymentParamStatus || (ENUM.PaymentParamStatus = {}));
     /** 申请退款状态 */
     let ApplyRefundStatus;
     (function (ApplyRefundStatus) {
@@ -429,6 +439,8 @@ var EXCHANGE_ENUM;
         PosRoutingKeyEnum["CANCELED"] = "trade.order.positive.canceled";
         /** 已关闭 */
         PosRoutingKeyEnum["CLOSED"] = "trade.order.positive.closed";
+        /** 获取支付参数 */
+        PosRoutingKeyEnum["FETCH_PAYMENT_PARAM"] = "trade.order.positive.fetch_payment_param";
     })(PosRoutingKeyEnum = EXCHANGE_ENUM.PosRoutingKeyEnum || (EXCHANGE_ENUM.PosRoutingKeyEnum = {}));
     /** 逆向订单交换机路由 */
     let RosRoutingKeyEnum;

package/index.d.ts

@@ -4,6 +4,6 @@ export * as STATISTICS from './modules/statistics';
 export { ENUM, ENUM_CN, EXCHANGE_ENUM } from './enums';
 export * as CONSTS from './consts';
 export * as DTO from './types';
-export { PromotionCouponTypeList, PromotionCouponTypeMap, PromotionToReverseResourceTypeMap as OrderPromotionToReverseResourceTypeMap, ReverseResourceCouponTypeList, REDIS_LOCK_KEY, } from './consts';
+export { PromotionCouponTypeList, PromotionCouponTypeMap, PromotionToReverseResourceTypeMap as OrderPromotionToReverseResourceTypeMap, ReverseResourceCouponTypeList, REDIS_KEY, REDIS_LOCK_KEY, } from './consts';
 export { verificationService } from './modules/verification/service';
 export type { VerificationService as VerificationServiceTypes } from './modules/verification/types';

package/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verificationService = exports.REDIS_LOCK_KEY = exports.ReverseResourceCouponTypeList = exports.OrderPromotionToReverseResourceTypeMap = exports.PromotionCouponTypeMap = exports.PromotionCouponTypeList = exports.DTO = exports.CONSTS = exports.EXCHANGE_ENUM = exports.ENUM_CN = exports.ENUM = exports.STATISTICS = exports.ROS = exports.POS = void 0;
+exports.verificationService = exports.REDIS_LOCK_KEY = exports.REDIS_KEY = exports.ReverseResourceCouponTypeList = exports.OrderPromotionToReverseResourceTypeMap = exports.PromotionCouponTypeMap = exports.PromotionCouponTypeList = exports.DTO = exports.CONSTS = exports.EXCHANGE_ENUM = exports.ENUM_CN = exports.ENUM = exports.STATISTICS = exports.ROS = exports.POS = void 0;
 exports.POS = __importStar(require("./modules/pos"));
 exports.ROS = __importStar(require("./modules/ros"));
 exports.STATISTICS = __importStar(require("./modules/statistics"));
@@ -48,6 +48,7 @@ Object.defineProperty(exports, "PromotionCouponTypeList", { enumerable: true, ge
 Object.defineProperty(exports, "PromotionCouponTypeMap", { enumerable: true, get: function () { return consts_1.PromotionCouponTypeMap; } });
 Object.defineProperty(exports, "OrderPromotionToReverseResourceTypeMap", { enumerable: true, get: function () { return consts_1.PromotionToReverseResourceTypeMap; } });
 Object.defineProperty(exports, "ReverseResourceCouponTypeList", { enumerable: true, get: function () { return consts_1.ReverseResourceCouponTypeList; } });
+Object.defineProperty(exports, "REDIS_KEY", { enumerable: true, get: function () { return consts_1.REDIS_KEY; } });
 Object.defineProperty(exports, "REDIS_LOCK_KEY", { enumerable: true, get: function () { return consts_1.REDIS_LOCK_KEY; } });
 // 核销
 var service_1 = require("./modules/verification/service");

package/modules/pos/orderCore/types.d.ts

@@ -160,6 +160,8 @@ export declare namespace PosCoreService {
                 coupon: Dto.ICoupon;
                 userId: string;
                 skuId: string;
+                getChannel1?: string;
+                getChannel2?: string;
             }
             /** 切换支付商户号请求参数 */
             interface ISwitchPaymentMerchantNo {

package/modules/pos/orderQuery/types.d.ts

@@ -777,6 +777,10 @@ export declare namespace PosOrderQueryService {
                 /** 订单ID */
                 orderId: string;
             }
+            interface IGetPaymentParam {
+                /** 订单ID */
+                orderId: string;
+            }
             interface IGetUserPositiveAmount {
                 /** 用户ID */
                 userId: string;
@@ -842,6 +846,10 @@ export declare namespace PosOrderQueryService {
                 source: ENUM.OrderSource;
                 /** 订单类型 */
                 orderType: ENUM.OrderType;
+                /** 单位积分数 */
+                unitPointNum: number;
+                /** 单位优惠券数量 */
+                unitCouponNum: number;
                 /** 积分数 */
                 pointNum: number;
                 /** 优惠券数量 */
@@ -915,6 +923,14 @@ export declare namespace PosOrderQueryService {
                     memberPrice: number;
                     /** 商品提货方式 */
                     productPick: PRODUCT_SERVICE_ENUM.PRODUCT_ENUM.PICK_TYPE;
+                    /** 下单时的积分数量 */
+                    pointNum: number;
+                    /** 积分单价（积分数量/商品数量） */
+                    unitPointPrice: number;
+                    /** 下单时的券总金额 */
+                    couponAmount: number;
+                    /** 券单价（券总金额/商品数量） */
+                    unitCouponPrice: number;
                 };
                 /** 门店信息 */
                 store: {
@@ -1020,12 +1036,16 @@ export declare namespace PosOrderQueryService {
                 receiverPhone: string;
             }
             interface IGetOrderPayParams {
-                /** 子商户号 */
-                subMchId: string;
-                /** 预支付ID */
-                prepayId: string;
-                /** 微信支付请求参数 */
-                payment: DTO.IWePayParam;
+                /** 支付参数状态 */
+                status: ENUM.PaymentParamStatus;
+                /** 微信支付请求参数（status=SUCCESS 时有值，其他状态为 null） */
+                payment: DTO.IWePayParam | null;
+            }
+            interface IGetPaymentParam {
+                /** 支付参数状态：null=未找到，PROCESSING=处理中，SUCCESS=成功，FAILED=失败 */
+                status: 'PROCESSING' | 'SUCCESS' | 'FAILED' | null;
+                /** 支付参数（仅 status=SUCCESS 时有值） */
+                paymentParam: DTO.IPaymentParam | null;
             }
             interface IGetUserPositiveAmount {
                 /** 用户ID */

package/modules/ros/orderQuery/types.d.ts

@@ -99,6 +99,11 @@ export declare namespace RosOrderQueryService {
                 pageIndex: number;
                 pageSize: number;
             };
+            /** 深度分页游标（可选，用于优化深度分页性能） */
+            cursor?: {
+                lastCreatedAt: number;
+                lastId: string;
+            };
         }
         interface IExportOrderData extends IList {
         }
@@ -110,6 +115,11 @@ export declare namespace RosOrderQueryService {
                 pageIndex: number;
                 pageSize: number;
             };
+            /** 深度分页游标（可选，用于优化深度分页性能） */
+            cursor?: {
+                lastCreatedAt: number;
+                lastId: string;
+            };
         }
         interface IGetApplyRefundInfo {
             /** 正向订单ID */
@@ -276,6 +286,11 @@ export declare namespace RosOrderQueryService {
             list: IListItem[];
             /** 总记录数 */
             total: number;
+            /** 下一页游标（如果还有更多数据） */
+            nextCursor?: {
+                lastCreatedAt: number;
+                lastId: string;
+            };
         }
         interface IExportOrderData {
             /** 表头 */
@@ -415,6 +430,18 @@ export declare namespace RosOrderQueryService {
                 source: ENUM.OrderSource;
                 /** 订单类型 */
                 orderType: ENUM.OrderType;
+                /** 退款金额 */
+                refundAmount: number;
+                /** 单位积分数 */
+                unitPointNum: number;
+                /** 单位优惠券数量 */
+                unitCouponNum: number;
+                /** 积分数 */
+                pointNum: number;
+                /** 优惠券数量 */
+                couponNum: number;
+                /** 商品数量 */
+                productQuantity: number;
             }
             interface IRefundOrderList {
                 /** 订单列表 */
@@ -448,7 +475,10 @@ export declare namespace RosOrderQueryService {
                     /** 退回优惠券数量 */
                     exchangeCouponNum: number;
                     /** 退回优惠券码 */
-                    refundedCoupons: string[];
+                    refundedCoupons: {
+                        code: string;
+                        discount: number;
+                    }[];
                 };
                 /** 积分商城订单信息 */
                 pointsOrderInfo?: {
@@ -469,6 +499,14 @@ export declare namespace RosOrderQueryService {
                     unitPrice: number;
                     /** 商品会员价 */
                     memberPrice: number;
+                    /** 下单时的积分数量 */
+                    pointNum: number;
+                    /** 积分单价（积分数量/商品数量） */
+                    unitPointPrice: number;
+                    /** 下单时的券总金额 */
+                    couponAmount: number;
+                    /** 券单价（券总金额/商品数量） */
+                    unitCouponPrice: number;
                 };
             }
             interface IGetRefundableResource {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-trade-service-node-sdk",
-  "version": "0.1.95",
+  "version": "0.1.97",
   "description": "EcommerceTradeService Node.js SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/types.d.ts

@@ -321,7 +321,7 @@ export interface RosOrderPayload {
     /** 事件发送时间 */
     eventTime: number;
     /** 资源退还时间 */
-    refundAt: number;
+    refundAt?: number;
 }
 export interface RosOrderHeaders {
     /** 是否全单退（0=否，1=是）退最后一份也算全单退 */
@@ -357,6 +357,10 @@ export interface ICouponInfo {
     validStartTime?: number;
     /** 有效期结束 */
     validEndTime?: number;
+    /** 领取渠道一级 */
+    getChannel1?: string;
+    /** 领取渠道二级 */
+    getChannel2?: string;
 }
 /** 会员信息 */
 export interface IMemberInfo {
@@ -366,21 +370,87 @@ export interface IMemberInfo {
     quantity: number;
 }
 /** 订单支付额外信息 */
+/**
+ * 现金支付信息
+ */
+export interface ICashPaymentInfo {
+    /** 子商户号 */
+    subMchId: string;
+    /** 预支付ID */
+    prepayId: string;
+    /** 支付参数 */
+    payment: IWePayParam;
+    /** 用户openId */
+    openId?: string;
+    /** 小程序appId */
+    appId?: string;
+    /** 商户号信息 */
+    merchantInfo: IMerchantInfo;
+}
+/**
+ * 订单支付额外信息
+ */
 export interface ITradeOrderPaymentExtraInfo {
     /** 现金支付信息 */
-    cash?: {
-        subMchId: string;
-        prepayId: string;
-        payment: IWePayParam;
-        /** 用户openId */
-        openId?: string;
-        /** 小程序appId */
-        appId?: string;
-        /** 商户号信息 */
-        merchantInfo: IMerchantInfo;
-    };
+    cash?: ICashPaymentInfo;
     /** 兑换券信息 */
     exchangeCoupon?: ICouponInfo[];
     /** 核销券信息 */
     coupon?: ICouponInfo;
 }
+/**
+ * 调用支付接口的请求参数
+ */
+export interface IPayReqParam {
+    /** 订单ID */
+    orderId: string;
+    /** 用户openId */
+    openId: string;
+    /** 支付金额（单位：分） */
+    amount: number;
+    /** 商品描述 */
+    description: string;
+    /** 客户端IP地址 */
+    clientIp?: string;
+    /** 小程序appId */
+    appId?: string;
+    /** 微信支付方式 */
+    payWay?: ENUM.WePayWay;
+}
+/**
+ * 支付参数MQ消息Payload
+ */
+export interface IPaymentParamPayload {
+    /** 订单ID */
+    orderId: string;
+    /** 用户ID */
+    userId: string;
+    /** 订单创建时间戳（毫秒），用于消费者超时检查 */
+    createTime: number;
+    /** 调用支付接口的请求参数 */
+    payReqParam: IPayReqParam;
+}
+/**
+ * 支付参数（返回给前端的支付参数）
+ */
+export interface IPaymentParam {
+    /** 微信支付参数 */
+    [ENUM.PayPlatform.WECHAT]?: IWePayParam;
+}
+/**
+ * 支付参数缓存 Redis Hash 数据结构
+ * Key: TRADE:PAYMENT_PARAM:CACHE:{orderId}
+ * Expire: 30分钟
+ */
+export interface IPaymentParamCache {
+    /** 支付参数状态 */
+    status: ENUM.PaymentParamStatus;
+    /** 用户ID（用于验证订单归属） */
+    userId: string;
+    /** 支付参数（IPaymentParam 类型的 JSON 字符串，仅 SUCCESS 时有值） */
+    paymentParam?: string;
+    /** 订单创建时间戳（毫秒，用于超时检查） */
+    createTime: string;
+    /** 更新时间戳（毫秒） */
+    updatedAt: string;
+}

package/types.js

@@ -1,2 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/** 正向订单 */
+/** 基础信息 */
+const enums_1 = require("./enums");