提交用户同名認證 Match

PUT https://connect.cabital.com/api/v1/accounts/{account_id}/match

合作方可以透過此 API 提交用戶的 KYC 資訊，來完成用戶帳號的同名認證流程。

調用時機

1. 當用戶帳號狀態同名認證失敗時，也可以透過此 API 重新提交用戶新的 KYC 資訊，再次觸發同名認證流程。
2. 如果合作方的帳號開通條件為綁定且通過同名認證，當用戶帳號解除綁定並重新綁定時，也需要重新調用此 API 再次觸發同名認證流程。

用戶帳號狀態條件

• 已綁定
• 已通過實名認證

請求 Path 參數

參數	必填	說明
account_id	是	Cabital 提供的帳號 ID

請求 Body 參數

類型：application/json

參數	必填	類型	說明
id_document	是	string	證件類型，僅支援以下類型： ID： 身分證 PASSPORT： 護照
issued_by	是	string	發證國家 ISO 3166-1 三位字母代碼
id	是	string	證件上的號碼
dob	是	string	證件上的出生日期，格式 YYYY-MM-DD
name	是	string	用戶本人的全名，需按照證件上的名字順序。 如： 姓氏 名字：陳小明 First Name Middle Name Last Name： John Michael Doe

返回參數

參數	類型	說明
result	string	用戶同名認證結果 PENDING：無法自動同名認證，需等待 Cabital 人工審核 PASS： 自動同名認證成功 MISMATCH： 自動同名認證失敗
mismatch_fields	array[string]	同名認證失敗欄位

範例

請求數據

curl -X PUT "http://connect.cabital.com/api/v1/accounts/cdaa9983-9b8f-4478-ba60-896ac239879d/match" \
  -d '{ 
            "name": "John Doe",
            "id": "J12345678D",
            "id_document": "PASSPORT",
            "dob": "1970-01-01",
            "issued_by": "HKG"
      }'

返回數據

{
  "result": "MISMATCH",
  "mismatch_fields": [
    "name",
    "dob"
  ]
}