CloudPay.downloadBill()

支持端：云函数 2.0.2

下载对账单

说明

商户可以通过该接口下载历史生意清单。。。。。。好比掉单、系统过失等导致商户侧和微信侧数据纷歧致，，，，，，通过对账单核对后可校正支付状态。。。。。。

注重：

1、微信侧未乐成下单的生意不会泛起在对账单中。。。。。。支付乐成后作废的生意会泛起在对账单中，，，，，，跟原支付单订单号一致;

2、微信在越日9点启动天生前一天的对账单，，，，，，建议商户10点后再获取;

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

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

5、对账单是以商户号纬度来天生的，，，，，，如一个商户号与多个appid有绑定关系，，，，，，则使用其中任何一个appid都可以请求下载对账单。。。。。。对账单中的appid取自生意时间提交的appid，，，，，，与请求下载对账单时使用的appid无关。。。。。。

6、小微商户不但独提供对账单下载，，，，，，若有需要，，，，，，可在调取【下载对账单】API接口时不传sub_mch_id，，，，，，获取服务商下全量特约商户(包括小微商户和非小微商户)的对账单。。。。。。

参数说明

字段名变量名必填类型示例值形貌

子商户号sub_mch_id否String(32)1900000109微信支付分配的子商户号，，，，，，如需下载指定的子商户号对账单，，，，，，则此参数必传。。。。。。

随机字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串，，，，，，不长于32位。。。。。。推荐随机数天生算法

署名sign是String(32)C380BEC2BFD727A4B6845133519F3AD6署名，，，，，，详见署名天生算法

对账单日期bill_date是String(8)20140603下载对账单的日期，，，，，，名堂：20140603

账单类型bill_type否String(8)ALLALL，，，，，，返回当日所有订单信息，，，，，，默认值

SUCCESS，，，，，，返回当日乐成支付的订单

REFUND，，，，，，返回当日退款订单

压缩账单tar_type否StringGZIP非必传参数，，，，，，牢靠值：GZIP，，，，，，返回名堂为.gzip的压缩包账单。。。。。。不传则默以为数据流形式。。。。。。

返回值说明

失败时，，，，，，返回以下字段

字段名变量名必填类型示例值形貌

返回状态码returnCode是String(16)FAILFAIL

过失码形貌returnMsg否String(128)署名失败返回信息，，，，，，如非空，，，，，，为过失原因，，，，，，如：署名失败 等。。。。。。

过失码errorCode否String(16)20002失败过失码，，，，，，详见过失码列表

乐成时，，，，，，数据以文本表格的方式返回，，，，，，第一行为表头，，，，，，后面各行为对应的字段内容，，，，，，字段内容跟盘问订单或退款效果一致，，，，，，详细字段说明可查阅响应接口。。。。。。

第一行为表头，，，，，，凭证请求下载的对账单类型差别而差别(由bill_type决议)，，，，，，现在有： 当日所有订单* 生意时间，，，，，，服务商的APPID，，，，，，商户号，，，，，，子商户号，，，，，，装备号，，，，，，微信订单号，，，，，，商户订单号，，，，，，用户标识，，，，，，生意类型，，，，，，生意状态，，，，，，付款银行，，，，，，钱币种类，，，，，，总金额，，，，，，代金券或立减优惠金额，，，，，，微信退款单号，，，，，，商户退款单号，，，，，，退款金额，，，，，，代金券或立减优惠退款金额，，，，，，退款类型，，，，，，退款状态，，，，，，商品名称，，，，，，商户数据包，，，，，，手续费，，，，，，费率 当日乐成支付的订单* 生意时间，，，，，，服务商的APPID，，，，，，商户号，，，，，，子商户号，，，，，，装备号，，，，，，微信订单号，，，，，，商户订单号，，，，，，用户标识，，，，，，生意类型，，，，，，生意状态，，，，，，付款银行，，，，，，钱币种类，，，，，，总金额，，，，，，代金券或立减优惠金额，，，，，，商品名称，，，，，，商户数据包，，，，，，手续费，，，，，，费率 当日退款的订单* 生意时间，，，，，，服务商的APPID，，，，，，商户号，，，，，，子商户号，，，，，，装备号，，，，，，微信订单号，，，，，，商户订单号，，，，，，用户标识，，，，，，生意类型，，，，，，生意状态，，，，，，付款银行，，，，，，钱币种类，，，，，，总金额，，，，，，代金券或立减优惠金额，，，，，，退款申请时间，，，，，，退款乐成时间，，，，，，微信退款单号，，，，，，商户退款单号，，，，，，退款金额，，，，，，代金券或立减优惠退款金额，，，，，，退款类型，，，，，，退款状态，，，，，，商品名称，，，，，，商户数据包，，，，，，手续费，，，，，，费率

