回调通知参数说明
- e签宝通过HTTP协议,POST 方法进行通知推送,内容为 JSON 字符串;
- 对接方在接收到回调请求时,200 ~ 299 之间的 HTTP 状态码均会被e签宝通知服务认定为通知成功;
- 为了保障异步通知的可靠性,建议业务方在回调请求处理中,尽可能减少业务操作,改用异步方式处理后续业务流程。
参数名称 | 类型 | 必选 | 参数说明 | |
action | string | 是 | 标记该通知的业务类型,该通知固定为:AUTOSIGN_AUTHORIZE_FINISH 【注】:开发者可以只关注当前action类型的回调(如果接收到其他附属通知内容可以忽略,例如:SIGN_MISSON_COMPLETE等) | |
timestamp | int64 | 是 | 回调通知发送时间(如重试多次均返回第一次时间,毫秒级时间戳格式) | |
orgName | string | 是 | 企业名称 | |
orgIdType | string | 是 | 企业证件类型 (1)CRED_ORG_USCC 统一社会信用代码,默认值 (2)CRED_ORG_CODE 组织机构代码证 | |
orgIdNum | string | 是 | 企业证件号 | |
authId | string | 是 | 授权流程ID | |
effectiveStartTime | Long | 否 | 授权生效时间(Unix时间戳格式,单位:毫秒) | |
effectiveEndTime | Long | 否 | 授权失效时间(Unix时间戳格式,单位:毫秒) | |
status | int | 是 | 授权状态 2 - 授权成功 3 - 授权失败 【注】:授权失败可能原因:(1)线上授权:用户拒签授权书 (2)超过发起日90天,授权书仍未签署,任务过期导致授权失败 ((1)和(2)均需要重新发起授权) | |
failReason | string | 否 | 失败理由 |
通知内容示例:
{
"action": "AUTOSIGN_AUTHORIZE_FINISH",
"timestamp": 1741344529441,
"orgName": "esigntest霁林测试20250219企业5",
"orgIdType": "CRED_ORG_USCC",
"orgIdNum": "913020202503114486",
"authId": "738dad702ce24f6e81801ee950af6b2a",
"effectiveStartTime": 1741276800000,
"effectiveEndTime": 1771689599000,
"status": 2
}
附 e签宝回调通知服务器信息
如果贵司需要防火墙配置后才允许e签宝消息通知服务推送数据,请根据下方信息进行贵司防火墙设置。
环境 | 公网IP |
沙箱模拟环境 | 47.96.79.204 |
线上正式环境 | 118.31.35.8 |