KYB · 企業驗證

企業准入流程：企業信息、關聯方、文件與表單。

企業客戶入駐流程。使用 eventType: "KYB_EVENT"。

流程概覽

公司信息
關聯方採集
必傳文件（主體 + 關聯方）
選傳文件
必填表單（主體 + 關聯方）
[AML/制裁篩查]
決策

KYB 節點路由表

nodeType	API	描述
`flow_action_corporate_particular`	`workflow.kyb.particular.data`	提交企業實體信息
`flow_action_corporate_crp_collector`	workflow.kyb.crp.ind.particular / workflow.kyb.crp.corp.particular / workflow.kyb.crp.submit	提交董事、股東、UBO
`flow_action_corporate_required_document`	`workflow.kyb.corp.required.doc` + `.submit`	上傳主體及關聯方文件
`flow_action_corporate_nonrequired_document`	`workflow.kyb.corp.non.required.doc` + `.submit`	可選文件（可跳過）
`flow_action_corporate_required_forms`	`workflow.kyb.corp.required.form` + `.submit`	提交主體及關聯方表單

企業信息

接口: workflow.kyb.particular.data POST

{
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:corporate_particular:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001",
  "corporateData": "{\"name\":\"Acme Corp Pte Ltd\",\"industry\":\"INFORMATION TECHNOLOGY\",\"entityType\":\"PRIVATE LIMITED COMPANY\",\"countryOfIncorporation\":\"SG\",\"countryOfOperations\":\"SG\",\"email\":\"corp@acme.com\"}"
}

corporateData 是 JSON 編碼的字符串，與 KYC 中的 personData 格式一致。

關聯方採集

企業信息提交後，採集關聯方（Connected Related Parties）: 董事、股東、最終受益人 (UBO)。

關聯方元數據

nextStep.metadata 指定需填充的角色:

{
  "totalRequiredRoles": 2,
  "requiredRoles": [
    { "roleId": "DIRECTOR", "allowIndividual": true, "allowCorporate": false },
    { "roleId": "SHAREHOLDER", "allowIndividual": true, "allowCorporate": true }
  ]
}

字段	描述
`requiredRoles`	必須填充的角色
`allowIndividual`	該角色是否可爲個人?
`allowCorporate`	該角色是否可爲企業?

提交個人關聯方

接口: workflow.kyb.crp.ind.particular POST

{
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:crp_collector:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001",
  "personData": "{\"name\":\"Jane Director\",\"nationality\":\"SG\",\"date_of_birth\":\"1985-03-20\",\"sex\":\"FEMALE\",\"roles\":[{\"roleId\":\"DIRECTOR\",\"roleName\":\"Director\"}]}"
}

保存返回的 crpPid — 後續此關聯方的活體檢測、文件和表單提交均需使用。

提交個人關聯方活體檢測

接口: workflow.kyb.crp.ind.liveness POST

與 KYC 活體檢測格式相同，額外傳入 crpPid 字段:

{
  "provider": "SELF",
  "status": "PASS",
  "scores": "{\"qualityScore\":1.0,\"brightnessScore\":100,\"brightnessStatus\":\"normal\"}",
  "images": "{\"faceFull\":\"s3://workflow-kyc/.../jane_photo.jpg\"}",
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:crp_collector:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001",
  "crpPid": "acc45a86-f2e9-48c2-8fcd-2bf6563357a1"
}

提交企業關聯方

接口: workflow.kyb.crp.corp.particular POST

{
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:crp_collector:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001",
  "corporateData": "{\"name\":\"CRP Holdings Pte Ltd\",\"entityType\":\"ASSOCIATION\",\"countryOfIncorporation\":\"SG\",\"roles\":[{\"roleId\":\"SHAREHOLDER\",\"roleName\":\"Shareholder\"}]}"
}

完成關聯方提交

接口: workflow.kyb.crp.submit POST

{
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:crp_collector:exec-abc123def456:..."
}

必須調用 crp.submit 以推進工作流。僅提交各關聯方不會觸發流程流轉。

KYB 必傳文件

接口: workflow.kyb.corp.required.doc POST

爲主體（crpPid: ""）和各關聯方（crpPid: "acc45..."）上傳文件。doc 字段結構與 KYC 相同。完成後調用 workflow.kyb.corp.required.doc.submit。

主體文件:

{
  "doc": "{\"front\":{\"url\":\"s3://workflow-kyc/.../cert.png\",\"filename\":\"cert.png\",\"content_type\":\"image/png\",\"size\":85618}}",
  "isRequired": true,
  "docType": "CERTIFICATE_OF_INCORPORATION",
  "extraData": "{\"issueDate\":\"2001-05-10\",\"expiryDate\":\"2030-10-10\"}",
  "crpPid": "",
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:corporate_document:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001"
}

個人關聯方文件（雙面）:

{
  "doc": "{\"front\":{\"url\":\"s3://...front.png\",\"filename\":\"front.png\",\"content_type\":\"image/png\",\"size\":849092},\"back\":{\"url\":\"s3://...back.png\",\"filename\":\"back.png\",\"content_type\":\"image/png\",\"size\":950146}}",
  "isRequired": true,
  "docType": "NATIONAL_ID",
  "extraData": "{\"documentNumber\":\"12034\"}",
  "crpPid": "acc45a86-f2e9-48c2-8fcd-2bf6563357a1",
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:corporate_document:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001"
}

KYB 可選文件

請求體與必傳文件相同。使用 workflow.kyb.corp.non.required.doc 上傳。無論是否上傳，均需調用 workflow.kyb.corp.non.required.doc.submit 以推進。

KYB 必填表單

接口: workflow.kyb.corp.required.form POST

元數據字段	填寫方
`mainForm`	主體企業
`crpIndividualForm`	每個個人關聯方
`crpCorporateForm`	每個企業關聯方
`crpBothForm`	每個股東關聯方

主體表單:

{
  "formId": "CorporateForm",
  "formData": "{\"field_firm_size_level\":\"small_5_19\",\"field_has_branch\":\"no\"}",
  "crpPid": "",
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:corporate_form:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001"
}

個人關聯方表單:

{
  "formId": "IndividualCRPForm",
  "formData": "{\"field_0_0\":\"test\",\"field_0_1\":\"Singapore\"}",
  "crpPid": "acc45a86-f2e9-48c2-8fcd-2bf6563357a1",
  "executionId": "exec-abc123def456",
  "callbackKey": "kyb:corporate_form:exec-abc123def456:...",
  "referenceId": "onboarding-uuid-001"
}

提交所有表單（主體 + 各關聯方）後，調用 workflow.kyb.corp.required.form.submit。

請根據工作流返回的 nextStep 元數據確定所需的關聯方角色、活體檢測、文件與表單。保存每個關聯方的 crpPid；僅對上方主體企業示例使用空的 crpPid。