从第二行起，，，，，，为数据纪录，，，，，，各参数以逗号脱离，，，，，，参数前增添`符号，，，，，，为标准键盘1左边键的字符，，，，，，字段顺序与表头一致。。。。。。

倒数第二行为订单统计问题，，，，，，最后一行为统计数据

总生意单数，，，，，，总生意额，，，，，，总退款金额，，，，，，总代金券或立减优惠退款金额，，，，，，手续费总金额

举例如下：

生意时间，，，，，，服务商的APPID，，，，，，商户号，，，，，，子商户号，，，，，，装备号，，，，，，微信订单号，，，，，，商户订单号，，，，，，用户标识，，，，，，生意类型，，，，，，生意状态，，，，，，付款银行，，，，，，钱币种类，，，，，，总金额，，，，，，代金券或立减优惠金额，，，，，，微信退款单号，，，，，，商户退款单号，，，，，，退款金额，，，，，，代金券或立减优惠退款金额，，，，，，退款类型，，，，，，退款状态，，，，，，商品名称，，，，，，商户数据包，，，，，，手续费，，，，，，费率 2014-11-10 16：33：45,wx2421b1c4370ec43b,10000100,0,1000,1001690740201411100005734289,1415640626,085e9858e3ba5186aafcbaed1,MICROPAY,SUCCESS,OTHERS,CNY,0.01,0.0,0,0,0,0,,,被扫支付测试,订单特殊形貌,0,0.60% 2014-11-10 16：46：14,wx2421b1c4370ec43b,10000100,0,1000,1002780740201411100005729794,1415635270,085e9858e90ca40c0b5aee463,MICROPAY,SUCCESS,OTHERS,CNY,0.01,0.0,0,0,0,0,,,被扫支付测试,订单特殊形貌,0,0.60% 总生意单数,总生意额,总退款金额,总代金券或立减优惠退款金额,手续费总金额 2,0.02,0.0,0.0,`0 结算对账单*

通俗结算对账单

字段名称示例值字段说明

生意时间2017-12-14 15:49:06指该笔生意的支付乐成时间或提倡退款乐成时间(注：不是退款乐成时间)，，，，，，名堂为YYYY-MM-DD HH:MM:SS，，，，，，如2015-01-01 10:00:00

公众账号IDwxab8acb865bb11234提倡该笔生意时使用的appid，，，，，，appid是由微信平台给公众号或app分配的唯一标识、用于区分生意场景

商户号1234567890提倡该笔生意的微信支付商户号，，，，，，8~10位数字

子商户号0若是是通俗受理模式下的生意，，，，，，展示特约商户的商户号，，，，，，8~10位数字

若是是直连模式生意，，，，，，则展示成数字0

装备号8888该笔生意下单时在device_info字段中传入的信息，，，，，，没填写则留空

微信订单号4200000008201712143733500001微信支付为该笔订单(或该笔退款对应的订单)分配的订单号

商户订单号test1商户传入的该笔订单(或该笔退款对应的订单)的商户订单号，，，，，，对应下单接口里的out_trade_no字段

用户标识testxt08c-XB5-QD208X1Aid0Cbs微信平台为支付用户在公众账号(appid)下分配的唯一标识(openid)

生意类型NATIVE该笔订单(或该笔退款单对应的订单)的生意类型，，，，，，使用英文缩写展示，，，，，，取值和寄义： 值：

JSAPI-JSAPI支付(或小程序支付)

NATIVE-Native支付

APP-app支付

MWEB-H5支付

MICROPAY-付款码支付

PAP-委托代扣

生意状态SUCCESSSUCCESS—支付乐成，，，，，，说明该行数据为一笔支付乐成的订单

REFUND—转入退款，，，，，，说明该行数据为一笔提倡退款乐成的退款单

REVOKED—已作废，，，，，，说明该行数据为一笔乐成作废的作废单

付款银行OTHERS银行类型，，，，，，接纳字符串类型的银行标识，，，，，，如CMC_CREDIT，，，，，，完整说明见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_2

钱币种类CNY钱币类型，，，，，，切合ISO 4217标准的三位字母代码，，，，，，如CNY

总金额0.01该笔订单的应结算金额(=订单金额-用户使用的免充值券金额)，，，，，，若是该行数据为退款或作废则展示0.00，，，，，，单位元，，，，，，保存到小数点后2位

