Order API response models
Types in packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts).
Standard responses on preview, create, and detail include top-level monetary_unit: "CNY_minor" — all { amount, currency } values are CNY fen (1 yuan = 100 fen). POST /v1/products/freight/estimate uses the same convention. Product catalog prices use yuan (CNY_major); see Product response models. Upstream format omits monetary_unit.
StandardOrderPreviewResult {#standard-order-preview-result}
From order preview.
| Field | Type | Description |
|---|---|---|
success | boolean | false when lines cannot be purchased; check unavailable_lines |
total.payment | Money | Total payable |
total.shipping | Money | Domestic shipping portion |
sellers[] | array | Grouped by seller with lines[], fees |
unavailable_lines[] | array | Failed validation or stock |
trade_types[] | array | 1688 only |
promotions | object | 1688 promotions when present |
StandardOrderCreateResult {#standard-order-create-result}
| Field | Type | Description |
|---|---|---|
order_id | string | Use for pay, detail, trace |
total.payment | Money | Amount to pay |
order_list[] | array | Sub-orders / seller splits |
failed_offers[] | array | Partial create possible with success: true |
outer_purchase_id | string | Taobao idempotency key |
payment_url | string | Taobao optional payment URL |
StandardOrderPayResult {#standard-order-pay-result}
| Field | Description |
|---|---|
success | Payment accepted |
pay_channel | 1688 payment method |
error_code / error_message | When success: false |
StandardOrderDetail {#standard-order-detail}
| Field | Description |
|---|---|
status | e.g. wait_payment, wait_shipment, shipped |
refund_status | Read-only; refund APIs not public |
amounts | total, product_total, shipping_fee, refund (fen) |
line_items[] | Product rows with sku_specs, status |
times | created_at, paid_at, shipped_at, … |
domestic_parcels[] | Warehouse mode → fulfillment |
UnifiedLogisticsTrace {#unified-logistics-trace}
From domestic trace.
| Field | Description |
|---|---|
packages[] | tracking_number, carrier, steps[] |
cross_border_packages[] | 1688 cross-border nodes — not international fulfillment |
StandardOrderCancelResult {#standard-order-cancel-result}
| Field | Description |
|---|---|
success | Cancel accepted (may still process) |
pending | Taobao async cancel |
sub_order_ids | Partial cancel affected ids |
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days