回调函数
支持开票接口和冲红接口(包含纸票和电票)
调用方式
调用方在调用开票或冲红接口时,需要传入参数callbackUrl,程序会在开票或者冲红成功或者失败后,将结果推送到该 url;
JSON格式
- {
- "timestamp": "1725797231000",
- "nonce": "00000000001",
- "accessKey": "F0D16DD2EFF945C4B73A4B37F99C2696",
- "sign": "AB15D04C25F6B63317F2C166B58EED61",
- "body": {业务请求参数},
- "callbackUrl":"https://example/test"
- }


复制代码

开票逻辑处理结束后,会以post方式提交到该url,请求体遵循接口说明-返回报文的结构,data部分数据结构同下方调用数据查询接口数据结构基本一致(注意离线纸票冲红回调冲红成功判断条件);
M–必填 O–非必填 C–一定条件下必填
序号 | 标识 | 字段名称 | 字段类型 | 要求 | 说明 |
1 | code | 响应码 | Int | M | |
2 | message | 响应码消息 | Varchar | M | |
3 | data | 响应数据 | Object[] | ||
4 | sign | 数据签名 | Varchar | M | 当前返回的数据的数据签名 |
5 | signType | 签名类型 | Varchar | M | MD5 |
6 | notifyID | 回调编码 | Varchar | M | |
7 | notifyDate | 回调时间 | Varchar | M |
JSON格式
- {
- "code": 200,
- "data": object返回的数据,
- "sign": "3DC5B7B27637814A5D192EB906917B94",
- "signType": "MD5",
- "notifyID": "2F8CA3B9-29CB-414E-A36C-A586B542F957",
- "message": "请求成功",
- "notifyDate": "2021-09-29 14:26:51"
- }


复制代码

调用方接收到回调请求以后,需要返回“success”字符(不带引号),以回复接口,该回调消息已送达;如果回调时没有接收到约定的返回信息,则认为调用失败,我们会在接下来的时间内尝试追加七次请求(通知的间隔频率一般是:4m,10m,30m,1h,2h,6h,15h);如果长时间都无法接收到回调请求,请尝试调用查询接口查询开票处理状态。
数据签名可以校验数据是否被篡改,用户可以将当前返回数据按照接口说明-数据签名的方法加密后和数据签名字段对比,如果一致,则数据可信。
- 调用方式