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