Portal authorization
After your app is approved, authorize channels in the developer portal before calling procurement or fulfillment APIs.
There are two layers of choice:
- Fulfillment mode — whether HioBuy warehouses and ships internationally
- Procurement mode (only when warehouse fulfillment is on) — who buys on Taobao / 1688 / Weidian
Fulfillment mode (per app)
| Mode | Who holds warehouse binding | International shipping (/v1/fulfillment/*) |
|---|---|---|
| Self fulfillment (default) | None — you handle logistics yourself | Not available (403) |
| HioBuy warehouse | One warehouse developer code | Available — Fulfillment overview |
Public API paths stay the same (/v1/products/*, /v1/orders/*, …). The Gateway routes by your app’s modes.
Procurement under warehouse fulfillment
When you choose HioBuy warehouse, procurement supports two options. International warehousing and shipping work in both; only who places marketplace purchase orders differs.
| Procurement mode | Who buys on the marketplace | Channel tokens | /v1/orders/* | /v1/products/* |
|---|---|---|---|---|
| HioBuy procurement (default) | HioBuy buys for you | Issued by warehouse authorize; Gateway stores them | Routed via HioBuy warehouse procurement | Gateway uses stored tokens → marketplace |
| Self procurement | You buy with your own accounts | You manage OAuth / credentials in the portal | Gateway → marketplace with your tokens (same as classic self flow) | Same — your tokens |
| Capability | HioBuy procurement | Self procurement |
|---|---|---|
| Bind warehouse code once | Yes | Yes |
| Warehouse inbound / packages / VAS / returns | Yes | Yes |
| International shipments & wallet | Yes | Yes |
| Marketplace OAuth managed by you | No | Yes (per channel) |
Switching between these two procurement options may clear or re-issue channel tokens; the portal will ask you to confirm.
Self fulfillment (no HioBuy warehouse)
For each enabled channel (Taobao, 1688, Weidian, …):
- Open Authorizations → select app → Authorize
- Paste OAuth credentials or complete OAuth when available
- Portal shows status, account name, expiry — never full tokens
/v1/fulfillment/* is not available in this mode.
HioBuy warehouse fulfillment (setup)
Plans: HioBuy warehouse fulfillment and dedicated support require a paid plan (Growth / Enterprise). Free plans include self-service documentation and Sandbox access. Dedicated integration and fulfillment support are available on paid plans.
- Obtain a warehouse developer code from HioBuy ops
- Portal → Authorizations → choose Use HioBuy fulfillment
- Pick procurement mode: HioBuy procurement or self procurement
- Enter the warehouse code once — binding is app-level (not per channel)
- If HioBuy procurement: portal lists each channel’s status and
expires_at(tokens are not visible or editable) - If self procurement: complete normal per-channel OAuth / credential entry yourself; warehouse binding only unlocks fulfillment APIs
Switching back to self fulfillment clears the warehouse binding; you will be prompted to confirm.
What you never send in API calls
- Marketplace access tokens
- Warehouse developer code (Gateway attaches it server-side)
Only Authorization: Bearer hio_live_… (or hio_test_…) on https://api.hiobuy.com.
Next: Fulfillment overview · Orders
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days