ACC-007-个人实名-H5地址

💡

ACC-006-个人实名-短信通知和 ACC-007-个人实名-H5地址二选一即可。ACC-007 直接返回 H5 地址，不发送短信。

若贵司系统内已保存客户的姓名、身份证号等基础信息，可通过本接口同步传入。已传入的信息会在 H5 页面中回显，减少客户重复录入。

接口处理规则

userInfo.name、userInfo.idNo、userInfo.phone 和 dutyId 必传。

系统首先校验姓名与身份证号；校验不通过时返回 907：姓名与身份证校验不通过，不生成 H5 地址。

身份证人像面、国徽面照片为可选字段，但必须同时传入或同时不传：

均不传：返回 H5 地址，由用户在 H5 页面继续完成实名。

均传入：图片 URL 必须可访问；系统执行 OCR，并校验人像面的姓名、身份证号与请求参数一致。OCR 不通过时不生成 H5 地址。

对尚未完成有效实名的用户，传入完整身份证照片后，系统会尝试自动实名：

手机号三要素通过，可完成自动实名。

手机号三要素未通过但银行卡四要素通过，也可完成自动实名。

两种校验均未满足时，仍返回 H5 地址，由用户在 H5 页面继续完成实名。

userInfo.bankNo 为可选字段；传入时可用于银行卡四要素校验。bankReservedPhone 未传时默认使用 userInfo.phone。

已存在有效实名记录的用户不会重复实名；若同时传入银行卡，则银行卡四要素校验通过后才会保存银行卡信息。

安徽代征同步失败处理

若 ACC-008 返回安徽代征同步失败，可再次调用本接口发起补偿同步。

如果失败原因提示身份证照片不清晰、无法识别或证件信息不一致，请重新上传本人清晰、完整的身份证人像面和国徽面照片，并在本次请求中同时传入新的 idNoFrontUrl、idNoBackUrl。

系统会先对新照片执行 OCR，校验姓名、身份证号和证件有效期；校验通过后更新身份证资料，再重新发起安徽代征同步。

新照片 OCR 不通过、身份证资料更新失败或补偿同步仍失败时，本接口返回对应错误，不生成 H5 地址；请根据返回的 code 和 message 处理。

主要错误说明

400：参数不完整、任务不存在，或身份证正反面未同时传入。

906：身份证 OCR 识别失败，或 OCR 姓名/身份证号与请求参数不一致。

907：姓名与身份证校验不通过。

其他业务错误：以响应中的 code 和 message 为准。

H5 页面预览

1. 中间页（待实名）

2. 实名信息填写页

3. 中间页（实名完成，待关系绑定）

4. 关系绑定刷脸页

5. 关系绑定列表页

6. 完成页

7. 实名信息详情页

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
    "userInfo": {
        "name": "张三",
        "idNo": "110101199003076178",
        "phone": "13800138000",
        "bankNo": "6222020200023456789",
        "idNoFrontUrl": "https://example.com/images/id-front.jpg",
        "idNoBackUrl": "https://example.com/images/id-back.jpg"
    },
    "dutyId": 123456789,
    "redirectUrl": "https://example.com/redirect"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

三要素验证失败

Bodyapplication/json

示例

{
    "code": 0,
    "message": "成功",
    "context": {
        "url": "https://considerate-shore.com/"
    },
    "traceId": "68941d23dc86a72d3cfbc175ee1a2964",
    "spanId": "5c7a0992e63085a8"
}

ACC-007-个人实名-H5地址

接口处理规则#

安徽代征同步失败处理#

主要错误说明#

H5 页面预览#

1. 中间页（待实名）#

2. 实名信息填写页#

3. 中间页（实名完成，待关系绑定）#

4. 关系绑定刷脸页#

5. 关系绑定列表页#

6. 完成页#

7. 实名信息详情页#