代购订单总览

1688 可通过独立的 跨境宝支付链接 API 获取收银台链接，不直接执行付款。参数必须是原生 1688 买家订单 ID，而非仓库采购单 ID；获取链接不确认支付，也不计入 GMV。

/v1/orders/* 覆盖 国内代购 — 与 1688/淘宝卖家下单并配送至中国境内收货地址。非国际运输；入库后请使用 履约。

金额为 人民币分（CNY fen）。response_format 见 响应结构。

商品 id 映射见 商品 API：搜索/详情 id → lines[].id（兼容：offer_id、淘宝 mi_id）；variants[].sku_id → lines[].spec_id。

淘宝 id / mi_id 会周期性变化，请勿长期缓存。预览/下单前请重新搜索或拉详情。

生命周期 {#lifecycle}

  1. 预览 — 校验行项、价格、运费
  2. 创建 — 下代购单
  3. 支付 — 使用卖场钱包结算
  4. 详情 / 列表 — 查询状态
  5. 国内轨迹 — 卖家 → 仓库
  6. 取消 — 在允许时

接口指引

StepPathDoc
PreviewPOST /v1/orders/preview订单预览
CreatePOST /v1/orders/create创建订单
PayPOST /v1/orders/pay支付订单
1688 可用支付渠道POST /v1/orders/payment-methods支付渠道查询
DetailPOST /v1/orders/detail订单详情
ListPOST /v1/orders/list订单详情
CancelPOST /v1/orders/cancel取消订单
Domestic tracePOST /v1/orders/logistics/trace国内物流轨迹
Taobao purchasesPOST /v1/orders/purchase/query订单详情
Response schemas—订单响应模型

渠道快捷路径：/v1/orders/1688/*、/v1/orders/taobao/*（请求体可省略 channel）。

支付和取消接口支持可选请求头 Idempotency-Key，用于保护重试和并发调用。每个逻辑操作生成一个新 key，只有请求完全相同时才复用。详见支付和取消。

国内段 vs 国际段物流 {#domestic-vs-international}

LegAPI
卖家 → 中国仓库国内轨迹
仓库 → 海外买家国际追踪

获取支持

需要集成帮助？请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复

发送邮件