对账单接口

更新时间:2025-02-12 14:32:25

对帐单下载

  • 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 机构号对应的令牌

注意:

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

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

应用场景:

商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致,通过对账单核对后可校正支付状态。

注意:

1、未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中,跟原支付单订单号一致;

2、在次日9点启动生成前一天的对账单,建议商户10点后再获取;

3、对账单中涉及金额的字段单位为“分”。

4、对账单接口只能下载三个月以内的账单。

示例数据:
852105399000001,34336428,2021-12-14 19:45:13,,1,0,0,1,1,6,1,343364289921621121419450800017,,2905925869105,154553154,2021-12-14,o12Tt4h_4jwghavcSYoN5VjLWNDE,0,3,0,1,1,0,微信小程序订单支付,,OTHERS,测试门店,1

请求结果中,每一行表示一条交易记录,记录中各参数以,号分隔。各参数含义如下所示:

商户号,终端号,交易时间,退款完成时间,交易金额(分),手续费金额(分),退款金额(分),结余金额(分),交易类型,支付方式,交易状态,交易单号,退款原单号,终端流水号,渠道订单号,交易日期,用户标识,银行卡类型,附加数据,商家优惠金额(分),商家实收金额(分),用户实付金额(分),平台优惠金额(分),订单备注,自定义设备编号,银行卡类型,门店名称,通道类型

以下为参数解释:

参数名称 说明
交易类型 1微信 2支付宝 3银行卡 4 现金 5无卡支付 6qq钱包 7百度钱包 8京东钱包 10翼支付 11云闪付 12龙支付 16数字人民币 17招行支付
交易金额 下单传入的订单金额,单位分
支付方式 刷卡支付1,扫码支付2,公众号支付3,wap支付4 app支付5,小程序支付6,刷脸支付7
交易状态 支付状态,支付成功1,已撤销4, 退款成功5
手续费 支付成功为正值 退款为负值,单位分
结余金额 到账金额:商家实收-手续费,单位分
银行卡类型 0储蓄卡,1信用卡
商家优惠优惠金额 订单金额-到账金额+手续费金额,单位分,特指商户出资的
用户实付金额 消费者实际支付金额,若无优惠,默认是订单金额;单位分;
平台优惠优惠金额 平台活动补贴金额,支付宝红包,立减金,预充值类营销活动补贴金额,商家正常到账。单位分;
订单备注 客户交易上送的订单order_body信息,未上传平台会有默认值
自定义设备编号 自定义设备编号device_no字段
银行卡类型 消费者交易的银行卡类型
门店名称 交易门店名称
通道类型 通道类型, 1:利楚直连, 2:富友,4:随行付,6:乐刷,其它值对应通道,可联系技术人员获取。

© 利楚商服 2020 All rights reserved.