对账单接口

更新时间:2024-07-12 15:00:19

对帐单下载

  • URL:https://example.com/order/day/inst_no/key_sign/inst_no_day.txt
  • Method: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 机构号对应的令牌

注意:

  • 有对账单下载需求的机构,请先联系利楚商务开通机构号,并开启对账单下载功能。
  • 接口不能下载当天的对账单;
  • 目前只允许以机构为单位的对账单下载,从对账单中解析单个商户的对账单。
  • 只能下载“对账单下载”功能开启后的对账单,无法下载未开启功能之前的对账单。

image.png
若返回以上内容,并不是说密钥不对,提示是未找到对账单文件,请检查是否开启对账单下载功能,或者检查拼接的地址是否正确。

应用场景:
商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致,通过对账单核对后可校正支付状态。
注意:
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,186
6604,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信用卡
商家优惠金额 订单金额-结余金额-手续费金额

© 利楚商服 2020 All rights reserved.