更新时间:2025-02-12 14:32:25
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、对账单接口只能下载三个月以内的账单。
示例数据: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:乐刷,其它值对应通道,可联系技术人员获取。 |