沙盒

這是什麼

Know Your Customer Limited 的沙盒是標準 KYC 平台的免費、高擬真度、完全依照合約規格的複製版本，網址為 https://api.knowyourcustomer.dev。它並非虛設或模擬環境。即時登記處的行為是根據超過 980 間樣本公司及個人（附有真實的股權架構樹及登記文件）模擬而成，讓您可以操作與正式環境相同的公司搜尋、實體資料、最終受益人（UBO）解析及文件流程。它執行相同的合約、傳回相同的回應格式，並讓案件經歷與正式環境相同的狀態流程。您在沙盒中建立的內容，只需變更基礎網址及憑證，即可直接於正式環境運作。

沙盒可免費使用，不會產生任何即時登記處費用，並以「現況」（as is）形式提供，不設服務水平協議（SLA）。

申請存取權限

已載入的內容

沙盒已預先載入具真實感的數據，讓您可以針對真實的架構進行開發：

• 超過 980 間樣本公司及個人，具備真實的股權架構，包括多層級的最終受益權。
• 合成個人資料，供身分核實及文件流程使用。
• 按司法管轄區設定的延遲設定檔，用以模擬正式環境的處理時間，讓您的輪詢及重試邏輯能在真實的延遲情況下運作。這些僅為模擬設定檔，並非即時登記處的實際量測數據。

三間適合入門的樣本公司

搜尋以上任何一間公司，建立案件，輪詢至就緒狀態，然後讀取其架構。詳見快速入門。

如需查看沙盒中可建立的所有內容的完整可搜尋清單，包括合成情境公司及個人，以及登記處公司的完整目錄，請參閱 Test cases 頁面。

如何反映正式環境

沙盒的設計讓您的整合上線時無需作出任何變更：

• 相同合約：端點、請求內文及參數完全相同。
• 相同格式：回應物件完全相同（caseCommonId、controllingEntitiesAndIndividuals、遞迴式組織架構圖、文件上載回應等等）。
• 相同狀態：案件以非同步方式建立，並經歷相同的狀態集合，附有真實的延遲，讓您能真正演練輪詢流程。

差異之處

如需查看沙盒與正式環境之間所有差異的完整、權威清單，請參閱 Sandbox Fidelity & Known Limitations。當中涵蓋刻意的差異（不收取登記處費用、模擬延遲、合成篩查及身分資料、僅供評估用途的報告）、已知的較低擬真度行為及其確切可觀察到的差異，以及如何分辨差異與缺陷。為貴機構在正式環境中建立的客戶專屬擴充功能或環境專屬客製化設定，並不會自動反映於沙盒中；如需在測試中複製這些設定，請與我們聯絡。沙盒以「現況」（as is）形式提供，不設服務水平協議（SLA）。

使用限制與合理使用

沙盒設有速率限制並須遵守合理使用原則，因此請將用戶端設計為快取持有人權杖（bearer token）、以退避（backoff）方式輪詢而非緊密迴圈，並以退避方式重試暫時性錯誤。429 代表您已被限速：請退避後重試。請勿對沙盒進行負載測試。

重設您的租戶

如要從頭開始，請刪除您所建立的案件。刪除案件會清除您的測試數據，讓您可以從零開始重新執行流程。您的租戶仍會保持已佈建狀態，僅案件本身會被移除。

樣本客戶盡職審查應用程式

您的沙盒存取權限包含一個完整、可複製的樣本企業客戶盡職審查網頁應用程式。它會針對 API 執行完整的 KYB 流程，由公司搜尋、股權及最終受益人解析、文件收集、反洗錢篩查，一直到客戶審查決定，並在內建的開發者及除錯檢視畫面中顯示原始 API 呼叫。您可將它作為參考實作，隨時閱讀、即日執行並加以調整。

在操作員控制台查看您的案件

您的沙盒存取權限包含一個隨時可用的操作員控制台，網址為 workspace.knowyourcustomer.dev。這是您內部合規人員所使用的 KYC Workspace 的精簡開發者版本：包含案件清單及分頁式案件詳情（公司概況、篩查、文件、股權架構、稽核紀錄），並顯示於您的沙盒租戶之上。使用您的沙盒 clientId 及 clientSecret 連接，或儲存一鍵書籤連結，即可以與內部審查人員完全相同的方式瀏覽您所建立的案件。這是最快了解一旦有案件存在後，您自己的使用者將會看到什麼畫面的方法。

準備開始建置

申請存取權限：提交您的資料並簽署沙盒測試協議（Sandbox Testing Agreement）。我們的團隊會審核每一項申請，一經批准，我們將以電郵方式傳送您的沙盒憑證。之後請依照快速入門指示進行。