视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

下載交易賬單

最新更新時(shí)間:2020.04.17 版本說明


商戶可以通過該接口下載歷史交易清單。比如掉單、系統(tǒng)錯(cuò)誤等導(dǎo)致商戶側(cè)和微信側(cè)數(shù)據(jù)不一致,通過對(duì)賬單核對(duì)后可校正支付狀態(tài)。

注意:

1、微信側(cè)未成功下單的交易不會(huì)出現(xiàn)在對(duì)賬單中。支付成功后撤銷的交易會(huì)出現(xiàn)在對(duì)賬單中,跟原支付單訂單號(hào)一致。

2、微信在次日9點(diǎn)啟動(dòng)生成前一天的對(duì)賬單,建議商戶10點(diǎn)后再獲取。

3、對(duì)賬單中涉及金額的字段單位為“元”。

4、對(duì)賬單接口只能下載三個(gè)月以內(nèi)的賬單。

5、對(duì)賬單是以商戶號(hào)緯度來生成的,如一個(gè)商戶號(hào)與多個(gè)appid有綁定關(guān)系,則使用其中任何一個(gè)appid都可以請(qǐng)求下載對(duì)賬單。對(duì)賬單中的appid取自交易時(shí)候提交的appid,與請(qǐng)求下載對(duì)賬單時(shí)使用的appid無關(guān)。

接口說明

適用對(duì)象: 服務(wù)商

請(qǐng)求URL: https://api.mch.weixin.qq.com/pay/downloadbill

請(qǐng)求方式: POST

數(shù)據(jù)格式: XML

是否需要證書:

請(qǐng)求參數(shù)

參數(shù)名 變量 類型 必填 描述
應(yīng)用ID appid string[1,32] 服務(wù)商申請(qǐng)的公眾號(hào)或移動(dòng)應(yīng)用appid。
示例值:wxcbda96de0b165486
商戶號(hào) mch_id string[1,32] 商戶號(hào)是商戶在微信申請(qǐng)微信支付成功后分配的賬號(hào)ID,登錄平臺(tái)為www.tg885.com
示例值:1200009811
子商戶應(yīng)用ID sub_appid string[1,32] 子商戶號(hào)綁定的appid(非必填,如需操作,需要服務(wù)商在商戶平臺(tái)為子商戶綁定)
示例值:wxcbda96de0b165489
子商戶號(hào) sub_mch_id string[1,32] 微信支付分配的子商戶號(hào),如需下載指定的子商戶號(hào)對(duì)賬單,則此參數(shù)必傳。
示例值:1900000109
隨機(jī)字符串 nonce_str string[1,32] 隨機(jī)字符串,不長于32位。推薦隨機(jī)數(shù)生成算法
示例值:5K8264ILTKCH16CQ2502SI8ZNMTM67VS
簽名 sign string[1,32] 簽名,詳見簽名生成算法
示例值:C380BEC2BFD727A4B6845133519F3AD6
對(duì)賬單日期 bill_date string[1,8] 下載對(duì)賬單的日期,格式:20140603
示例值:20140603
賬單類型 bill_type string[1,8] 賬單類型,枚舉值:
ALL:(默認(rèn)值),返回當(dāng)日所有訂單信息(不含充值退款訂單)
SUCCESS:返回當(dāng)日成功支付的訂單(不含充值退款訂單)
REFUND:返回當(dāng)日退款訂單(不含充值退款訂單)
RECHARGE_REFUND:返回當(dāng)日充值退款訂單
示例值:ALL
壓縮賬單 tar_type string[1,4] 非必傳參數(shù),固定值:GZIP,返回格式為.gzip的壓縮包賬單。不傳則默認(rèn)為數(shù)據(jù)流形式。
示例值:GZIP

請(qǐng)求示例:

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <bill_date>20141110</bill_date>
   <bill_type>ALL</bill_type>
   <mch_id>10000100</mch_id>
   <nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str>
   <sign>332F17B766FC787203EBE9D6E40457A1</sign>
</xml> 
    
{
JAVA示例代碼
}
    

