Polyv Help Center

Help Center

Usage

Updated: 2025-09-05 09:41:51

1. Get Order List

API Method: getOrderList(params?: PageOptions & Object): Promise<PageContent<OrderData>>

Parameter Description:

  • params: Acquisition parameters, type PageOptions & Object, optional, default {}

Return Value Description: Type Promise<PageContent<OrderData>>

Example:

const data = await orderTarget.getOrderList({ pageNumber: 1, pageSize: 10 });
console.log('订单列表', data.contents);

2. Get Order Details

API Method: getOrderDetail(params: GetOrderDetailParams): Promise<OrderData>

Parameter Description:

  • params: Acquisition parameters, type GetOrderDetailParams, required. Detailed type description is as follows:
Parameter Description Type Required Default Value
orderNo Order number string Yes -
syncPayStatus Whether to sync the latest order status boolean Yes -

Return Value Description: Type Promise<OrderData>

Example:

const data = await orderTarget.getOrderDetail({ orderNo: '1234567890' });
console.log('订单详情', data);

3. Create Order

API Method: createOrder(params: CreateOrderParams): Promise<CommonResult<CreateOrderFailReason, CreateOrderResponse>>

Parameter Description:

  • params: Order creation parameters, type CreateOrderParams, required. Detailed type description is as follows:
Parameter Description Type Required Default Value
address Logistics information AddressBasicData Yes -
products Purchased items CreateOrderProductItem[] Yes -
payProvider Payment method PaymentProvider Yes -

Return Value Description: Type Promise<CommonResult<CreateOrderFailReason, CreateOrderResponse>>

Example:

const res = await orderTarget.createOrder({ address: { name: '张三', mobile: '13800138000', area: '广东省 广州市 天河区', address: '天河路1号' }, products: [{ productId: 1, quantity: 1 }], payProvider: PaymentProvider.Wechat });
if (res.success) { 
  console.log('创建订单成功', res.orderNo);
} else {
  console.log('创建订单失败', res.failReason, res.failMessage);
}

4. Confirm Receipt

API Method: confirmOrder(orderNo: string): Promise<void>

Parameter Description:

  • orderNo: Order number, type string, required

Example:

await orderTarget.confirmOrder('1234567890');

5. Apply for Refund

API Method: applyOrderRefund(orderNo: string): Promise<CommonResult<OrderRefundFailReason, ApplyOrderRefundResponse>>

Parameter Description:

  • orderNo: Order number, type string, required

Return Value Description: Type Promise<CommonResult<OrderRefundFailReason, ApplyOrderRefundResponse>>

Example:

const res = await orderTarget.applyOrderRefund('1234567890');
if (res.success) {
  console.log('退款成功', res);
} else {
  console.log('退款失败', res.failReason, res.failMessage);
}
联系客服,在线咨询