@pisell/pisellos 0.0.229 → 0.0.230

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

@@ -86,15 +86,25 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      */
     getOrderListAsync(): Promise<PaymentOrder[]>;
     /**
-     * 根据uuid获取指定订单
+     * 根据订单UUID获取支付订单（新方法）
      */
-    getOrderByUuidAsync(orderUuid: string): Promise<PaymentOrder | null>;
+    getPaymentOrderByUuidAsync(orderUuid: string): Promise<PaymentOrder | null>;
     /**
-     * 往交易组中添加订单
+     * 创建支付订单（新方法，专注支付数据）
+     */
+    createPaymentOrderAsync(params: PushOrderParams): Promise<PaymentOrder>;
+    /**
+     * 往交易组中添加订单（兼容性方法）
+     * @deprecated 使用 createPaymentOrderAsync 替代
      */
     pushOrderAsync(params: PushOrderParams): Promise<PaymentOrder>;
     /**
-     * 删除订单
+     * 删除支付订单（新方法）
+     */
+    deletePaymentOrderAsync(orderUuid: string): Promise<void>;
+    /**
+     * 删除订单（兼容性方法）
+     * @deprecated 使用 deletePaymentOrderAsync 替代
      */
     deleteOrderAsync(orderUuid: string): Promise<void>;
     /**
@@ -102,11 +112,32 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      */
     updateOrderAsync(orderUuid: string, params: Partial<PaymentOrder>): Promise<void>;
     /**
-     * 获取支付项
+     * 基于UUID替换订单ID
+     *
+     * 此方法用于将本地虚拟订单ID替换为真实的订单ID。
+     * 当前端模拟下单流程完成后，后端返回真实订单ID时调用此方法。
+     *
+     * @param orderUuid 订单的UUID
+     * @param newOrderId 新的订单ID (来自后端)
+     * @returns 更新后的订单对象，如果订单不存在则返回null
+     */
+    replaceOrderIdByUuidAsync(orderUuid: string, newOrderId: string): Promise<PaymentOrder | null>;
+    /**
+     * 获取支付项（新方法）
+     */
+    getPaymentItemsAsync(orderUuid: string): Promise<PaymentItem[]>;
+    /**
+     * 获取支付项（兼容性方法）
+     * @deprecated 使用 getPaymentItemsAsync 替代
      */
     getPaymentAsync(orderUuid: string): Promise<PaymentItem[]>;
     /**
-     * 为某个订单设置一个支付项
+     * 为某个订单添加支付项（新方法）
+     */
+    addPaymentItemAsync(orderUuid: string, paymentItem: PaymentItemInput): Promise<void>;
+    /**
+     * 为某个订单设置一个支付项（兼容性方法）
+     * @deprecated 使用 addPaymentItemAsync 替代
      */
     pushPaymentAsync(orderUuid: string, paymentItem: PaymentItemInput): Promise<void>;
     /**
@@ -224,4 +255,26 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      * @returns Promise<boolean> 是否成功添加到队列
      */
     private reAddOrderToSyncQueue;
+    /**
+     * 删除支付项（新方法）
+     */
+    deletePaymentItemAsync(orderUuid: string, paymentUuid: string): Promise<void>;
+    /**
+     * 更新支付项（新方法）
+     */
+    updatePaymentItemAsync(orderUuid: string, paymentUuid: string, params: PaymentUpdateFields): Promise<void>;
+    /**
+     * 获取订单剩余待付金额（新方法）
+     */
+    getRemainingAmountAsync(orderUuid: string): Promise<number>;
+    /**
+     * 获取订单剩余待付金额（基于用户输入的金额）（新方法）
+     */
+    getRemainingAmountWithInputAsync(inputAmount: string | number, orderUuid: string): Promise<number>;
+    /**
+     * 提交支付（新方法）
+     */
+    submitPaymentAsync(orderUuid: string): Promise<{
+        status: 'success' | 'failed';
+    }>;
 }