沙盒

这是什么

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）。我们的团队会审核每一项申请，一经批准，我们将以电邮方式传送您的沙盒凭证。之后请依照快速入门指示进行。