下載資金賬單
應(yīng)用場景
商戶可以通過該接口下載自2017年6月1日起 的歷史資金流水賬單。
說明：
1、資金賬單中的數(shù)據(jù)反映的是商戶微信賬戶資金變動情況；
2、當(dāng)日賬單在次日上午9點開始生成，建議商戶在上午10點以后獲取；
3、資金賬單中涉及金額的字段單位為“元”。
接口鏈接
https://api.mch.weixin.qq.com/pay/downloadfundflow
是否需要證書
請求需要雙向證書。 詳見證書使用
請求參數(shù)
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 公眾賬號ID | appid | 是 | String(32) | wx8888888888888888 | 微信分配的公眾賬號ID（企業(yè)號corpid即為此appId） |
| 商戶號 | mch_id | 是 | String(32) | 1900000109 | 微信支付分配的商戶號 |
| 隨機字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 隨機字符串，不長于32位。推薦隨機數(shù)生成算法 |
| 簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 簽名，詳見簽名生成算法 |
| 簽名類型 | sign_type | 否 | String(32) | HMAC-SHA256 | 簽名類型，目前僅支持HMAC-SHA256 |
| 資金賬單日期 | bill_date | 是 | String(8) | 20140603 | 下載對賬單的日期，格式：20140603 |
| 資金賬戶類型 | account_type | 是 | String(8) | Basic | 賬單的資金來源賬戶： Basic 基本賬戶 Operation 運營賬戶 Fees 手續(xù)費賬戶 |
| 壓縮賬單 | tar_type | 否 | String(8) | GZIP | 非必傳參數(shù)，固定值：GZIP，返回格式為.gzip的壓縮包賬單。不傳則默認(rèn)為數(shù)據(jù)流形式。 |
<xml>
<appid>wx2421b1c4370ec43b</appid>
<bill_date>20141110</bill_date>
<account_type>Basic</account_type>
<mch_id>10000100</mch_id>
<nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str>
<sign>332F17B766FC787203EBE9D6E40457A1</sign>
</xml>
返回結(jié)果
1）第一行為表頭
記賬時間,微信支付業(yè)務(wù)單號,資金流水單號,業(yè)務(wù)名稱,業(yè)務(wù)類型,收支類型,收支金額（元）,賬戶結(jié)余（元）,資金變更提交申請人,備注,業(yè)務(wù)憑證號
2)從第二行起，為資金流水?dāng)?shù)據(jù)，各參數(shù)以逗號分隔，參數(shù)前增加`符號，為標(biāo)準(zhǔn)鍵盤1左邊鍵的字符，字段順序與表頭一致
3）倒數(shù)第二行為資金賬單統(tǒng)計標(biāo)題
資金流水總筆數(shù),收入筆數(shù),收入金額,支出筆數(shù),支出金額
4）最后一行為統(tǒng)計數(shù)據(jù)
賬單示例如下：
記賬時間,微信支付業(yè)務(wù)單號,資金流水單號,業(yè)務(wù)名稱,業(yè)務(wù)類型,收支類型,收支金額（元）,賬戶結(jié)余（元）,資金變更提交申請人,備注,業(yè)務(wù)憑證號
`2018-02-01 04:21:23,`50000305742018020103387128253,`1900009231201802015884652186,`退款,`退款,`支出,`0.02,`0.17,`system,`缺貨,`REF4200000068201801293084726067
資金流水總筆數(shù),收入筆數(shù),收入金額,支出筆數(shù),支出金額
`20.0,`17.0,`0.35,`3.0,`0.18
5）header中Digest為完整性校驗信息，內(nèi)容格式為：簽名類型=簽名
舉例如下：
Digest:?SHA=ec45d7c24492dcd62d92472b0f2816c8d9a2d773
注：當(dāng)前僅支持sha1簽名返回
接口請求時如有協(xié)議錯誤，將返回以下字段| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | 是 | String(16) | SUCCESS |
SUCCESS/FAIL 此字段是通信標(biāo)識，非交易標(biāo)識，交易是否成功需要查看trade_state來判斷 |
| 返回信息 | return_msg | 是 | String(128) | OK |
當(dāng)return_code為FAIL時返回信息為錯誤原因 ，例如 簽名失敗 參數(shù)格式校驗錯誤 請求頻率過快，請稍后再試 |
當(dāng)return_code為SUCCESS時，進(jìn)一步返回以下字段指明業(yè)務(wù)失敗的原因
字段名 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
|---|---|---|---|---|---|
業(yè)務(wù)結(jié)果 |
result_code |
是 |
string(16) |
FAIL |
FAIL |
錯誤代碼 |
err_code |
是 |
String(16) |
SYSTEMERROR |
見錯誤碼列表 |
錯誤代碼描述 |
err_code_des |
否 |
String(128) |
賬單不存在 |
錯誤信息描述 |
請求協(xié)議錯誤示例：
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<result_code><![CDATA[FAIL]]></result_code>
<err_code><![CDATA[NO_BILL_EXIST]]></err_code>
<err_code_des><![CDATA[商戶查詢賬戶當(dāng)日無資金賬單]]></err_code_des>
</xml>
錯誤碼
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| SYSTEMERROR | 微信支付內(nèi)部錯誤 | 請稍后重試。 |
| PARAM_ERROR | 參數(shù)錯誤 | 請對照文檔的請求參數(shù)說明檢查參數(shù)。 |
NO_BILL_EXIST |
賬單不存在 | 請檢查當(dāng)前商戶號在指定日期內(nèi)是否有成功的交易。 |
BILL_CREATING |
賬單未生成 | 請先檢查當(dāng)前商戶號在指定日期內(nèi)是否有成功的交易，如指定日期有交易則表示賬單正在生成中，請在上午10點以后再下載。 |