返回參數(shù)

失敗時(shí),返回以下字段

參數(shù)名 變量 類型 必填 描述
返回狀態(tài)碼 return_code string[1,16] SUCCESS/FAIL
此字段是通信標(biāo)識(shí),非交易標(biāo)識(shí),交易是否成功需要查看result_code來判斷
示例值:SUCCESS
返回信息 return_msg string[1,128] 返回信息,如非空,為錯(cuò)誤原因
如:簽名失敗 等。
示例值:簽名失敗
錯(cuò)誤代碼 err_code string[1,16] 失敗錯(cuò)誤碼,詳見錯(cuò)誤碼列表
示例值:20002

成功時(shí),數(shù)據(jù)以文本表格的方式返回,第一行為表頭,后面各行為對(duì)應(yīng)的字段內(nèi)容,字段內(nèi)容跟查詢訂單或退款結(jié)果一致,具體字段說明可查閱相應(yīng)接口。


第一行為表頭,根據(jù)請(qǐng)求下載的對(duì)賬單類型不同而不同(由bill_type決定), 目前有:

當(dāng)日所有訂單

交易時(shí)間,應(yīng)用ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,微信退款單號(hào),商戶退款單號(hào),退款金額, 代金券或立減優(yōu)惠退款金額,退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率


當(dāng)日成功支付的訂單

交易時(shí)間,應(yīng)用ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額, 代金券或立減優(yōu)惠金額,商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率


當(dāng)日退款的訂單

交易時(shí)間,應(yīng)用ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額, 代金券或立減優(yōu)惠金額,退款申請(qǐng)時(shí)間,退款成功時(shí)間,微信退款單號(hào),商戶退款單號(hào),退款金額, 代金券或立減優(yōu)惠退款金額,退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率


從第二行起,為數(shù)據(jù)記錄,各參數(shù)以逗號(hào)分隔,參數(shù)前增加`符號(hào),為標(biāo)準(zhǔn)鍵盤1左邊鍵的字符,字段順序與表頭一致。

倒數(shù)第二行為訂單統(tǒng)計(jì)標(biāo)題,最后一行為統(tǒng)計(jì)數(shù)據(jù)

總交易單數(shù),總交易額,總退款金額,總代金券或立減優(yōu)惠退款金額,手續(xù)費(fèi)總金額

舉例如下:

交易時(shí)間,應(yīng)用ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,微信退款單號(hào),商戶退款單號(hào),退款金額,代金券或立減優(yōu)惠退款金額,退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率

`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%

總交易單數(shù),總交易額,總退款金額,總代金券或立減優(yōu)惠退款金額,手續(xù)費(fèi)總金額