代金券或立减优惠金额0.00该笔订单中使用的微信支付代金券金额(包括充值券和免充值券)，，，，，，若是未使用代金券、或该行数据为退款或作废则展示0.00，，，，，，单位元，，，，，，保存到小数点后2位

微信退款单号0微信支付为该笔退款分配的退款单号，，，，，，若是该行数据为订单则展示0

商户退款单号0商户提倡退款时填入的商户退款单号，，，，，，若是该行数据为订单则展示0

退款金额0.00该笔退款或作废单的应结算金额(申请退款金额-免充值券退款金额)，，，，，，若是该行数据为订单则展示为0.00，，，，，，非负数、单位元，，，，，，保存到小数点后2位

代金券或立减优惠退款金额0.00退款金额中包括的充值券退款金额，，，，，，若是该行数据为订单或没有充值券退款则展示为0.00，，，，，，非负数、单位元，，，，，，保存到小数点后2位

退款类型ORIGINAL—原路退款

BALANCE—转退到用户的微信支付零钱

若是该行数据为订单，，，，，，则留空

退款状态天生账单文件时该笔退款的状态、后续不会更新，，，，，，若是该行数据为订单，，，，，，则留空

SUCCES—退款乐成

FAIL—退款失败M

PROCESSING—退款处理中

商品名称中文[body]商户传入的该笔订单(或该笔退款对应的订单)的商品名称，，，，，，对应下单接口里的body字段

商户数据包测试中文[attach]商户传入的该笔订单(或该笔退款对应的订单)的商户数据包，，，，，，对应下单接口里的attach字段，，，，，，不传时留空

手续费0.00000该笔订单/退款对应的手续费金额，，，，，，订单对应正数、退款对应负数，，，，，，单位元，，，，，，保存小数点后2位

费率0.00%该笔生意计费所使用的费率，，，，，，百分数，，，，，，如0.60%

开通免充值券后的结算对账单

字段名称示例值字段说明

生意时间2017-12-14 15:49:06指该笔生意的支付乐成时间或提倡退款乐成时间(注：不是退款乐成时间)，，，，，，名堂为YYYY-MM-DD HH:MM:SS，，，，，，如2015-01-01 10:00:00

公众账号IDwxab8acb865bb11234提倡该笔生意时使用的appid，，，，，，appid是由微信平台给公众号或app分配的唯一标识、用于区分生意场景

商户号1234567890提倡该笔生意的微信支付商户号，，，，，，8~10位数字

特约商户号0若是是通俗受理模式下的生意，，，，，，展示特约商户的商户号，，，，，，8~10位数字

若是是直连模式生意，，，，，，则展示成数字0

装备号8888该笔生意下单时在device_info字段中传入的信息，，，，，，没填写则留空

微信订单号4200000008201712143733500001微信支付为该笔订单(或该笔退款对应的订单)分配的订单号

商户订单号test1商户传入的该笔订单(或该笔退款对应的订单)的商户订单号，，，，，，对应下单接口里的out_trade_no字段

用户标识testxt08c-XB5-QD208X1Aid0Cbs微信平台为支付用户在公众账号(appid)下分配的唯一标识(openid)

生意类型NATIVE该笔订单(或该笔退款单对应的订单)的生意类型，，，，，，使用英文缩写展示，，，，，，取值和寄义： 值：

JSAPI-JSAPI支付(或小程序支付)

NATIVE-Native支付

APP-app支付

MWEB-H5支付

MICROPAY-付款码支付

PAP-委托代扣

生意状态SUCCESSSUCCESS—支付乐成，，，，，，说明该行数据为一笔支付乐成的订单

REFUND—转入退款，，，，，，说明该行数据为一笔提倡退款乐成的退款单

REVOKED—已作废，，，，，，说明该行数据为一笔乐成作废的作废单

付款银行OTHERS银行类型，，，，，，接纳字符串类型的银行标识，，，，，，如CMC_CREDIT，，，，，，完整说明见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_2

钱币种类CNY钱币类型，，，，，，切合ISO 4217标准的三位字母代码，，，，，，如CNY

应结订单金额0.01该笔订单的应结算金额(=订单金额-用户使用的免充值券金额)，，，，，，若是该行数据为退款或作废则展示0.00，，，，，，单位元，，，，，，保存到小数点后2位

代金券金额0.00该笔订单中使用的微信支付代金券金额(包括充值券和免充值券)，，，，，，若是未使用代金券、或该行数据为退款或作废则展示0.00，，，，，，单位元，，，，，，保存到小数点后2位

