KYB API

KYB API 是一种应用程式介面（API），可根据权威的公司资料核实企业身分，包括其注册纪录、法律状态、董事名单，以及最终受益所有人。Know Your Customer Limited 的 KYB API 直接连接 147 个司法管辖区的官方公司注册处进行即时核实，取得原始注册文件，建立递归式的实益拥有权组织图，并针对企业及其相关人士进行反洗钱（AML）及制裁筛查——所有功能均透过单一 REST API 提供，并附设免费的开发者沙盒环境。

什么是 KYB API？

KYB API 是一种用于执行「认识你的企业」（Know Your Business）审查的程式化介面，可确认公司是否存在、是否合法注册、是否维持良好状态，并识别其实际拥有及控制人。KYB（Know Your Business）是 KYC（Know Your Customer）在企业层面的对应概念：KYC 核实个人身分，KYB 则核实企业本身及其背后的相关人士。

一般而言，KYB API 可让你搜寻公司、建立核实案件、读取结构化的实体资料（名称、注册编号、状态、地址、董事等）、追溯实益拥有权、取得佐证文件，以及针对相关方进行制裁和监察名单筛查。它可省去客户尽职调查流程中人手查册及文件处理的步骤，将企业核实工作简化为几个 API 呼叫即可完成。

Know Your Customer 的 KYB API 具备哪些功能？

Know Your Customer 的 KYB API 透过单一资源——案件：

  • 核实公司：即时对照其官方注册处资料，并读取结构化的实体资料，包括名称、注册编号、状态、注册地址及董事名单。
  • 取得原始注册文件：包括查册纪录、公司注册证书、周年申报表等，即时从官方来源撷取。
  • 追溯实益拥有权（UBO），以递归式的多层组织图呈现，由企业母公司一直追溯至最终的个人拥有人。
  • 筛查实体及其相关人士，比对制裁名单、政治公众人物（PEP）及负面新闻名单，此功能已内建于公司案件之中，而非额外附加的模组。
  • 执行身分核实（KYC），于同一流程中对公司的受益所有人及董事进行核实，属于随附的补充功能。
  • 产生可供审计的 PDF 报告，记录已完成核实的案件内容。
  • 持续监察客户，于客户入户后透过警示及预定覆核日期，持续进行监察。

你只需完成一次整合，即可透过单一合约覆盖 147 个司法管辖区。

这个 KYB API 有何独特之处？

功能Know Your Customer一般以筛查为主的 KYB API
资料来源核实当下即时取自官方注册处多数依赖快取或第三方汇整的资料集
司法管辖区覆盖覆盖 147 个司法管辖区，深耕亚太并延伸全球多数仅限美国或个别地区
实益拥有权递归式多层组织图多数仅提供单层 UBO 名单
来源文件提供原始注册文件通常只有资料，没有来源文件
反洗钱及制裁筛查内建于公司案件之中多数为独立产品或需另聘供应商
开发者沙盒免费、高拟真度，提供逾 980 间模拟公司及个人资料多数须经销售洽谈或仅为模拟占位资料

这些差异均基于实际且具体的事实：覆盖范围即时取自官方来源，而非推算得出；拥有权结构属递归式，而非单层列表；提供的是原始文件本身，而非仅经解析的栏位资料。

KYB API 涵盖哪些司法管辖区？

此 API 连接 147 个司法管辖区的官方公司注册处，涵盖每个已连接司法管辖区内 100% 的合法注册实体。覆盖范围包括深耕的亚太市场（香港、新加坡、中国、马来西亚、印尼、菲律宾），以及欧洲、美洲、中东等全球市场，还有英属维京群岛、开曼群岛等离岸金融中心。你可以使用 ISO 3166-2 国家代码来识别司法管辖区，例如 GB、SG或HK。详情请参阅涵盖范围总览，查看各国家/地区的详细资料。

如何使用 KYB API 核实公司？

核实公司分为四个步骤：

  1. 搜寻：以公司名称或注册编号搜寻公司：POST /v2/Companies/search。
  2. 建立案件：根据所选结果建立案件：POST /v2/Companies。回应会传回一个caseCommonId，案件随即开始以非同步方式建立。
  3. 轮询至完成：GET /v2/Companies/{caseCommonId}，直至status为3（Ready，即完成）为止，届时结构资料已填入完毕。
  4. 读取结果：包括已核实的实体资料、控制实体及个人，以及递归式的拥有权组织图。

身分验证采用 OAuth2 客户端凭证授权模式：你需要以一组client_id及client_secret，换取一个短效的持有人权杖（bearer token）。完整流程请参阅指南，或参阅 10 分钟速成版的快速入门。

KYB API 是否包含反洗钱及制裁筛查？

是的。反洗钱筛查（涵盖制裁名单、政治公众人物及负面新闻）属于公司案件的一部分，涵盖实体本身及其相关人士。你可以检视命中结果，并以记录在案的理由排除误判，或重新执行筛查。这正是以 KYB 为核心的 API 的优势所在：筛查是已核实公司案件的一部分，而非另行整合的独立功能。相关定义请参阅词汇表。

是否有免费的 KYB 沙盒环境？

是的。位于https://api.knowyourcustomer.dev的沙盒环境是标准 KYC 平台的免费、高拟真度复制版本，并非简化的模拟介面。当中已预载逾 980 间模拟公司及个人资料，并按司法管辖区设定延迟设定档，模拟实际生产环境的回应时间（仅为模拟数值，非即时量测），亦不会产生实际的官方注册处查册费用。介面规格、回应格式及状态流程均与正式环境一致，因此在沙盒中建立的整合，只需更换基础网址（base URL）及凭证，即可直接于正式环境运作。存取权限透过申请页面上的签署及开通流程取得。

持续的 KYB 监察如何运作？

客户入户后，即时监察功能会持续针对每宗案件进行筛查，一旦出现新的制裁、政治公众人物或负面新闻命中，即会发出警示。你可以查看警示清单、检视个别警示，并以记录在案的处理结果作出跟进。你亦可为案件设定覆核日期，安排定期重新审查。这就是「持续式 KYB」的概念：核实工作不会在客户入户后便告终止。详情请参阅持续式 KYB。

常见问题

什么是 KYB 与 KYC 的分别？ KYB 核实企业本身及其拥有权结构；KYC 则核实个人身分。此 API 以 KYB 为核心，并将针对公司拥有人及董事的 KYC 核实作为补充功能一并提供。

资料是即时还是快取取得？ 即时取得。公司案件是在核实当下直接对照官方注册处建立，并非来自快取资料集。

涵盖多少个司法管辖区？ 共 147 个，每个已连接的司法管辖区均涵盖 100% 的合法注册实体。

可否取得原始注册文件？ 可以。此 API 会传回最新的原始注册文件，而不仅是经解析的栏位资料。

是否需要联络销售团队才能试用？ 不需要。沙盒环境免费提供，并可透过自助式的签署及开通存取流程自行取得。