异步通知服务

回调说明

目的

电子签系统中用户实名认证、印章制作、合同签署、合同状态变更等业务发生时，电子签系统需回调接入方业务系统，推送相应的事件消息，以实现数据的同步。

注意事项

须严格遵照基本要求使用异步通知功能：
1．回调地址必须支持http或者https格式；
2．请求类型必须为POST，Content-Type =“application/json”；
3．必须是一个完整的URL(如：https://www.yourdomain.com/message/receiveResult),不能是一个相对路径（/message/receiveResult
4．如果确认回调成功，则直接返回字符串"success"；
5．重推规则：当未收到"success"时，开放签立即尝试重发3次通知，若3次仍不成功，则后续通知的间隔频率为：30m、2h、24h，24h后不再推送；
6．开放签会对回调数据进行签名，生成sign，业务系统在接收到回调数据后，可使用开放签的公钥进行验签，从而确保数据的完整性，同时识别开放签的身份。

公钥：

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAky8KbmNesltytP9ihgLoyL6iJOnia753DsCHRwnO0pBf4V1j3qACG/C9wOw0dvarG4n7IV/uFhPWyZn2NQrZ8wLIw7lsK71+6vnaKNeyzSnx3I1GduG3adlsIE14LxNcJOaD+Dis85O4jQlM8bOifLRQAC5BWTfxkWn1lXWtoNdsS+GKpPEzDFuSeXU0cJM3ziJcgOdE46kJfsu7ES5kANQaac13guwOLEnqD6uKQGixvB7bqMmiUCq+KT61GZdtIC/NcrXRKti5R/fbllbKAEe9n/e2YIp0G4ZWsc2Eg5nIaPwUmNES7fnFNqb7QFRSmT4FBmJXE1Zwk6ZCprB66QIDAQAB

回调参数说明

陌生用户实名认证

陌生用户在签署时需先完成实名认证，认证完成后方可签署合同，同时如果在创建该用户时，接口指定了异步回调通知地址【authCallbackUrl】，则需要将认证成功的结果进行回调通知。

通知参数

字段ID	类型	备注
businessType	Integer	业务类型： 1.用户实名认证； 2.印章制作； 3.合同签署相关；传递1
account	String	账号，用户唯一识别码
userType	Integer	认证主体类型： 1.个人； 2.企业
name	String	个人姓名/法人姓名
idCard	String	个人身份证号/法人身份证号
companyName	String	企业名称
creditCode	String	统一社会信用代码
authStatus	Integer	实名状态：0.未实名；1.已实名；2.认证中
serialNo	String	认证流水号
identifyTime	String	完成认证时间

印章制作

陌生用户在签署时进行实名认证，实名认证完成后，系统会根据实名信息为用户制作默认印章，接口指定了异步回调通知地址【authCallbackUrl】，则需要将印章制作的结果进行回调通知。

通知参数

字段ID	类型	备注
businessType	Integer	业务类型： 1.用户实名认证； 2.印章制作； 3.合同签署相关；传递2
account	String	账号，用户唯一识别码
userType	Integer	主体类型：1.个人；2.企业
sealNo	String	印章唯一编号
sealName	String	印章名称
isDefault	Integer	是否默认,0.否 1.是
sealUrl	String	印章下载地址

合同及签署

合同签署流程中发生发送合同、填写提交、签署、撤回、完成签署等事件时，电子签系统会向对接方在合同发起时指定的异步回调通知地址【contractCallbackUrl】推送相应的事件消息，进行数据的同步。

通知参数

字段ID	类型	备注
businessType	Integer	业务类型： 1.用户实名认证； 2.印章制作； 3.合同签署相关；传递3
contractNo	String	合同唯一编号
contractStatus	String	合同状态，见contractStatus表
callbackType	String	通知的事件类型，见下表
account	String	账号，用户唯一识别码
bizId	String	业务系统传递的唯一标识（自定义业务编号）
operateTime	String	事件发生时间
expireDate	String	签署截止日期，日期格式yyyy-MM-dd，示例：2024-01-02
failCode	String	签署异常码
failMsg	String	签署异常说明

contractStatus描述

合同状态	备注
DRAFT	草稿
DELETED	已删除
WRITING	填写中
REFUSAL_WRITE	已拒填
SIGNING	签署中
REFUSAL_SIGN	已拒签
EXPIRED	已失效
RECALLED	已撤回
COMPLETED	已完成

callbackType描述

回调事件类型	备注
SEND_SIGNING	发起签署
SUBMIT_WRITE	填写
REFUSAL_WRITE	拒填
SUBMIT_SIGN	签署
REFUSAL_SIGN	拒签
RECALLED	合同撤销
COMPLETE	完成签署
EXPIRED	合同过期
SIGN_FAILED	签署失败

回调说明#

目的#

注意事项#

回调参数说明#

陌生用户实名认证#

印章制作#

合同及签署#

回调说明

目的

注意事项

回调参数说明

陌生用户实名认证

印章制作

合同及签署