更新时间:2024-11-21 15:10:23
https://example.com/order/day/inst_no/key_sign/inst_no_day.txt
GET
请注意:对账单只能获取生产环境数据,测试环境测试数据无法获取。
请求路径中example.com
只是个示例,请联系对接人员获取真实域名(请勿使用支付接口或者商户接口域名)
。请求路径中除了/
、order
和.txt
,其它全部是变量名,在实际请求中需要替换成变量的值,示例如下:
https://example.com/order/20170208/00000001/a988b4b22559754ffe5c32e227872a7a/00000001_20170208.txt
签名算法
MD5加密,utf-8格式转小写,加密后得到key_sign的值,并替换url中的key_sign。
String key_sign = MD5.encode(day=日期值&inst_no=机构号值&key=机构密钥值);
签名参数:
参数名称 | 说明 |
---|---|
day | 日期,yyyyMMdd,例如:20170208 |
inst_no | 机构号 |
key | 机构号对应的令牌 |
注意:
若返回以上内容,并不是说密钥不对,提示是未找到对账单文件,请检查是否开启对账单下载功能,或者检查拼接的地址是否正确。
应用场景:
商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致,通过对账单核对后可校正支付状态。
注意:
1、未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中,跟原支付单订单号一致;
2、在次日9点启动生成前一天的对账单,建议商户10点后再获取;
3、对账单中涉及金额的字段单位为“分”。
4、对账单接口只能下载三个月以内的账单。
对账单示例:
813400153000655,10095942,2017-02-26 10:40:30,2017-02-26 10:40:31,59400,-226,59400,-59400,1,1,5,100959420622017022610403001456,100959420321117022511123900313,20170225111239392730,,2017-02-26,oGRo8xM_-MoGpvoFUaGxYDL7xAEQ,0,,
865100292000051,10086757,2017-01-22 12:47:30,2017-01-22 12:47:31,60600,-182,60600,-60600,1,3,5,100867600122017012212473001653,100867570421317012212463201871,,,2017-01-22,oAisZs-IhQSdUY9iqae6-eV8ECbs,0,,
865100292000051,10086757,2017-01-22 12:46:33,,60600,182,0,60600,1,3,1,100867570421317012212463201871,,,4000782001201701227175028928,2017-01-22,oAisZs-IhQSdUY9iqae6-eV8ECbs,0,,
813400153000655,10095942,2017-02-25 11:12:39,,59400,226,0,59400,1,1,1,100959420321117022511123900313,,20170225111239392730,4002332001201702251238349863,2017-02-25,oGRo8xM_-MoGpvoFUaGxYDL7xAEQ,0,,
889791002090051,10062836,2017-01-20 23:47:39,2017-01-20 23:47:40,200,0,100,-100,1,3,5,100628360422017012023473900783,100628360821317012023464500641,20170120234645280284879900547971,,2017-01-20,oicgAxAAxPV5aLT4-huFJmg18C7k,0,,
879100314000032,10087034,2017-01-30 18:18:12,2017-01-30 18:18:15,22800,0,7600,-7600,2,1,5,100870340222017013018181200235,100870340722117013017542500903,20170130175425211046308485517826,,2017-01-30,1866604,0,,
889791002090051,10062836,2017-01-20 23:46:45,,200,1,0,200,1,3,1,100628360821317012023464500641,,20170120234645280284879900547971,4006842001201701207024473500,2017-01-20,oicgAxAAxPV5aLT4-huFJmg18C7k,0,,
879100314000032,10087034,2017-01-30 17:54:27,,22800,137,0,22800,2,1,1,100870340722117013017542500903,,20170130175425211046308485517826,2017013021001004240266576009,2017-01-30,1866604,0,,
889521000920001,10057111,2017-01-02 09:28:10,,79800,0,0,79800,3,1,1,020926208614,,100096,,2017-01-02,,0,,
请求结果中,每一行表示一条交易记录,记录中各参数以,
号分隔。各参数含义如下所示:
商户号,终端号,交易时间,退款完成时间,交易金额(分),手续费金额(分),退款金额(分),结余金额(分),交易类型,支付方式,交易状态,交易单号,退款原单号,终端流水号,渠道订单号,交易日期,用户标识,银行卡类型,附加数据,
参数解释:
参数名称 | 说明 |
---|---|
交易类型 | 1 微信 2支付宝 3银行卡 4 现金 5无卡支付 6qq钱包 7百度钱包8京东钱包 10翼支付 11云闪付 12龙支付 17招行支付 |
交易金额 | 下单传入的订单金额 |
支付方式 | 刷卡支付1,扫码支付2,公众号支付3,wap支付4 app支付5,小程序支付6,刷脸支付7 |
交易状态 | 支付状态,支付成功1,已撤销4, 退款成功5 |
手续费 | 支付成功为正值 退款为负值 |
结余金额 | 到账金额:商家实收-手续费 |
银行卡类型 | 0储蓄卡,1信用卡 |
商家优惠金额 | 订单金额-结余金额-手续费金额 |