| 400 | CUSTOM_FIELDS_INVALID | attributes 不符合您的自定义字段架构。details[] 列出了字段和问题。 |
| 400 | MISSING_OR_INVALID_CLIENT_CODE | 请求中无法识别您的商户账户。请检查您使用的凭证。 |
| 400 | VALIDATION_ERROR | 字段、标头、路径或查询参数缺失、未知或无效。details[] 列出了字段和问题。 |
| 401 | MISSING_OR_INVALID_ACTOR | 访问令牌无法识别执行操作的用户。 |
| 401 | UNAUTHORIZED | 缺少或无效的访问令牌。 |
| 403 | TENANT_MISMATCH | 该请求混合使用了两个商户账户的标识符。请检查您使用的凭证。 |
| 404 | CLIENT_NOT_FOUND | 您提供的凭证中的商户账户在 Localpayment 中不存在。 |
| 404 | CUSTOM_FIELD_SCHEMA_NOT_FOUND | 您的商户未发布任何自定义字段架构。 |
| 404 | DOCUMENT_NOT_FOUND | 该文件不存在、已被删除或属于其他商家。 |
| 404 | ENTITY_NOT_FOUND | 该实体不存在或属于其他商家。 |
| 404 | PROOF_NOT_FOUND | 该证明不存在,或者属于其他商家。 |
| 404 | UBO_NOT_FOUND | UBO 链接不存在、已失效或属于其他商家。 |
| 409 | CONCURRENT_MODIFICATION | 同一文档上相同 proofType 的两次上传同时发生。请重试请求。 |
| 409 | DUPLICATE_ENTITY | externalId,或者文档的类型 + id 对,已存在于您的商户中。 |
| 409 | ENTITY_IN_REVIEW | 该实体处于 IN_REVIEW 状态:在 Localpayment 合规团队处理完毕之前,其数据、文档、文件和 UBO 关联均被冻结。 |
| 409 | ENTITY_NOT_EDITABLE | 该实体处于 REJECTED、BLOCKED 或 CLOSED 状态,或该操作会删除主文档或唯一文档。 |
| 409 | INVALID_STATUS_TRANSITION | 该实体当前状态不允许此操作(例如,已处于 CLOSED 状态的实体)。 |
| 409 | PROOF_APPROVED | 该证明为 APPROVED 状态:不可替换或删除。 |
| 409 | PROOF_SUPERSEDED | 该证明已被同一文档上相同 proofType 的较新上传文件取代。仅审核当前有效的证明。 |
| 409 | UBO_ALREADY_LINKED | 此人已与该公司存在有效的最终受益所有人 (UBO) 关系。 |
| 409 | UBO_LIMIT_EXCEEDED | 该公司已有 50 个活跃的 UBO 链接。 |
| 412 | VERSION_CONFLICT | If-Match 与当前实体版本不匹配。请重新读取实体并重试。 |
| 413 | FILE_TOO_LARGE | 上传的文件超过 10 MB。 |
| 413 | PAYLOAD_TOO_LARGE | attributes 超过 64 KB。 |
| 415 | UNSUPPORTED_FILE_TYPE | 上传的文件不是 JPG、PNG 或 PDF 格式。 |
| 415 | UNSUPPORTED_MEDIA_TYPE | 请求的 Content-Type 不是 endpoint 期望的类型(application/json,或用于上传的 multipart/form-data)。 |
| 422 | ENTITY_NOT_ACTIVE | 公司(或个人)处于 CLOSED、BLOCKED 或 REJECTED 状态。 |
| 422 | INCOMPLETE_KYC_DATA | 缺少最低限度的 KYC 数据:INDIVIDUAL 需要 name 和 lastname,COMPANY 需要 name。 |
| 422 | INVALID_CONTROL_ROLE | controlRole 不是“链接 UBO”中列出的角色代码之一。代码区分大小写:director 会返回此错误。 |
| 422 | INVALID_ENTITY_TYPE | companyId 必须是 COMPANY,personId 必须是 INDIVIDUAL。 |
| 422 | INVALID_PERCENTAGE | ownershipPercentage 不在 0 到 100 的范围内,或小数位超过两位。 |
| 422 | INVALID_VALIDITY_RANGE | validTo 早于 validFrom。 |
| 422 | NO_PROOFS_UPLOADED | 该实体没有已上传的文件。请求验证之前,请至少上传一个文件。 |
| 502 | STORAGE_WRITE_FAILED | 文件无法保存,请重试上传。 |
| 503 | CLIENT_DIRECTORY_UNAVAILABLE | 目前 Localpayment 无法解析您的商户账户。请稍后重试。 |