ACC-006-个人实名-短信通知

💡

ACC-006-个人实名-短信通知和 ACC-007-个人实名-H5地址二选一即可。ACC-006 对校验通过且需要继续办理的人员发送包含 H5 地址的短信。

本接口支持批量提交人员信息。系统逐人校验并在 context 中返回 isValid 和 msg；单个人员校验失败不会影响其他人员继续处理。

接口处理规则

customerList 和 dutyId 必传；同一次请求中身份证号不能重复。每个人员的 name、idNo、phone 必传。

系统逐人校验姓名与身份证号：

校验通过：继续后续处理。

校验不通过：该人员返回 isValid=0、msg=姓名与身份证校验不通过，不发送短信。

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

均不传：不执行 OCR，用户可在短信 H5 页面继续完成实名。

均传入：图片 URL 必须可访问；系统执行 OCR，并校验人像面的姓名、身份证号与请求参数一致。OCR 不通过时，该人员返回 isValid=0，不发送短信。

用户尚未完成有效实名时，需要满足以下任一条件：

手机号三要素通过。

手机号三要素未通过，但银行卡四要素通过。

两种校验均未满足：该人员返回 isValid=0 和具体失败原因，不发送短信。

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

完整身份证照片 OCR 通过且满足上述校验条件时，系统会尝试自动实名；无论是否需要自动实名，符合发送条件的人员均按业务状态决定是否发送短信。已经完成相关实名及后续业务的人员不会重复发送短信。

isValid=1 表示该人员通过本接口的前置校验；isValid=0 表示校验失败，失败原因见 msg。

安徽代征同步失败处理

本接口只负责批量校验和发送实名短信，不执行安徽代征失败补偿。重复调用本接口不能替代代征补偿同步。

若 ACC-008 返回安徽代征同步失败，请调用 ACC-007-个人实名-H5地址发起补偿。

如果失败原因提示身份证照片不清晰、无法识别或证件信息不一致，请重新上传本人清晰、完整的身份证人像面和国徽面照片，并通过 ACC-007 同时传入新的 idNoFrontUrl、idNoBackUrl。ACC-007 校验并更新身份证资料后，会重新发起安徽代征同步。

H5 页面预览

1. 中间页（待实名）

2. 实名信息填写页

3. 中间页（实名完成，待人脸核验）

4. 人脸核验刷脸页

5. 完成页

6. 实名信息详情页

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
	"customerList": [
		{
			"name": "张三",
			"idNo": "320123199001012345",
			"phone": "13800001111",
			"bankNo": "6222021234567890123",
			"idNoFrontUrl": "https://cdn.example.com/id/front_zhangsan.png",
			"idNoBackUrl": "https://cdn.example.com/id/back_zhangsan.png"
		},
		{
			"name": "李四",
			"idNo": "320123199502123456",
			"phone": "13900002222",
			"idNoFrontUrl": "https://cdn.example.com/id/front_lisi.png",
			"idNoBackUrl": "https://cdn.example.com/id/back_lisi.png"
		}
	],
	"dutyId": 10001,
	"directUrl": "https://example.com/contract/redirect"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

三要素验证失败

Bodyapplication/json

示例

{
    "code": 904,
    "message": "三要素校验不通过",
    "context": [
        {
            "name": "张三",
            "idNo": "132302197902278809",
            "phone": "13888888888",
            "isValid": 0
        },
        {
            "name": "张三",
            "idNo": "132302197902278809",
            "phone": "13888888888",
            "isValid": 1
        }
    ],
    "traceId": "67e67c679247d31bda724a04c04d8c97",
    "spanId": "ca83779156e434f8"
}

ACC-006-个人实名-短信通知

接口处理规则#

安徽代征同步失败处理#

H5 页面预览#

1. 中间页（待实名）#

2. 实名信息填写页#

3. 中间页（实名完成，待人脸核验）#

4. 人脸核验刷脸页#

5. 完成页#

6. 实名信息详情页#