Paket-Rücksendungen

Request returning a warehouse package (or selected items) to the Chinese seller when goods are damaged, wrong, or otherwise not shippable outbound.

Availability: Sandbox / Gateway MOCK is live (hio_test_*). Live warehouse execution and wallet debit are not wired yet.

Requires warehouse fulfillment.

Method	Path	Purpose
POST	`/v1/fulfillment/returns`	Create Return Request
GET	`/v1/fulfillment/returns`	List Return Requests
GET	`/v1/fulfillment/returns/{return_id}`	Get Return Request
POST	`/v1/fulfillment/returns/{return_id}/confirm`	Confirm Return Request
POST	`/v1/fulfillment/returns/{return_id}/cancel`	Cancel Return Request

IDs use ret_*. Statuses: PENDING · RETURNED · CANCELLED.

Lebenszyklus {#lifecycle}

Create

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.

Required: package_id, reason, items[], seller_return. Optional: remark. Clients must not submit fees.

Confirm

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

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

Mismatch → RETURN_FEE_CHANGED. Repeat confirm is idempotent.

Sandbox

ret_pending_001 (fee 18) · ret_pending_002 (fee 20) · ret_returned_001 · ret_cancelled_001 · sb_ret_not_found

Get Support

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