跳转到主要内容
文档是已声明的数据(类型和编号)。证明文件是支持该文档的文件。本指南介绍如何向实体添加文档、逐个上传文档文件、替换或删除文件,并检查每份文档是否均已覆盖,以确保实体已准备好接受审核。

先决条件

  • 使用创建实体创建的实体,以及其每个文档的 documentId。
  • 文件格式为 JPG、PNG 或 PDF,每个文件最大 10 MB。

每个文档的文件

一个文档可以包含任意数量的文件。每个文件都有一个类型: 已 APPROVED 的文件无法替换(409 PROOF_APPROVED)。误上传的文件在未获批准之前,可通过删除证明文件删除。

分步说明

  1. 如果实体尚无该文档,请使用添加文档声明该文档。保留其 documentId。
  2. 使用上传证明文件上传文件:POST /api/entity/v1/documents/{docId}/proofs?proofType=FRONT,格式为 multipart/form-data,并包含名为 file 的部分。
  3. 检查上传结果:201 响应中的 sizeBytes 必须大于零,且 mimeType 符合预期。
  4. 对身份证件的背面(proofType=BACK)和自拍照(proofType=SELFIE)以及其他每个文档重复上述步骤。
  5. 使用获取 KYC 状态检查覆盖情况。documentationStatus 必须为 COMPLETE,实体才可供审核。

上传文件

Request
Response
在Python中,检查存储文件的大小并处理上传错误:

检查覆盖情况

KYC状态(两个文件都准备就绪后):

读回文件

获取证明文件会返回元数据以及有效期为 10 分钟的 downloadUrl。下载证明文件会直接重定向到该链接。两者都会记录审计,并关联您访问令牌中的用户。
已签名的 downloadUrl 在过期之前可用于访问该文件。请勿存储该链接或与第三方共享。需要再次访问该文件时,请重新申请。

替换被拒绝的文件

当合规部门拒绝某个证明文件时,文档将变为 REJECTED,verificationReason 会说明原因:
实体恢复为 PENDING_KYC 后,请使用相同的 proofType 上传新文件。被拒绝的证明文件将被替换,文档恢复为 PENDING。完成更正后,请再次调用请求验证。

编辑文档

更新文档可更改签发国家/地区、日期和元数据。任何更改都会将该文档已获批准的证明文件重置为 PENDING。类型和编号不可更改:请改为添加新文档并删除旧文档。主文档无法删除。

常见错误

下一步

跟踪审核并修正被拒项

根据审核结果,更正 Localpayment 要求的内容。

文件和证明类型

可接受的文档和证明类型以及文件约束。
最后修改于 2026年11月10日