API字典 / 分賬（賬單及資金查詢(xún)） / 獲取分賬退款賬單下載鏈接API

獲取分賬退款賬單下載鏈接API

最新更新時(shí)間：2023.10.20 版本說(shuō)明

微信支付按天提供分賬退款文件，商戶(hù)可以通過(guò)該接口獲取賬單文件的下載地址。文件內(nèi)包含分賬退款相關(guān)的金額、時(shí)間等信息，供商戶(hù)核對(duì)到賬等情況。

注意：

? 微信側(cè)未成功的分賬單不會(huì)出現(xiàn)在對(duì)賬單中；

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

? 分賬對(duì)賬單接口只支持下載90天以?xún)?nèi)的賬單。

1. 接口說(shuō)明

適用對(duì)象：直連模式機(jī)構(gòu)模式

請(qǐng)求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/refunds/bill-download-url

請(qǐng)求方式：GET

Path指該參數(shù)為路徑參數(shù)

Query指該參數(shù)為URL參數(shù)

Body指該參數(shù)需在請(qǐng)求JSON傳參

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

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
二級(jí)商戶(hù)號(hào)	sub_mchid	string[1, 32]	否	Query若商戶(hù)是直連商戶(hù)： - 無(wú)需填寫(xiě)該字段。若商戶(hù)是服務(wù)商/機(jī)構(gòu)： - 不填則默認(rèn)返回服務(wù)商/機(jī)構(gòu)下所有賬單數(shù)據(jù)； - 如需下載某個(gè)二級(jí)商戶(hù)下的賬單數(shù)據(jù)，則該字段必填示例值：19000000001
賬單日期	bill_date	string[10, 10]	是	Query格式y(tǒng)yyy-MM-DD 分賬對(duì)賬單接口只支持下載90天以?xún)?nèi)的賬單。示例值：2020-01-01

請(qǐng)求示例

URL


https://api.mch.weixin.qq.com/v3/global/profit-sharing/refunds/bill-download-url?sub_mchid=19000000001&bill_date=2020-01-01


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
    "appid": "wx78898sdfwe9888835", 
    "type": "PERSONAL_OPENID", 
    "sub_mchid": "999968480"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回參數(shù)

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
下載地址	download_url	string[1, 2048]	是	供下一步請(qǐng)求賬單文件的下載地址，該地址30s內(nèi)有效示例值：https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx

返回示例

正常示例


{
  "download_url": "https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx"
}


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
    "appid": "wx78898sdfwe9888835", 
    "type": "PERSONAL_OPENID", 
    "sub_mchid": "999968480"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

文件格式說(shuō)明

? 賬單文件包括明細(xì)數(shù)據(jù)和匯總數(shù)據(jù)兩部分，每一部分都包含一行表頭和若干行具體數(shù)據(jù)；

