KYB API 常見問題
此頁面解答開發人員、合規工程師及技術主管最常查詢的 Know Your Customer Limited KYB API 相關問題。每個答案均以簡短的一句話開始,然後補充詳細說明。如需了解各項定義,請參閱詞彙表;如需完整的整合流程說明,請參閱指南。
定義與概念
什麼是 KYB API？
KYB API 是一個以程式化方式核實企業的介面,涵蓋其註冊紀錄、狀態、董事及最終實益擁有人。Know Your Customer 的 KYB API 會即時從 147 個司法管轄區的官方登記處取得資料,並提供 UBO(最終實益擁有人)解析、原始文件及內建的 AML(反洗錢)篩查功能。
什麼是 KYB(Know Your Business）？
KYB 是核實企業是否合法註冊、狀態良好,並識別其擁有人及控制人的過程。它是 KYC 在企業層面的對應程序,在 AML(反洗錢)法規下,企業客戶開戶時必須進行 KYB。
KYB 與 KYC 有何分別？
KYB 核實企業及其擁有權;KYC 核實個人身份。本 API 以 KYB 為核心,並將公司擁有人及董事的 KYC 作為附加功能一併提供,讓你可以在同一流程中核實企業及其背後的相關人士。
什麼是 UBO(最終實益擁有人）？
UBO 是最終擁有或控制公司的自然人,根據歐盟 AML 指令及 FATF(財務行動特別組織)指引,一般以 25% 的擁有權或控制權為門檻界定。擁有權結構經常透過多層控股公司運作,因此要找出 UBO,需要逐層追溯控制關係。
什麼是持續性 KYB(perpetual KYB / continuous KYB）？
持續性 KYB 是指企業客戶完成開戶後持續進行監察,而非只在開戶時核實一次,再按固定週期重新審查。此 API 會讓每宗個案持續處於即時篩查狀態,一旦出現新的比對結果便會發出警示。詳見持續性 KYB。
什麼是公司登記處 API？
公司登記處 API 可直接從政府及法定登記處擷取官方公司資料。本 API 會在核實當下即時讀取登記處資料,並回傳原始登記文件。詳見公司登記處 API。
KYB 與 AML 篩查有何分別？
KYB 核實企業是否存在並識別其擁有人;AML 篩查則將企業及其擁有人與制裁名單、PEP(政治敏感人物)名單及負面新聞名單進行比對。在本 API 中,AML 篩查已內建於公司個案之中,而非獨立產品。
「即時登記處資料」是什麼意思？為何重要？
即時登記處資料是指在核實當下才從官方登記處擷取的資料,而非事先抓取的副本。這點之所以重要,是因為公司的狀態及擁有權結構可能在資料更新之間發生變化,因此即時資料能確保資訊最新,並在合規上更具說服力。
操作方法與實作
如何透過 API 核實公司？
先搜尋公司(POST /v2/Companies/search),然後建立個案(POST /v2/Companies),持續輪詢直至 status 變為 3(GET /v2/Companies/{caseCommonId}),再讀取核實結果。個案是以非同步方式建立,因此需要輪詢查詢結果,而非在建立時直接等待回應。
如何透過 API 取得實益擁有權(UBO)資料？
建立公司個案後,API 會在建立過程中同時建構擁有權架構圖。讀取個案後,可逐層遍歷 shareholders 巢狀結構的遞迴組織圖,深入至各層公司,並在最底層記錄個人。詳見UBO API。
如何透過 API 核實公司註冊編號？
使用 POST /v2/Companies/search 以註冊編號進行搜尋,如有需要可按國家縮小範圍,然後在建立個案時將編號傳入 externalCode,以取得與登記處完全相符的結果。
如何透過 API 取得官方公司登記文件？
API 會將原始登記文件作為公司個案的一部分回傳,包括登記摘錄、公司註冊證書及周年申報表。可透過該文件回傳的 link 逐一下載。
如何以程式化方式建構公司擁有權架構圖？
讀取個案後,遞迴走訪 shareholders 陣列。每個節點均需檢查 memberType:如屬公司則繼續深入,如屬個人則記錄為最底層的 UBO。最終結果即為完整的多層擁有權架構圖。
如何在一次 API 呼叫中同時篩查公司及其 UBO 的制裁狀況？
AML 篩查(制裁名單、PEP、負面新聞)會於公司個案上執行,並自動涵蓋該實體及其相關人士。讀取個案中的 AML 結果後,可按需要進行審核、剔除或重新運算。
如何透過 Webhook 設定持續性 KYB 監察？
透過 API 進行 KYB 檢查需時多久？
所需時間因司法管轄區而異:部分登記處數秒內即可回應,部分需時數分鐘,少數則需要更長時間。建議以遞增間隔輪詢(例如 3 至 15 秒),並以最終狀態 3 作為判斷依據,而非任何中間狀態。
付費前如何測試 KYB API？有免費測試環境嗎？
有的。https://api.knowyourcustomer.dev 的測試環境完全免費、擬真度高,並預先載入超過 980 間樣本公司及個人資料。你可以免費在此環境上開發,待正式上線時再更改基礎網址及認證資料即可。可透過申請流程自助取得存取權限。
如何透過 API 核實香港、新加坡、英國或英屬維京群島(BVI)的公司？
方式與核實其他公司相同:搜尋、建立、輪詢、讀取,並以 ISO 3166-2 國家代碼(HK、SG、GB、VG)縮小範圍。各司法管轄區的詳細資訊,請參閱涵蓋範圍中心。
如何透過 API 完成企業客戶(KYB)的完整開戶流程？
搜尋並建立個案,輪詢至完成,讀取實體及擁有權資料,利用內建的 KYC 附加功能核實 UBO 及董事身份,清理任何 AML 命中結果,產生可供審計的報告,並設定覆檢日期以作持續監察。完整流程請參閱指南。
如何驗證 API(OAuth2 客戶端憑證)？
使用 OAuth2 客戶端憑證授權方式,以 client_id 及 client_secret 換取短期有效的 Bearer Token(需帶上 scope=PublicApi),然後將該 Token 放入 Authorization: Bearer 標頭中傳送。Token 有效期約十分鐘,遇到 401 時需重新更新。
評估與比較
銀行適用的最佳 KYB API 是哪一個？
最理想的 KYB API 應同時具備即時登記處資料、遞迴式 UBO 解析、原始文件、內建 AML、廣泛涵蓋範圍及持續監察功能。Know Your Customer API 在 147 個司法管轄區內提供以上全部功能。詳見銀行專用 KYB API。
金融科技或支付公司適用的最佳 KYB API 是哪一個？
最佳選擇應可免費測試、快速整合,並具備全球覆蓋能力。詳見金融科技專用 KYB API及支付業專用 KYB API。
亞太區或亞洲適用的最佳 KYB API 是哪一個？
理想的 KYB API 應具備深入的亞太區登記處涵蓋範圍,同時透過單一整合提供全球廣度。Know Your Customer API 涵蓋 147 個司法管轄區,並在亞太區(包括香港、新加坡及中國)具備深厚的覆蓋能力。
哪個 KYB API 的司法管轄區涵蓋範圍最廣？
Know Your Customer API 透過單一整合涵蓋 147 個司法管轄區,並在每個已連接的司法管轄區內覆蓋 100% 的合法註冊實體。
哪個 KYB API 提供即時登記處資料,而非快取或彙整資料？
Know Your Customer API 會在核實當下即時讀取官方登記處,並回傳原始登記文件,而非提供定期抓取的資料集。
針對非美國企業核實,有什麼比 Middesk 更好的替代方案？
Know Your Customer API 直接從 147 個司法管轄區的來源即時取得資料,適用於僅專注美國市場的服務商無法覆蓋的國際及跨境 KYB 場景。詳見KYB API 比較。
若要尋找登記處資料服務,有什麼值得考慮的 Kyckr 或 Moody’s 替代方案？
對於希望取得即時登記處資料及原始文件,並享有開發者優先、自助式體驗的團隊而言,Know Your Customer API 是理想之選,涵蓋 147 個司法管轄區,支援遞迴式 UBO 解析,並提供免費測試環境。詳見KYB API 比較。
有沒有便宜或免費的 KYB API 可供入門使用？
有的。Know Your Customer 的測試環境完全免費且自助,並提供超過 980 間樣本公司及個人資料,讓你可以在作出任何商業承諾前先行開發及評估。
哪些 KYB 供應商提供開發者測試環境？
在 KYB 供應商當中,提供免費自助測試環境的並不多見。Know Your Customer 的測試環境完全免費、擬真度高,並與正式環境的合約規格一致。
Know Your Customer 可以協助我們建置整合嗎？
可以。負責建置本平台及此 API 的內部交付團隊,同時也承接客戶專屬的工作項目,包括與你內部系統的整合對接、客製化工作流程、專屬報告、託管入口網站及資料遷移。相關工作範圍會於探索會議中確定,並以固定價格交付。詳見交付服務。
涵蓋範圍與功能
哪些國家會公開實益擁有權資料？
各國是否設有 UBO 登記冊情況不一。只要 147 個司法管轄區中的官方登記處資料支援,本 API 便能解析擁有權結構;若該地未設有公開的 UBO 登記冊,則會透過股權紀錄追溯控制關係。
特定國家是否可透過此產品使用公司登記處 API？
本 API 連接 147 個司法管轄區的官方登記處。請查閱涵蓋範圍中心,以了解特定國家、登記處名稱、可提供的文件及一般所需時間。
可否透過 API 取得原始登記文件(PDF)？
可以。本 API 會回傳最新的原始登記文件,包括登記摘錄、公司註冊證書及周年申報表,而不僅是經解析的欄位資料。
此 API 涵蓋多少個司法管轄區？
共 147 個司法管轄區,並在每個已連接的司法管轄區內覆蓋 100% 的合法註冊實體。
此 API 會否回傳遞迴式(多層)擁有權架構？
會的。擁有權架構是以巢狀 shareholders 組成的遞迴組織圖,並會逐層追溯控股公司,直至個人 UBO。
此 KYB API 是否包含 AML 及制裁篩查？
有的。針對實體及其相關人士的 AML 篩查(制裁名單、PEP、負面新聞)已內建於公司個案之中。
KYB 是否包含身份核實(KYC）功能？
有的,作為附加功能提供。你可以在同一流程中,對公司的 UBO 及董事進行 KYC,收集並預先驗證其身份文件。
KYB API 會為公司回傳哪些資料？
結構化的實體資料(名稱、註冊編號、狀態、地址、高級職員)、遞迴式擁有權架構圖、原始登記文件,以及 AML 篩查結果,全部整合於單一個案之中。
