Skip to main content

概覽

getBusinessCategories 查詢會回傳所有啟用中的商業類別及其子類別。兩個 ID 都是 registerBusiness 所必需,且子類別僅在搭配其所屬的類別時才有效。 讓使用者在你的介面中選擇一個類別與該類別的一個子類別,然後將兩個 UUID 一併傳遞。
請勿將這些 UUID 寫死在程式中。 僅會回傳目前啟用中的類別,清單會因環境而異,且會隨時間變動。請在執行期間擷取——若子類別屬於不同的類別,在註冊時會以 BS-0006 被拒絕。

必要範圍

使用和 registerBusiness 相同的 consumer 權杖。企業帳戶權杖會被拒絕,且不接受 Basic 認證。

基本查詢結構

此查詢不接受參數。

回應詳細資訊

BusinessSubCategory

回傳的類別依 categoryName 遞增排序。

cURL 範例

回應範例

錯誤代碼

此查詢會將所有失敗回傳在最上層的 errors 陣列中——不會有 success: false 的回傳內容。

注意事項

  • 使用者在此選擇的類別會在 KYB 期間由人工審核閱讀,因此請在介面中於適當位置顯示 categoryDescription,以協助他們更準確地選擇。
  • 只傳其中一個 ID 會在註冊時以 ARG-0002 被拒絕。務必同時傳遞兩者。

相關頁面

KYB 概覽

先決條件與端到端註冊流程。

註冊商家

使用這些 ID 的 mutation。