先决条件
- 使用创建实体创建的实体,以及其每个文档的
documentId。 - 文件格式为 JPG、PNG 或 PDF,每个文件最大 10 MB。
每个文档的文件
一个文档可以包含任意数量的文件。每个文件都有一个类型:
已 APPROVED 的文件无法替换(409
PROOF_APPROVED)。误上传的文件在未获批准之前,可通过删除证明文件删除。
分步说明
- 如果实体尚无该文档,请使用添加文档声明该文档。保留其
documentId。 - 使用上传证明文件上传文件:
POST /api/entity/v1/documents/{docId}/proofs?proofType=FRONT,格式为multipart/form-data,并包含名为file的部分。 - 检查上传结果:201 响应中的
sizeBytes必须大于零,且mimeType符合预期。 - 对身份证件的背面(
proofType=BACK)和自拍照(proofType=SELFIE)以及其他每个文档重复上述步骤。 - 使用获取 KYC 状态检查覆盖情况。
documentationStatus必须为COMPLETE,实体才可供审核。
上传文件
Request
Response
检查覆盖情况
KYC状态(两个文件都准备就绪后):读回文件
获取证明文件会返回元数据以及有效期为 10 分钟的downloadUrl。下载证明文件会直接重定向到该链接。两者都会记录审计,并关联您访问令牌中的用户。
替换被拒绝的文件
当合规部门拒绝某个证明文件时,文档将变为REJECTED,verificationReason 会说明原因:
PENDING_KYC 后,请使用相同的 proofType 上传新文件。被拒绝的证明文件将被替换,文档恢复为 PENDING。完成更正后,请再次调用请求验证。
编辑文档
更新文档可更改签发国家/地区、日期和元数据。任何更改都会将该文档已获批准的证明文件重置为PENDING。类型和编号不可更改:请改为添加新文档并删除旧文档。主文档无法删除。
常见错误
下一步
跟踪审核并修正被拒项
根据审核结果,更正 Localpayment 要求的内容。
文件和证明类型
可接受的文档和证明类型以及文件约束。

