结算冻结记录查询API

应用场景

商户可以通过该接口下载延迟结算的交易记录。

注意:
1、与获取对账单API地址和参数公用,只是入参bill_type传值不一样;
2、冻结后的交易不会出现在当天的账单中,需要解冻后才会出账;
3、冻结后可发起退款,退款账单会在原交易解冻后一起出,支持部分退款;
4、根据账单对资金账,未出账单的交易,需延迟对账和资金结算;
5、退款要区分两种,未冻结交易退款需轧差,冻结交易退款不扣子商户应结资金;

以下是正常交易和冻结后对比:

被冻结(不超过30天) 未冻结
支付成功结果/查询 正常 正常
结算账单记录 解冻后+1出 协议结算周期(默认T+1)出
资金 解冻后+1结 协议结算周期(默认T+1)结
提交退款
退款结算账单 解冻后+1(跟原支付账单一起) 协议结算周期(默认T+1)出
退款资金 从冻结交易扣,不影响正常单结算 轧差
冻结记录 从账单接口获取(bill_type=FROZEN) -

接口链接

https://api.mch.weixin.qq.com/pay/downloadbill

是否需要证书

不需要。

请求参数

字段名 变量名 必填 类型 示例值 描述
公众账号ID appid String(32) wx8888888888888888 微信分配的服务商公众账号ID
商户号 mch_id String(32) 1900000109 微信支付分配的服务商商户号
子商户公众账号ID sub_appid String(32) wx8888888888888888 微信分配的子商户公众账号ID
随机字符串 nonce_str String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串,不长于32位。推荐随机数生成算法
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名,详见签名生成算法
对账单日期 bill_date String(8) 20140603 下载对账单的日期,格式:20140603
账单类型 bill_type String(32) FROZEN

FROZEN,返回结算冻结记录

压缩账单 tar_type String GZIP 非必传参数,固定值:GZIP,返回格式为.gzip的压缩包账单。不传则默认为数据流形式。

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <bill_date>20141110</bill_date>
   <bill_type>FROZEN</bill_type>
   <mch_id>10000100</mch_id>
   <nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str>
   <sign>332F17B766FC787203EBE9D6E40457A1</sign>
</xml>

返回结果

失败时,返回以下字段

字段名 变量名 必填 类型 示例值 描述
返回状态码 return_code String(16) FAIL FAIL
返回信息 return_msg String(128) 签名失败

返回信息,如非空,为错误原因

如:签名失败 等。

成功时,数据以文本表格的方式返回,第一行为表头

字段名 必填 类型 描述

交易时间

String(32)

对应通用版账单里的交易时间,指支付成功的时间,标准格式,如:2014-11-10 16:46:14

商户号

String(32)

银行商户号

特约商户号

String(32)

下属商户识别码

微信支付订单号

String(32)

在微信侧的订单号,28位唯一

商户订单号

String(32)

商户下单时传的订单号

订单金额(元)

String(20)

结算冻结单的原订单金额(包含优惠金额),单位是元,精确到两位小数

备注

String(128)

其他附加说明

冻结时间

String(32)

操作时间,标准格式,如:2016-11-10

解冻时间

String(32)

操作时间,标准格式,如:2016-11-10

冻结状态

String(32)

标识交易的状态,值列表:
FREEZE--冻结
UNFREEZE--解冻

成功获取记录后返回的数据格式:
交易时间,商户号,特约商户号,微信支付订单号,商户订单号,订单金额(元),备注,冻结时间,解冻时间,冻结状态
2014-11-10 16:46:14,100000,100001,1002780740201411100005729794,1415635270,1000.00,测试备注,2014-11-10,2014-11-11,FREEZE
2014-11-09 16:46:15,100000,100001,1002780740201411100005729795,1415635271,1000.00,测试备注,2014-11-09,2014-11-10, UNFREEZE
记录总条数,冻结记录总条数,冻结记录订单总金额(元),解冻记录总条数,解冻记录订单总金额(元)
2,1,1000.00,1,1000.00

错误码

名称 描述 原因 解决方案
SYSTEMERROR 下载失败 系统超时 请尝试再次查询。
invalid bill_type 参数错误 请求参数未按指引进行填写 参数错误,请重新检查
data format error
missing parameter
SIGN ERROR
NO Bill Exist 账单不存在 当前商户号没有已成交的订单,不生成对账单 请检查当前商户号在指定日期内是否有成功的交易。
Bill Creating 账单未生成 当前商户号没有已成交的订单或对账单尚未生成 请先检查当前商户号在指定日期内是否有成功的交易,如指定日期有交易则表示账单正在生成中,请在上午10点以后再下载。
CompressGZip Error 账单压缩失败 账单压缩失败,请稍后重试 账单压缩失败,请稍后重试
UnCompressGZip Error 账单解压失败 账单解压失败,请稍后重试 账单解压失败,请稍后重试