微信退款单号0微信支付为该笔退款分配的退款单号，，，，，，若是该行数据为订单则展示0

商户退款单号0商户提倡退款时填入的商户退款单号，，，，，，若是该行数据为订单则展示0

退款金额0.00该笔退款或作废单的应结算金额(申请退款金额-免充值券退款金额)，，，，，，若是该行数据为订单则展示为0.00，，，，，，非负数、单位元，，，，，，保存到小数点后2位

充值券退款金额0.00退款金额中包括的充值券退款金额，，，，，，若是该行数据为订单或没有充值券退款则展示为0.00，，，，，，非负数、单位元，，，，，，保存到小数点后2位

退款类型ORIGINAL—原路退款

BALANCE—转退到用户的微信支付零钱

若是该行数据为订单，，，，，，则留空

退款状态天生账单文件时该笔退款的状态、后续不会更新，，，，，，若是该行数据为订单，，，，，，则留空

SUCCES—退款乐成

FAIL—退款失败M

PROCESSING—退款处理中

商品名称中文[body]商户传入的该笔订单(或该笔退款对应的订单)的商品名称，，，，，，对应下单接口里的body字段

商户数据包测试中文[attach]商户传入的该笔订单(或该笔退款对应的订单)的商户数据包，，，，，，对应下单接口里的attach字段，，，，，，不传时留空

手续费0.00000该笔订单/退款对应的手续费金额，，，，，，订单对应正数、退款对应负数，，，，，，单位元，，，，，，保存小数点后2位

费率0.00%该笔生意计费所使用的费率，，，，，，百分数，，，，，，如0.60%

订单金额0.01该笔订单的金额，，，，，，包括用户支付金额、充值券金额、免充值券金额，，，，，，若是该行数据为退款或作废则填0.00，，，，，，单位元，，，，，，保存到小数点后2位

申请退款金额0.00商户提倡退款的金额，，，，，，包括退给用户的金额、充值券退款金额、免充值券退款金额，，，，，，若是该行数据订单则填0.00，，，，，，单位元，，，，，，保存到小数点后2位

费率备注若是有特殊费率规则时则加以说明，，，，，，默认留空

过失码

过失码名称形貌原因解决方案

20003SYSTEMERROR下载失败系统超时请实验再次盘问。。。。。。

20001sign error署名过失请求参数未按要求举行填写署名过失，，，，，，请重新检查参数和署名密钥是否准确

20001nonce_str too long参数nonce_str过失请求参数未按要求填写参数nonce_str长度超长

20001invalid tar_type, Only GZIP supported参数tar_type过失请求参数未按指引举行填写请重新检查参数invalid tar_typ是否准确

20001invalid bill_type参数bill_type过失请求参数未按指引举行填写请重新检查参数bill_type是否准确

20001invalid bill_date参数bill_date过失请求参数未按指引举行填写请重新检查参数bill_date是否切合要求

20001require POST method请求方式过失请求方式不切合要求请求检查参数请求方式是否为post

20001empty post data请求报文过失请求报文为空请重新检查请求报文是否准确

20001data format error参数名堂过失请求参数要求为xml名堂请重新检查请求参数名堂是否为xml

20001missing parameter缺少参数有必传的参数未上传请重新检查是否所有必传参数都上传了，，，，，，且不为空

20001invalid appidappid过失请求参数appid有误请重新检查参数appid是否准确

20001invalid parameter参数过失有未知的请求参数请重新检查是否所有参数都与文档相符

20001sub_mch not allow特约商户号权限过失无该特约商户账单的下载权限请检查特约商户号是否准确。。。。。。若是小微商户，，，，，，可不传sub_mch_id以获取服务商下全量特约商户的账单

20002NO Bill Exist账单不保存目今商户号没有已成交的订单，，，，，，不天生对账单请检查目今商户号在指定日期内是否有乐成的生意。。。。。。

20002Bill Creating账单未天生目今商户号没有已成交的订单或对账单尚未天生请先检查目今商户号在指定日期内是否有乐成的生意，，，，，，如指定日期有生意则体现账单正在天生中，，，，，，请在上午10点以后再下载。。。。。。

20007目今商户号账单API权限已经关闭目今商户号账单API权限已经关闭目今商户号账单API权限已经关闭目今商户号账单API权限已经关闭，，，，，，请联系微信支付解决

20100system error下载失败系统超时请实验再次盘问。。。。。。