回调函数
支持开票接口和冲红接口(包含纸票和电票)

调用方式

调用方在调用开票或冲红接口时,需要传入参数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);如果长时间都无法接收到回调请求,请尝试调用查询接口查询开票处理状态。
数据签名可以校验数据是否被篡改,用户可以将当前返回数据按照接口说明-数据签名的方法加密后和数据签名字段对比,如果一致,则数据可信。
  • 调用方式