포털 인증

앱이 승인된 뒤 구매 또는 풀필먼트 API를 호출하기 전에 개발자 포털에서 채널을 인증하세요.

선택은 두 레이어로 나뉩니다.

  1. Fulfillment 모드 — HioBuy가 창고 보관하고 국제 배송하는지 여부
  2. Procurement 모드(warehouse fulfillment가 켜진 경우에만) — Taobao / 1688 / Weidian에서 누가 구매하는지

Fulfillment 모드(앱별)

모드창고 바인딩 보유 주체국제 배송 (/v1/fulfillment/*)
Self fulfillment (기본값)없음 — 물류는 직접 처리사용 불가 (403)
HioBuy warehouse창고 개발자 코드 1개사용 가능 — Fulfillment overview

공개 API 경로는 동일합니다(/v1/products/*, /v1/orders/*, …). Gateway는 앱의 모드에 따라 라우팅합니다.

Warehouse fulfillment 하의 조달

HioBuy warehouse를 선택하면 조달에 두 가지 옵션이 있습니다. 국제 창고 보관과 배송은 둘 다 동작하며, 다른 점은 마켓플레이스 구매 주문을 누가 넣는지뿐입니다.

Procurement 모드마켓플레이스 구매 주체채널 토큰/v1/orders/*/v1/products/*
HioBuy procurement (기본값)HioBuy가 대신 구매창고 인증으로 발급. Gateway가 저장HioBuy warehouse procurement를 통해 라우팅Gateway가 저장된 토큰 → marketplace
Self procurement본인 계정으로 구매포털에서 OAuth / 자격 증명 관리Gateway → marketplace(본인 토큰, 기존 self flow와 동일)동일 — 본인 토큰
기능HioBuy procurementSelf procurement
창고 코드 한 번 바인딩예예
Warehouse inbound / packages / VAS / returns예예
International shipments & wallet예예
Marketplace OAuth를 직접 관리아니요예(채널별)

이 두 procurement 옵션을 전환하면 채널 토큰이 삭제되거나 재발급될 수 있으며, 포털에서 확인을 요청합니다.

Self fulfillment(HioBuy warehouse 없음)

활성화된 각 채널(Taobao, 1688, Weidian, …)에 대해:

  1. Authorizations → 앱 선택 → Authorize를 엽니다.
  2. OAuth 자격 증명을 붙여 넣거나 가능한 경우 OAuth를 완료합니다.
  3. 포털은 상태, 계정명, 만료일을 표시하며 전체 토큰은 절대 표시하지 않습니다.

이 모드에서는 /v1/fulfillment/*를 사용할 수 없습니다.

HioBuy warehouse fulfillment(설정)

플랜: HioBuy warehouse fulfillment와 전담 지원은 유료 플랜(Growth / Enterprise)이 필요합니다. 무료 플랜에는 셀프서비스 문서와 Sandbox 액세스가 포함됩니다. 전담 연동 및 풀필먼트 지원은 유료 플랜에서 제공됩니다.

  1. HioBuy 운영팀에서 창고 개발자 코드를 받습니다.
  2. Portal → Authorizations → Use HioBuy fulfillment를 선택합니다.
  3. Procurement 모드를 선택합니다: HioBuy procurement 또는 self procurement
  4. 창고 코드를 한 번 입력합니다 — 바인딩은 앱 단위입니다(채널 단위 아님).
  5. HioBuy procurement인 경우: 포털에 각 채널의 상태와 expires_at이 표시됩니다(토큰은 보거나 편집할 수 없음).
  6. Self procurement인 경우: 채널별 OAuth / 자격 증명 입력을 직접 완료합니다. 창고 바인딩은 fulfillment API만 잠금 해제합니다.

Self fulfillment로 다시 전환하면 창고 바인딩이 해제되며 확인을 요청합니다.

API 호출에서 절대 보내지 말아야 할 값

  • 마켓플레이스 액세스 토큰
  • 창고 개발자 코드(Gateway가 서버 측에서 첨부)

https://api.hiobuy.com에는 Authorization: Bearer hio_live_…(또는 hio_test_…)만 보냅니다.

다음: Fulfillment overview · Orders

Get Support

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

Email support