当使用《获取个人核身认证地址》/《获取组织机构核身认证地址》接口获取的H5地址，在开发者自身App内集成使用，想要返回App自身页面时需要按照以下传参：
一、《获取个人核身认证地址》/《获取组织机构核身认证地址》接口请求参数
1、origin参数传入："APP"；
2、redirectUrl参数传入H5拼接地址或者Scheme拼接地址：
方式一：Http协议地址?esignAppScheme=开发者的APP Scheme+自定义拼接地址
格式：【h5地址】?esignAppScheme=【Scheme拼接地址】（其中esignAppScheme=为固定值，注意不要做编码）
假设APP的Scheme=esign，以《获取个人核身认证地址》为例，代码示例如下：
{
"contextInfo": {
"contextId": "自定义业务标识001",
"origin": "APP",
"redirectUrl": "https://www.esign.cn?esignAppScheme=esign://demo/realBack"
},
"indivInfo": {
"name": "张三",
"certNo": "41042*****555"
}
}方式二：直接传开发者的APP的Scheme+自定义拼接地址
格式：【Scheme拼接地址】
假设APP的Scheme=esign，以《获取个人核身认证地址》为例，代码示例如下：
{
"contextInfo": {
"contextId": "自定义业务标识002",
"origin": "APP",
"redirectUrl": "esign://demo/realBack"
},
"indivInfo": {
"name": "张三",
"certNo": "41042*****555"
}
}重定向跳转 | 示例 | 描述 |
开发者App内打开某个H5页面 | "redirectUrl": "https://www.esign.cn?esignAppScheme=esign://demo/realBack" | 认证后回到App，后打开H5地址（案例就是打开https://www.esign.cn） |
开发者App内某个自身页面 | "redirectUrl": "esign://demo/realBack" | 认证后回到App，开发者通过拦截Scheme做对应的跳转 |
二、认证完成后重定向地址携带的参数
实名认证完成后进行重定向跳转时，e签宝会在开发者填写的重定向地址后面拼接参数。
示例如下：
https://www.esign.cn?esignAppScheme=esign://demo/realBack&serviceId=18xxx14&verifycode=6axxxacf60&status=true&contextId=467xxx6565&passed=true&lang=zh-CN
参数名称 | 描述 |
serviceId | e签宝流程ID |
verifycode | 可忽略 |
status | 认证状态（可根据该字段进行判断认证状态） true-成功，false-失败 |
passed | 认证是否通过（备选状态） true-通过，false-未通过 |
contextId | 开发者自定义业务标识 |
三、App对接DEMO下载
点击下载：App认证和签署内嵌H5对接Demo_V2.zip（更新时间：2025年01月21日）
（代码详细说明可以参考DEMO内文档）
我要纠错