**Version: 202701**

# Order

Manage the full lifecycle of merchant orders, from creation to fulfillment

An order represents a customer's purchase request — items selected, payment, shipping address, and current fulfillment progress. This API is the merchant-facing entry point for the entire order lifecycle.

Provided operations: create new orders; browse and search the order list; retrieve a single order by ID or order number; update editable fields; cancel orders; mark orders as paid; count orders matching filters; and inspect related post-sale (after-sales) and refund records.

- [List orders](/api/202701/orders) `GET /openapi/2027-01/orders`: Returns a paginated list of orders, with optional filters for status, date range, and other criteria.

- [Create order](/api/202701/order-create) `POST /openapi/2027-01/orders`: Merchants can use this feature to create orders on behalf of their customers.

- [Get order](/api/202701/order-detail) `GET /openapi/2027-01/orders/:order_id`: Retrieves detailed information about a specific order based on its unique ID.

- [Update order](/api/202701/order-update) `PUT /openapi/2027-01/orders/:order_id`: Allows users to update the details of an existing order.

- [Delete order](/api/202701/order-delete) `DELETE /openapi/2027-01/orders/:order_id`: Allows the deletion of a specific order by its unique ID.

- [Cancel order](/api/202701/order-cancel) `POST /openapi/2027-01/orders/:order_id/cancel`: Canceling an order by specifying its unique ID and an optional cancel reason.

- [Get order details by number](/api/202701/order-by-number) `GET /openapi/2027-01/orders/number/:number`: Retrieves detailed information about a specific order using its unique order number.

- [Get order count](/api/202701/order-count) `GET /openapi/2027-01/orders/count`: Provides the total number of orders matching the specified query parameters.

- [List post-sale orders](/api/202701/order-post-sales) `GET /openapi/2027-01/orders/post_sales`: Retrieves a list of after-sales records (e.g., returns or exchanges) associated with orders.

- [Delete post-sale order](/api/202701/order-post-sale-delete) `DELETE /openapi/2027-01/orders/post_sales/:post_sale_id`: Allows you to remove a specific post-sales order record (e.g., a return or exchange request) by its unique identifier.

- [Pay order success](/api/202701/order-pay-success) `POST /openapi/2027-01/orders/:order_id/payment/success`: Finalizes payment for an order and updates its status to indicate that payment has been completed.
