Procurement orders overview

1688 buyers can retrieve a Cross-border Pay cashier link without submitting payment. This uses native 1688 buyer order IDs, not warehouse procurement IDs, and never confirms payment or records GMV.

/v1/orders/* covers domestic procurement — orders with 1688/Taobao sellers for delivery into a China inbound address. Not international shipping; use Fulfillment after inbound.

Amounts are CNY fen (分). Set response_format per Response format.

Map product ids from Products: search/detail id → lines[].id (compatible: offer_id, Taobao mi_id); variants[].sku_id → lines[].spec_id.

Taobao id / mi_id rotates periodically. Do not cache it long-term. Re-fetch from search or detail before preview/create.

Lifecycle {#lifecycle}

  1. Preview — validate lines, prices, freight
  2. Create — place procurement order
  3. Pay — settle with marketplace wallet
  4. Detail / list — track status
  5. Domestic trace — seller → warehouse
  6. Cancel — when allowed

Endpoint guide

StepPathDoc
PreviewPOST /v1/orders/previewOrder preview
CreatePOST /v1/orders/createCreate order
PayPOST /v1/orders/payPay order
1688 payment methodsPOST /v1/orders/payment-methodsPayment methods
DetailPOST /v1/orders/detailOrder detail
ListPOST /v1/orders/listOrder detail
CancelPOST /v1/orders/cancelCancel order
Domestic tracePOST /v1/orders/logistics/traceDomestic logistics trace
Taobao purchasesPOST /v1/orders/purchase/queryOrder detail
Response schemas—Order response models

Channel shortcuts: /v1/orders/1688/*, /v1/orders/taobao/* (body may omit channel).

For pay and cancel, the optional Idempotency-Key request header protects retries and concurrent calls. Use a new key for each logical operation and reuse it only for the identical request. See Pay and Cancel.

Domestic vs international logistics {#domestic-vs-international}

LegAPI
Seller → China warehouseDomestic trace
Warehouse → overseas buyerInternational tracking

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support