`2,`0.02,`0.0,`0.0,`0


結(jié)算對(duì)賬單

普通結(jié)算對(duì)賬單
字段名稱 示例值 字段說明
交易時(shí)間 2015-01-01 10:00:00 指該筆交易的支付成功時(shí)間或發(fā)起退款成功時(shí)間(注:不是退款成功時(shí)間),格式為YYYY-MM-DD HH:MM:SS,如2015-01-01 10:00:00
應(yīng)用ID wxab8acb865bb11234 發(fā)起該筆交易時(shí)使用的appid,appid是由微信平臺(tái)給公眾號(hào)或app分配的唯一標(biāo)識(shí)、用于區(qū)分交易場景
商戶號(hào) 1234567890 發(fā)起該筆交易的微信支付商戶號(hào),8~10位數(shù)字
子商戶號(hào) 0 如果是普通受理模式下的交易,展示特約商戶的商戶號(hào),8~10位數(shù)字
如果是直連模式交易,則展示成數(shù)字0
設(shè)備號(hào) 8888 該筆交易下單時(shí)在device_info字段中傳入的信息,沒填寫則留空
微信訂單號(hào) 4200000008201712143733500001 微信支付為該筆訂單(或該筆退款對(duì)應(yīng)的訂單)分配的訂單號(hào)
商戶訂單號(hào) test1 商戶傳入的該筆訂單(或該筆退款對(duì)應(yīng)的訂單)的商戶訂單號(hào),對(duì)應(yīng)下單接口里的out_trade_no字段
用戶標(biāo)識(shí) testxt08c-XB5-QD208X1Aid0Cbs 微信平臺(tái)為支付用戶在公眾賬號(hào)(appid)下分配的唯一標(biāo)識(shí)(openid)
交易類型 NATIVE 該筆訂單(或該筆退款單對(duì)應(yīng)的訂單)的交易類型,使用英文縮寫展示,取值和含義: 值:
JSAPI-JSAPI支付(或小程序支付)
NATIVE-Native支付
APP-app支付
MWEB-H5支付
MICROPAY-付款碼支付
PAP-委托代扣
交易狀態(tài) SUCCESS SUCCESS—支付成功,說明該行數(shù)據(jù)為一筆支付成功的訂單
REFUND—轉(zhuǎn)入退款,說明該行數(shù)據(jù)為一筆發(fā)起退款成功的退款單
REVOKED—已撤銷,說明該行數(shù)據(jù)為一筆成功撤銷的撤銷單
付款銀行 OTHERS 銀行類型,采用字符串類型的銀行標(biāo)識(shí),如CMC_CREDIT,完整說明見http://www.tg885.com/wiki/doc/api/jsapi.php?chapter=4_2
貨幣種類 CNY 貨幣類型,符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼,如CNY
總金額 0.01 該筆訂單的應(yīng)結(jié)算金額(=訂單金額-用戶使用的免充值券金額),如果該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點(diǎn)后2位
代金券或立減優(yōu)惠金額 0.00 該筆訂單中使用的微信支付代金券金額(包括充值券和免充值券),如果未使用代金券、或該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點(diǎn)后2位
微信退款單號(hào) 0 微信支付為該筆退款分配的退款單號(hào),如果該行數(shù)據(jù)為訂單則展示0
商戶退款單號(hào) 0 商戶發(fā)起退款時(shí)填入的商戶退款單號(hào),如果該行數(shù)據(jù)為訂單則展示0
退款金額 0.00 該筆退款或撤銷單的應(yīng)結(jié)算金額(申請(qǐng)退款金額-免充值券退款金額),如果該行數(shù)據(jù)為訂單則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點(diǎn)后2
代金券或立減優(yōu)惠退款金額 0.00 退款金額中包含的充值券退款金額,如果該行數(shù)據(jù)為訂單或沒有充值券退款則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點(diǎn)后2
退款類型 ORIGINAL

ORIGINAL—原路退款
BALANCE—轉(zhuǎn)退到用戶的微信支付零錢
如果該行數(shù)據(jù)為訂單,則留空

退款狀態(tài) SUCCESS 生成賬單文件時(shí)該筆退款的狀態(tài)、后續(xù)不會(huì)更新,如果該行數(shù)據(jù)為訂單,則留空
SUCCES—退款成功
FAIL—退款失敗
PROCESSING—退款處理中
商品名稱 中文[body] 商戶傳入的該筆訂單(或該筆退款對(duì)應(yīng)的訂單)的商品名稱,對(duì)應(yīng)下單接口里的body字段
商戶數(shù)據(jù)包 測試中文[attach] 商戶傳入的該筆訂單(或該筆退款對(duì)應(yīng)的訂單)的商戶數(shù)據(jù)包,對(duì)應(yīng)下單接口里的attach字段,不傳時(shí)留空
手續(xù)費(fèi) 0.00000 該筆訂單/退款對(duì)應(yīng)的手續(xù)費(fèi)金額,訂單對(duì)應(yīng)正數(shù)、退款對(duì)應(yīng)負(fù)數(shù),單位元,保留小數(shù)點(diǎn)后2位
費(fèi)率 0.00% 該筆交易計(jì)費(fèi)所使用的費(fèi)率,百分?jǐn)?shù),如0.60%
開通免充值券后的結(jié)算對(duì)賬單
字段名稱 示例值 字段說明
交易時(shí)間 2015-01-01 10:00:00 指該筆交易的支付成功時(shí)間或發(fā)起退款成功時(shí)間(注:不是退款成功時(shí)間),格式為YYYY-MM-DD HH:MM:SS,如2015-01-01 10:00:00
應(yīng)用ID wxab8acb865bb11234 發(fā)起該筆交易時(shí)使用的appid,appid是由微信平臺(tái)給公眾號(hào)或app分配的唯一標(biāo)識(shí)、用于區(qū)分交易場景
商戶號(hào) 1234567890 發(fā)起該筆交易的微信支付商戶號(hào),8~10位數(shù)字
特約商戶號(hào) 0 如果是普通受理模式下的交易,展示特約商戶的商戶號(hào),8~10位數(shù)字
如果是直連模式交易,則展示成數(shù)字0
設(shè)備號(hào) 8888 該筆交易下單時(shí)在device_info字段中傳入的信息,沒填寫則留空
微信訂單號(hào) 4200000008201712143733500001 微信支付為該筆訂單(或該筆退款對(duì)應(yīng)的訂單)分配的訂單號(hào)
商戶訂單號(hào) test1 商戶傳入的該筆訂單(或該筆退款對(duì)應(yīng)的訂單)的商戶訂單號(hào),對(duì)應(yīng)下單接口里的out_trade_no字段
用戶標(biāo)識(shí) testxt08c-XB5-QD208X1Aid0Cbs 微信平臺(tái)為支付用戶在公眾賬號(hào)(appid)下分配的唯一標(biāo)識(shí)(openid)
交易類型 NATIVE 該筆訂單(或該筆退款單對(duì)應(yīng)的訂單)的交易類型,使用英文縮寫展示,取值和含義: 值:
JSAPI-JSAPI支付(或小程序支付)
NATIVE-Native支付
APP-app支付
MWEB-H5支付
MICROPAY-付款碼支付
PAP-委托代扣
交易狀態(tài) SUCCESS SUCCESS—支付成功,說明該行數(shù)據(jù)為一筆支付成功的訂單
REFUND—轉(zhuǎn)入退款,說明該行數(shù)據(jù)為一筆發(fā)起退款成功的退款單
REVOKED—已撤銷,說明該行數(shù)據(jù)為一筆成功撤銷的撤銷單
付款銀行 OTHERS 銀行類型,采用字符串類型的銀行標(biāo)識(shí),如CMC_CREDIT,完整說明見http://www.tg885.com/wiki/doc/api/jsapi.php?chapter=4_2
貨幣種類 CNY 貨幣類型,符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼,如CNY
應(yīng)結(jié)訂單金額 0.01 該筆訂單的應(yīng)結(jié)算金額(=訂單金額-用戶使用的免充值券金額),如果該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點(diǎn)后2位
代金券
金額
0.00 該筆訂單中使用的微信支付代金券金額(包括充值券和免充值券),如果未使用代金券、或該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點(diǎn)后2位
微信退款單號(hào) 0 微信支付為該筆退款分配的退款單號(hào),如果該行數(shù)據(jù)為訂單則展示0
商戶退款單號(hào) 0 商戶發(fā)起退款時(shí)填入的商戶退款單號(hào),如果該行數(shù)據(jù)為訂單則展示0
退款金額 0.00 該筆退款或撤銷單的應(yīng)結(jié)算金額(申請(qǐng)退款金額-免充值券退款金額),如果該行數(shù)據(jù)為訂單則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點(diǎn)后2
充值券退款金額 0.00 退款金額中包含的充值券退款金額,如果該行數(shù)據(jù)為訂單或沒有充值券退款則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點(diǎn)后2
退款類型 ORIGINAL

ORIGINAL—原路退款
BALANCE—轉(zhuǎn)退到用戶的微信支付零錢
如果該行數(shù)據(jù)為訂單,則留空

退款狀態(tài) SUCCESS 生成賬單文件時(shí)該筆退款的狀態(tài)、后續(xù)不會(huì)更新,如果該行數(shù)據(jù)為訂單,則留空
SUCCES—退款成功
FAIL—退款失敗
PROCESSING—退款處理中
商品名稱 中文[body] 商戶傳入的該筆訂單(或該筆退款對(duì)應(yīng)的訂單)的商品名稱,對(duì)應(yīng)下單接口里的body字段
商戶數(shù)據(jù)包 測試中文[attach] 商戶傳入的該筆訂單(或該筆退款對(duì)應(yīng)的訂單)的商戶數(shù)據(jù)包,對(duì)應(yīng)下單接口里的attach字段,不傳時(shí)留空
手續(xù)費(fèi) 0.00000 該筆訂單/退款對(duì)應(yīng)的手續(xù)費(fèi)金額,訂單對(duì)應(yīng)正數(shù)、退款對(duì)應(yīng)負(fù)數(shù),單位元,保留小數(shù)點(diǎn)后2位
費(fèi)率 0.00% 該筆交易計(jì)費(fèi)所使用的費(fèi)率,百分?jǐn)?shù),如0.60%
訂單金額 0.01 該筆訂單的金額,包括用戶支付金額、充值券金額、免充值券金額,如果該行數(shù)據(jù)為退款或撤銷則填0.00,單位元,保留到小數(shù)點(diǎn)后2位
申請(qǐng)退款金額 0.00 商戶發(fā)起退款的金額,包括退給用戶的金額、充值券退款金額、免充值券退款金額,如果該行數(shù)據(jù)訂單則填0.00,單位元,保留到小數(shù)點(diǎn)后2位
費(fèi)率備注 - 如果有特殊費(fèi)率規(guī)則時(shí)則加以說明,默認(rèn)留空

錯(cuò)誤碼

錯(cuò)誤碼 名稱 描述 解決方案
100 SYSTEMERROR 下載失敗 請(qǐng)嘗試再次查詢。
20003 SYSTEMERROR 下載失敗 請(qǐng)嘗試再次查詢。
20001 sign error 簽名錯(cuò)誤 簽名錯(cuò)誤,請(qǐng)重新檢查參數(shù)和簽名密鑰是否正確
nonce_str too long 參數(shù)nonce_str錯(cuò)誤 參數(shù)nonce_str長度超長
invalid tar_type, Only GZIP supported 參數(shù)tar_type錯(cuò)誤 請(qǐng)重新檢查參數(shù)invalid tar_typ是否正確
invalid bill_type 參數(shù)bill_type錯(cuò)誤 請(qǐng)重新檢查參數(shù)bill_type是否正確
invalid bill_date 參數(shù)bill_date錯(cuò)誤 請(qǐng)重新檢查參數(shù)bill_date是否符合要求
require POST method 請(qǐng)求方式錯(cuò)誤 請(qǐng)求檢查參數(shù)請(qǐng)求方式是否為post
empty post data 請(qǐng)求報(bào)文錯(cuò)誤 請(qǐng)重新檢查請(qǐng)求報(bào)文是否正確
data format error 參數(shù)格式錯(cuò)誤 請(qǐng)重新檢查請(qǐng)求參數(shù)格式是否為xml
missing parameter 缺少參數(shù) 請(qǐng)重新檢查是否所有必傳參數(shù)都上傳了,且不為空
invalid appid appid錯(cuò)誤 請(qǐng)重新檢查參數(shù)appid是否正確
invalid parameter 參數(shù)錯(cuò)誤 請(qǐng)重新檢查是否所有參數(shù)都與文檔相符
20002 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)以后再下載。
20007 當(dāng)前商戶號(hào)賬單API權(quán)限已經(jīng)關(guān)閉 當(dāng)前商戶號(hào)賬單API權(quán)限已經(jīng)關(guān)閉 當(dāng)前商戶號(hào)賬單API權(quán)限已經(jīng)關(guān)閉,請(qǐng)聯(lián)系微信支付解決
20100 system error 下載失敗 請(qǐng)嘗試再次查詢。

版本說明

關(guān)閉
V1.0
2020年04月17日
1. 下載交易賬單接口上線

技術(shù)咨詢

文檔反饋