包裹退运

包裹到仓后因破损、错货等原因需要退回中国卖家时，使用本接口。

Availability: Sandbox / Gateway MOCK is live (hio_test_*). 真实仓库执行与扣款尚未接通。

需要开启仓库履约。

MethodPathPurpose
POST/v1/fulfillment/returns创建退运申请
GET/v1/fulfillment/returns退运列表
GET/v1/fulfillment/returns/{return_id}退运详情
POST/v1/fulfillment/returns/{return_id}/confirm确认费用并授权执行
POST/v1/fulfillment/returns/{return_id}/cancel取消退运

ID 前缀 ret_*。状态：PENDING · RETURNED · CANCELLED。

生命周期 {#lifecycle}

创建

Creates a request to return a warehouse package or selected items to the seller. HioBuy will calculate the applicable handling and domestic return shipping fees before the return is processed.

必填：package_id、reason、items[]、seller_return。可选：remark。客户端不得提交费用。

确认

Confirms the current return fee and authorizes HioBuy to process the return to the seller.

{
  "fee_amount": 18,
  "currency": "CNY"
}

金额不一致 → RETURN_FEE_CHANGED。重复 Confirm 幂等。

沙箱

ret_pending_001（fee 18）· ret_pending_002（fee 20）· ret_returned_001 · ret_cancelled_001 · sb_ret_not_found

获取支持

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

发送邮件