跳转到主要内容
GET
获取 KYC 状态
返回审核状态的精简树:实体状态、文件覆盖情况、每份文件和每个有效证明的状态,以及上次状态更改的原因。使用它来跟进 Localpayment 执行的审核。
  • 主示例截取自案例处于 IN_REVIEW 状态且两个文件均已获批准时;第二个示例截取自上传后不久,此时文件仍为 PENDING。
  • documentationStatus: COMPLETE 表示每份文件都有对应的文件;这并不意味着文件已获批准。批准情况体现在 documents[].status = VERIFIED 和 proofs[].verificationStatus = APPROVED 中。
错误使用带有固定 code 的 application/problem+json。完整目录:实体状态和错误代码。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

用于身份验证的 Bearer 访问令牌。该令牌可从获取访问令牌或刷新访问令牌endpoint 获取。系统将据此识别您的商户账户和执行操作的用户。

示例:

"Bearer <your_access_token>"

X-Correlation-ID
string

跟踪标识符(UUID)。会在响应中原样返回;如未提供,则由 Localpayment 生成。

示例:

"0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10"

路径参数

entityId
string<uuid>
必填

实体的 internalId。

示例:

"5aced5da-40c1-4bec-85ff-c8cd1bcb4526"

响应

OK。

entityId
string<uuid>

实体。

示例:

"5aced5da-40c1-4bec-85ff-c8cd1bcb4526"

status
enum<string>

实体状态。请参阅实体状态和错误代码。

可用选项:
PENDING_KYC,
IN_REVIEW,
ACTIVE,
REJECTED,
BLOCKED,
CLOSED
示例:

"IN_REVIEW"

documentationStatus
enum<string>

NO_FILES、PARTIAL、COMPLETE。

可用选项:
NO_FILES,
PARTIAL,
COMPLETE
示例:

"COMPLETE"

statusReason
string

上次状态更改的原因,或为空。当 Localpayment 将实体返回到 PENDING_KYC 状态时,它会说明需要更正的内容。

示例:

"Review started"

documents
object[]
最后修改于 2026年11月10日