Apply for production procurement
One Channel, One Seller, One Order
Each purchase order can contain multiple products or SKUs, but all items must belong to the same channel and seller.
If your customer purchases products from different sellers or channels, your application must split them into separate purchase orders before calling the HIOBuy Order API.
HIOBuy does not automatically split purchase orders and does not expose a Batch Order API for this workflow.
See purchase creation and manual procurement for seller identity, correct/incorrect examples, error codes, and Warehouse responsibilities. Procurement orders remain separate when their packages are later consolidated into one shipment. Persist every returned order_list[].order_id; top-level order_id is only the first ID.
Production warehouse access requires an active eligible paid subscription, approved launch application and successfully activated production account. HIOBuy manages marketplace credentials and warehouse binding. Follow the developer center fulfillment guide; new integrations do not obtain warehouse codes or perform personal marketplace OAuth.
Launch application
An active paid subscription is required to submit a launch application. In the developer center, provide the project website or app, business introduction, expected purchase volume, service regions and requested services. The application states are pending, approved and rejected. Submission does not activate real procurement. Approval starts automatic production account provisioning; wait until production activation is ready. Pending or rejected applications do not revoke existing product API access; the subscription, quota and channel access must remain valid.
Real operations and safe retries
Product reads retrieve real data. Order preview and shipping quotes estimate costs without creating or paying an order. Procurement creation creates a real business order; procurement payment and shipment payment can spend real funds. Inbound notices create warehouse records, and shipment creation requests warehouse processing. Confirm production activation, the intended order, amount and account before each business mutation. Persist business identifiers and use Idempotency-Key where documented; query the existing result after an uncertain response instead of submitting a new payment.
Procurement fee
The current procurement service fee is 5% of the actual goods purchase amount, excluding domestic and international shipping. Subscription, goods, procurement service fees and logistics are separate charges. Use the warehouse order detail for final charges; the product preview may not include the procurement service fee. Do not add the fee again to an amount that already includes it.
Existing integrations
New integrations use HIOBuy-managed procurement and fulfillment. Self procurement, Self Fulfillment and personal marketplace authorization are retained only for eligible existing applications with administrator permission and an active subscription. Expired or disabled legacy access is unavailable; contact support about an existing arrangement. Existing API endpoints and historical orders remain in place. After a legacy subscription expires, renewing it does not restore the old mode.
Products · Procurement orders · Fulfillment · Errors · Webhooks · Authentication
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days