异步回调

回调说明

[!NOTE] 回调服务是指由君子签服务平台发起请求,调用客户端存在的http接口。用于异步的返回一些处理结果,如:签约完成、保全完成、企业审核结果、人脸结果返回等。

异步回调开通

[!NOTE] 回调地址应该是一个统一的接口URL,需将接口地址告诉君子签或使用君子签sass平台的自行设置。(人脸的异步回调为发起时指定,是可以不同的)

回调签名及调用

[!NOTE] 君子签服务使用POST请求方式的Form表单结构的请求。即为form表单的post提交,不是application/json调用。 请求body中固定只有method,version,data,timestamp,sign,appkey 6个参数,其参数说明如下:

参数名 说明 是否必填(*是) 请求方式
method 业务类型 * post
version 版本 * post
timestamp 时间戳(精确到毫秒) * post
data JSONObject结果 * post
sign 签名sign(sha1对前面的参数签名) * post
appkey appkey * post

其中sign签名规则如下:

#签名方法
sign = sha1Hex("data"+data+"method"+method+"version"+version+"timestamp"+timestamp+"appKey"+appKey+"appSecret"+appSecret);

#例:
#"data{里面是一个json字符串}methodbank.three.statussign8b069524b034cc7797ff016457xxxxxxxxxxxxxxxxxxtimestamp1566201530099version1.0.0timestamp1566201530099appKey你的appkeyappSecret你的secret"  
#取sha1的hex得:bfed014b33c5f216de5f9eb4a25e9a3ca14825e9

请求结果说明

[!NOTE] 君子签在调用客户接口后,客户端需返回一个json字符串,json字符串结构如下表;如果君子签收到success为false则服务端将在后面再次发送多次请求(3次,每次3分钟间隔),以保证发送成功。发送失败后进入死信对队,需要用户登录君子签查看回调查询,把fail的回调重新发送

参数名 说明 是否必填(*是) 请求方式
success true成功false失败 * post
msg {“success”:true} 或{“success”:false,”,msg”:”处理失败了”},要注意返回结果字符串不能被””包裹。 * post

results matching ""

    No results matching ""