实名认证与授权认证回调通知说明

更新时间：2022-05-12 16:11:43

关于认证回调通知需知

重试机制

区别于签署相关业务的回调通知，开发者请注意认证结果的回调通知的重试规则：首次调用超时时间5秒，第一次调用失败后，3秒后重试；第二次调用失败后间隔6秒再次重试，若再次失败则不再进行通知。

接收响应

开发者需在接收到回调请求时，返回 HTTP状态码 200，例如：{"code":"200","msg":"success"}。

提示

为了保障异步通知的可靠性，建议在回调请求处理中，尽可能减少业务操作，改用异步方式处理后续业务流程。

回调通知参数表

参数名	必填	参数类型	说明（描述过长，请注意左右拖动查看）
type	是	string	标记该通知的类型 PERSON：个人 ORGANIZE：机构
state	否	string	开发者自定义的业务参数，原样返回【获取认证链接】接口中所传的state值。
code	否	string	认证链接拼接code值只有授权认证模式会返回
flowId	否	string	实名认证服务产生的流程编号，接口使用可忽略
willId	否	string	意愿认证服务产生的流程编号，接口使用可忽略个人认证场景：当用户个人已经在e签宝官网做过实名但未在该appid下做过授权时，触发用户个人意愿认证机构认证场景：当机构和经办人均已在e签宝官网做过实名时，但未在该appid下做过授权时，触发经办人意愿认证只有授权认证模式会返回
willType	否	string	意愿认证类型，固定值：THIRD_AUTH 只有授权认证模式会返回
success	是	boolean	认证状态，是否成功。目前只有成功会返回，值为：true
mobile	否	string	用户在e签宝SaaS官网的登录手机号
email	否	string	用户在e签宝SaaS官网的登录邮箱
accountId	否	string	e签宝SaaS官网个人账号ID 只有个人认证场景会返回
orgId	否	string	e签宝SaaS官网机构账号ID 只有机构认证场景会返回
orgName	否	string	用户在e签宝SaaS官网已认证的机构名称只有机构认证场景会返回
agentAccountId	否	string	机构认证中的经办人在e签宝SaaS官网的账号ID 只有机构认证场景会返回
agentFlowId	否	string	机构认证中的经办人认证流程编号，接口使用可忽略只有机构认证场景会返回

回调通知示例

个人实名认证模式

{
    "type": "PERSON",
    "state": "jilinTest1",
    "flowId": "2026037338014484001",
    "success": true,
    "mobile": "13800001111",
    "accountId": "f06d94be6ced4a95bf15e4c5ea5d0001"
}

机构实名认证模式

{
    "type": "ORGANIZE",
    "state": "jilinTest2",
    "flowId": "2030003681877296002",
    "success": true,
    "mobile": "13800001111",
    "orgName": "esigntest霁林哦哦测试企业",
    "orgId": "ede017f6001e4474a355bb3df6e66002",
    "agentFlowId": "2030003682229618002",
    "agentAccountId": "f06d94be6ced4a95bf15e4c5ea5d7002"
}

个人授权认证模式

{
    "type": "PERSON",
    "code": "e63a26f848a5e0446dad8a0fb82ed003",
    "state": "jilinTest3",
    "flowId": "2031708841053783003",
    "success": true,
    "mobile": "13800001111",
    "accountId": "f06d94be6ced4a95bf15e4c5ea5d7003"
}

{
    "type": "PERSON",
    "code": "3893116f486a6dfb1c189375b4e86003",
    "state": "jilinTest3",
    "willId": "will_33537adf2c194e4a900848bb40a7b003",
    "willType": "THIRD_AUTH",
    "success": true,
    "mobile": "13800001111",
    "accountId": "8d28bf96b22744059f5c7fae823b1003"
}

机构授权认证模式

{
    "type": "ORGANIZE",
    "code": "47057122d8c9741355da70d2c6cee004",
    "state": "jilinTest4",
    "flowId": "2030029265823074004",
    "success": true,
    "mobile": "13800001111",
    "orgName": "esigntest霁林哦哦测试企业",
    "orgId": "ede017f6001e4474a355bb3df6e66004",
    "agentFlowId": "2031775545653986004",
    "agentAccountId": "f06d94be6ced4a95bf15e4c5ea5d7004"
}

{
    "type": "ORGANIZE",
    "code": "961a7ca7542acadae92959cb4cb9a005",
    "state": "jilinTest5",
    "willId": "will_ac14d258fa39452eae8e7be894f43005",
    "willType": "THIRD_AUTH",
    "success": true,
    "mobile": "13800001111",
    "orgName": "esigntest霁林哦哦测试企业",
    "orgId": "53c1cd189cb345d297f81e3242fdb005",
    "agentAccountId": "f06d94be6ced4a95bf15e4c5ea5d7005"
}