? 明細(xì)數(shù)據(jù)每一行對(duì)應(yīng)一筆分賬，同時(shí)每一個(gè)數(shù)據(jù)前加入了字符`，以避免數(shù)據(jù)被Excel按科學(xué)計(jì)數(shù)法處理。如需匯總金額等數(shù)據(jù)，可以批量替換掉該字符。

? 數(shù)據(jù)頭的格式為：Refund apply time,Refund success time,Wechat refund number(refund_id),Vendor refund number(out_refund_no),Wechat order number(transaction_id),Vendor order number(out_transaction_id),Refund amount(refund_fee),Currency type,Coupon refund amount,Payer's refund amount,Payer's refund currency type,Rate,Refund source,Refund source type,Refund source amount,Refund source fee in RMB,Refund settlement currency type,Refund exchange rate,Refund source settlement amount,Refund source fee in settlement currency type; 對(duì)應(yīng)的含義見(jiàn)下表：

變量	字段名	描述
Refund apply time	退款申請(qǐng)時(shí)間	指該筆交易發(fā)起退款時(shí)間，格式為YYYY-MM-DD HH:MM:SS，如2015-01-01 10:00:00 示例值：2015-01-01 10:00:00
Refund success time	退款成功時(shí)間	指該筆交易退款成功時(shí)間，格式為YYYY-MM-DD HH:MM:SS，如2015-01-01 10:00:00 示例值：2015-01-01 10:00:00
Wechat refund number(refund_id)	微信退款單號(hào)	微信支付為該筆退款分配的退款單號(hào) 示例值：5050000008201712143733500002
Vendor refund number(out_refund_no)	商戶(hù)退款單號(hào)	商戶(hù)發(fā)起退款時(shí)填入的商戶(hù)退款單號(hào) 示例值：ST175HQWa0
Wechat order number(transaction_id)	微信訂單號(hào)	微信支付為該筆退款對(duì)應(yīng)的訂單分配的訂單號(hào) 示例值：4200000008201712143733500001
Vendor order number(out_transaction_id)	商戶(hù)訂單號(hào)	商戶(hù)傳入的該筆訂單（或該筆退款對(duì)應(yīng)的訂單）的商戶(hù)訂單號(hào)，對(duì)應(yīng)下單接口里的out_trade_no字段示例值：test1
Refund amount(refund_fee)	退款單金額	標(biāo)價(jià)幣種對(duì)應(yīng)的退款金額示例值：0.00
Currency type	標(biāo)價(jià)幣種	商品標(biāo)價(jià)貨幣類(lèi)型，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，如CNY 示例值：CNY
Coupon refund amount	代金券或立減優(yōu)惠金額	該筆訂單中使用的微信支付代金券金額（包括充值券和免充值券），單位元，保留到小數(shù)點(diǎn)后2位示例值：0.00
Payer's refund amount	用戶(hù)支付退款金額	用戶(hù)支付幣種對(duì)應(yīng)的退款總金額示例值：0.00
Payer's refund currency type	用戶(hù)支付退款幣種	用戶(hù)支付貨幣類(lèi)型，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，如CNY 示例值：CNY
Rate	手續(xù)費(fèi)費(fèi)率	該筆交易計(jì)費(fèi)所使用的費(fèi)率，百分?jǐn)?shù) 示例值：0.50%
Refund source	退款出資來(lái)源	指一筆分賬退款單的退款資金來(lái)源，枚舉值如下： 1、可墊付退款額度 FUNDS_REFUNDABLE_BALANCE 2、訂單未分可退余額 ORDER_REFUNDABLE_BALANCE 示例值：ORDER_REFUNDABLE_BALANCE
Refund source type	退款出資來(lái)源組合	指一筆分賬退款單的退款資金來(lái)源類(lèi)型，有兩種類(lèi)型： 1）可能是單一來(lái)源，比如：一筆100元的退款單，全部使用"訂單未分可退余額"完成退款，則展示“SINGLE_SOURCE”； 2）可能是組合來(lái)源，比如：一筆100元的退款單，30元從“訂單未分可退余額”中出資，70元從“可墊付退款額度”中出資，則展示“PACKAGE”。當(dāng)通過(guò)組合“PACKAGE”的方式執(zhí)行退款，則需關(guān)注同一筆退款當(dāng)在賬單中將呈現(xiàn)多條記錄。枚舉值： 1、PACKAGE 2、SINGLE_SOURCE 示例值：PACKAGE
Refund source amount	退款出資額（RMB）	指一筆分賬退款單，每項(xiàng)指定的“退款出資來(lái)源”實(shí)際出資用于退款的金額。示例值：0.00
Refund source fee in RMB	退款出資額手續(xù)費(fèi)（RMB）	指一筆分賬退款單，每部分退款出資額，包含的手續(xù)費(fèi)金額示例值：-0.02
Refund settlement currency type	退款結(jié)算幣種	商戶(hù)發(fā)起退款時(shí)的貨幣類(lèi)型，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，如CNY 示例值：CNY
Refund exchange rate	退款匯率	退款匯率，外幣兌換RMB的比例乘以10的8次方即為此值，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：650000000 注意：退款匯率值，取退款成功時(shí)點(diǎn)的市場(chǎng)匯率，匯率價(jià)格由相關(guān)合作銀行提供。
Refund source settlement amount	退款出資額結(jié)算金額	指一筆分賬退款單，每部分退款出資額，對(duì)應(yīng)的結(jié)算外幣金額，特別說(shuō)明： 1、退款出資源來(lái)自“可墊付退款額度（FUNDS_REFUNDABLE_BALANCE ） ”，屬于使用待出境結(jié)算資金扎差退款，需計(jì)算外幣結(jié)算金額。 2、退款出資源來(lái)自“訂單未分可退余額（ORDER_REFUNDABLE_BALANCE）”，屬于未出境部分的資金，不會(huì)影響結(jié)算資金，該值為空。示例值：0.00
Refund source fee in settlement currency type	退款出資額手續(xù)費(fèi)（結(jié)算貨幣）	指一筆分賬退款單，每部分退款出資額，對(duì)應(yīng)的結(jié)算外幣結(jié)算手續(xù)費(fèi)。 1、退款出資源來(lái)自“可墊付退款額度（FUNDS_REFUNDABLE_BALANCE ） ”，需計(jì)算外幣手續(xù)費(fèi)。 2、退款出資源來(lái)自“訂單未分可退余額（ORDER_REFUNDABLE_BALANCE）”，該值為空。示例值：-0.00

賬單內(nèi)容示例


Refund apply time,Refund success time,Wechat refund number(refund_id),Vendor refund number(out_refund_no),Wechat order number(transaction_id),Vendor order number(out_transaction_id),Refund amount(refund_fee),Currency type,Coupon refund amount,Payer's refund amount,Payer's refund currency type,Rate,Refund source,Refund source type,Refund source amount,Refund source fee in RMB,Refund settlement currency type,Refund exchange rate,Refund source settlement amount,Refund source fee in settlement currency type
`2022-07-26 23:08:30,`2022-07-26 23:08:38,`50202102632022072601880685005,`test00011115_001,`4200000002202207268931261193,`test00011115,`400.00,`CNY,`20.00,`400.00,`CNY,`0.50%,`FUNDS_REFUNDABLE_BALANCE,`PACKAGE,`200.00,`-1.00000,`HKD,`86500000,`231.21000,`-0.87000


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
    "appid": "wx78898sdfwe9888835", 
    "type": "PERSONAL_OPENID", 
    "sub_mchid": "999968480"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

4. 錯(cuò)誤碼

狀態(tài)碼	錯(cuò)誤碼	描述	解決方案
400	NO_STATEMENT_EXIST	請(qǐng)求的賬單文件不存在	請(qǐng)檢查當(dāng)前商戶(hù)號(hào)是否在指定日期有處理成功的分賬指令單
400	STATEMENT_CREATING	賬單生成中	請(qǐng)先檢查當(dāng)前商戶(hù)號(hào)在指定日期內(nèi)是否有處理成功的分賬指令單，若有，則在T+1日上午10點(diǎn)后再重新下載
403	NO_AUTH	商戶(hù)父子關(guān)系不存在，請(qǐng)使用正確的二級(jí)商戶(hù)號(hào)發(fā)起請(qǐng)求	請(qǐng)檢查二級(jí)商戶(hù)號(hào)(sub_mchid)是否填寫(xiě)正確
403	NO_AUTH	商戶(hù)未簽約境外分賬產(chǎn)品能力	請(qǐng)參考產(chǎn)品流程和接入準(zhǔn)備，確認(rèn)商戶(hù)具有分賬權(quán)限后再發(fā)起請(qǐng)求
403	NO_AUTH	商戶(hù)已開(kāi)通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效)	開(kāi)通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬，請(qǐng)等待第二天后發(fā)起請(qǐng)求

頁(yè)面導(dǎo)航

語(yǔ)言

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類(lèi)產(chǎn)品

其他產(chǎn)品

獲取分賬退款賬單下載鏈接API

1. 接口說(shuō)明

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

請(qǐng)求示例

3. 返回參數(shù)

返回示例

文件格式說(shuō)明

4. 錯(cuò)誤碼