微信支付-融合錢包開發(fā)者文檔

接口說明

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

請(qǐng)求URL:https://api.mch.weixin.qq.com/hk/v3/refunds

請(qǐng)求方式: GET

接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3/wei-xin-zhi-fu-api-v3-jie-kou-gui-fan

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

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

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

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

參數(shù)名	變量	類型	必填	描述
微信支付訂單號(hào)	transaction_id	string(32)	二選一	query 微信支付訂單號(hào) 示例值：1217752501201407033233368018
商戶訂單號(hào)	out_trade_no	string(32)	二選一	query 商戶訂單號(hào) 示例值：1217752501201407033233368018
商戶號(hào)	mchid	string(32)	是	query 微信支付分配的商戶號(hào) 注意：僅適用于直連模式示例值：1900000109
子商戶號(hào)	sub_mchid	string(32)	是	query 微信支付分配的子商戶號(hào) 注意：僅適用于機(jī)構(gòu)模式示例值：1900000109
機(jī)構(gòu)商戶號(hào)	sp_mchid	string(32)	是	query 微信支付分配的機(jī)構(gòu)商戶號(hào) 注意：僅適用于機(jī)構(gòu)模式示例值：1900000100
記錄起始位置	offset	int	是	query 分頁功能，起始位置示例值：0
每頁筆數(shù)	count	int	是	query 分頁功能，每頁返回記錄數(shù)，最大值限制為20 示例值：10

請(qǐng)求示例：

URL


使用微信支付訂單號(hào)查單示例：
https://api.mch.weixin.qq.com/hk/v3/refunds?transaction_id=1217752501201407033233368018&count=10&offset=0&sp_mchid=1900000100&sub_mchid=1900000109

使用商戶訂單號(hào)查單示例：
https://api.mch.weixin.qq.com/hk/v3/refunds?out_trade_no=1217752501201407033233368018&count=10&offset=0&sp_mchid=1900000100&sub_mchid=1900000109

    
｛
JAVA示例代碼
｝

返回參數(shù)

正常返回

參數(shù)名

變量

類型

必填

描述

微信支付交易訂單號(hào)

id

string(32)

是

微信支付交易訂單號(hào)
示例值：1217752501201407033233368018

商戶號(hào)

mchid

string(32)

是

微信支付分配的商戶號(hào)
注意：僅適用于直連模式
示例值：1900000109

子商戶號(hào)

sub_mchid

string(32)

是

微信支付分配的子商戶號(hào)
注意：僅適用于機(jī)構(gòu)模式
示例值：1900000109

機(jī)構(gòu)商戶號(hào)

sp_mchid

string(32)

是

微信支付分配的機(jī)構(gòu)商戶號(hào)
注意：僅適用于機(jī)構(gòu)模式
示例值：1900000100

商戶原交易訂單號(hào)

out_trade_no

string(64)

是

返回的原交易訂單號(hào)。
示例值： 1217752501201407033233368018

+ 訂單金額

amount

object

是

原支付訂單金額信息，詳細(xì)說明見下文

參數(shù)名	變量	類型	必填	描述
訂單金額	total	int	是	訂單總金額，幣種的最小單位，只能為整數(shù)，詳見支付金額示例值：888
貨幣類型	currency	string(16)	否	符合 ISO 4217 標(biāo)準(zhǔn)的三位字母代碼示例值：CNY
用戶支付金額	payer_total	int	是	用戶實(shí)際支付金額，幣種的最小單位，只能為整數(shù)，詳見支付金額示例值：888
支付幣種	payer_currency	string(16)	是	符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼示例值：CNY

+ 退款單列表

data

array

是

返回的退款列表，詳細(xì)說明見下文

參數(shù)名

變量

類型

必填

描述

微信退款單號(hào)

id

string(32)

是

微信支付退款單號(hào)
示例值：1217752501201407033233368018

商戶退款單號(hào)

out_refund_no

string(64)

是

返回的退款訂單號(hào)。
示例值：1217752501201407033233368018

退款渠道

channel

string(16)

否

ORIGINAL：原路退款
BALANCE：退回到余額
OTHER_BALANCE：原賬戶異常退到其他余額賬戶
OTHER_BANKCARD：原銀行卡異常退到其他銀行卡
示例值：ORIGINAL

退款入賬賬戶

recv_account

string(64)

否

取當(dāng)前退款單的退款入賬方
1）退回銀行卡：
{銀行名稱}{卡類型}{卡尾號(hào)}
2）退回支付用戶零錢:
支付用戶零錢
3）退回支付用戶零錢通:
支付用戶零錢通
示例值：招商銀行信用卡0403

退款資金來源

fund_source

string(30)

否

REFUND_SOURCE_UNSETTLED_FUNDS：未結(jié)算資金退款（默認(rèn)使用未結(jié)算資金退款）
REFUND_SOURCE_REchARGE_FUNDS：可用余額退款
示例值：REFUND_SOURCE_UNSETTLED_FUNDS

退款成功時(shí)間

success_time

string(64)

否

退款成功時(shí)間，當(dāng)退款狀態(tài)為退款成功時(shí)有返回。
示例值：2018-06-08T10:34:56+08:00

退款創(chuàng)建時(shí)間

create_time?

string(64)

是

退款受理時(shí)間
示例值：2018-06-08T10:34:56+08:00

退款狀態(tài)

status

string(16)

是

退款狀態(tài)：
SUCCESS：退款成功
REFUNDCLOSE：退款關(guān)閉
PROCESSING：退款處理中
ABNORMAL：退款異常，退款到銀行發(fā)現(xiàn)用戶的卡作廢或者凍結(jié)了，導(dǎo)致原路退款銀行卡失敗，可前往【服務(wù)商平臺(tái)—>交易中心】，手動(dòng)處理此筆退款
示例值：SUCCESS

+ 退款金額

amount

object

是

退款單金額信息，詳細(xì)說明見下文

參數(shù)名

變量

類型

必填

描述

退款金額

refund

int

是

退款金額，幣種的最小單位，只能為整數(shù)，不能超過原訂單支付金額，如果有使用券，后臺(tái)會(huì)按比例退。
示例值：888

貨幣類型

currency

string(16)

否

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼
示例值：CNY

用戶退款金額

payer_refund

int

是

退款給用戶的金額，不包含所有優(yōu)惠券金額
示例值：888

支付幣種

payer_currency

string(16)

是

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼
示例值：CNY

+ 匯率

exchange_rate

object?

是

匯率信息

參數(shù)名	變量	類型	必填	描述
匯率類型	type	string(16)	否	標(biāo)價(jià)幣種和支付幣種一致時(shí),type="SETTLEMENT_RATE",即【實(shí)時(shí)】標(biāo)價(jià)幣種和結(jié)算幣種的匯率；標(biāo)價(jià)幣種和支付幣種不一致,type="USERPAYMENT_RATE",即【原支付】標(biāo)價(jià)幣種和支付幣種的匯率示例值：SETTLEMENT_RATE
匯率值	rate	int	否	rate值是兌換比例乘以10的8次方，如果兌換比例是1，則rate=100000000；如果兌換比例為6.5，則rate=650000000 示例值：8000000

+ 優(yōu)惠退款詳情

refund_detail

object

否

優(yōu)惠退款功能信息，詳細(xì)說明見下文

參數(shù)名	變量	類型	必填	描述
券ID	promotion_id	string(32)	是	券或者立減優(yōu)惠id 示例值：109519
優(yōu)惠范圍	scope	string(32)	否	GLOBAL：全場(chǎng)代金券 SINGLE：?jiǎn)纹穬?yōu)惠示例值：SINGLE
優(yōu)惠類型	type	string(32)	否	COUPON：代金券，需要走結(jié)算資金的充值型代金券,（境外商戶券幣種與支付幣種一致） DISCOUNT：優(yōu)惠券，不走結(jié)算資金的免充值型優(yōu)惠券，（境外商戶券幣種與標(biāo)價(jià)幣種一致示例值：DISCOUNT
優(yōu)惠券面額	amount	int	否	用戶享受優(yōu)惠的金額示例值：5
優(yōu)惠券退款額	refund_amount	int	否	按比例退款的優(yōu)惠券金額示例值：5
貨幣類型	currency	string(16)	是	符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼示例值：CNY

訂單總退款次數(shù)

total_num

int

是

訂單總退款次數(shù)
示例值：0

本次返回退款單數(shù)

current_total_num

int

是

本次返回退款單數(shù)
示例值： 10

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(tài)碼

code

string(32)

是

錯(cuò)誤碼，枚舉值見錯(cuò)誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string(256)

是

返回信息，如非空，為錯(cuò)誤原因
示例值：參數(shù)格式校驗(yàn)錯(cuò)誤

+ 詳細(xì)的錯(cuò)誤描述

detail

object

否

當(dāng)code為PARAM_ERROR時(shí)返回，詳細(xì)說明見下

參數(shù)名	變量	類型	必填	描述
指示錯(cuò)誤參數(shù)的位置	field	string(256)	是	當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求body的JSON時(shí)，填寫指向參數(shù)的JSON Pointer；當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求的url或者querystring時(shí)，填寫參數(shù)的變量名示例值：#/properties/payer
錯(cuò)誤參數(shù)的值	value	string(256)	是	錯(cuò)誤參數(shù)的值示例值：1346177081915535577
具體錯(cuò)誤原因	issue	string(256)	是	具體錯(cuò)誤原因示例值：與ALLOF schema不符
錯(cuò)誤參數(shù)的位置	location	string(256)	否	body：錯(cuò)誤參數(shù)位于請(qǐng)求body的JSON中 url：錯(cuò)誤參數(shù)位于請(qǐng)求url中 query：錯(cuò)誤參數(shù)位于請(qǐng)求的querystring中示例值：body

返回示例：

{
    "id": "1008450740201411110005820873",
    "sp_mchid": "10000100",
    "sub_mchid": "20000100",
    "out_trade_no": "20150806125346",
    "amount" : {
        "total": 528800,
        "currency":"HKD",
        "payer_total": 518799,
        "payer_currency": "HKD",
    }, 
    "total_num": 1,
    "current_total_num": 1,
    "data": [
        {
            "id": "2008450740201411110000174436",
            "out_refund_no": "R20150806125346",
            "channel": "ORIGINAL",
            "amount": {
                "refund": 50,
                "currency": "CNY",
                "payer_refund": 49,
                "payer_currency": "HKD",
                "exchange_rate" : {
                    "type": "SETTLEMENT_RATE",
                    "rate": 8000000
                } 
            },
            "status": "SUCCESS",
            "recv_account": "招商銀行信用卡0403",
            "fund_source": "REFUND_SOURCE_REchARGE_FUNDS",
            "success_time": "2018-06-08T10:34:56+08:00",
            "create_time": "2018-06-08T10:34:56+08:00",
            "detail": [
                {
                    "promotion_id":"109519",
                    "scope":"GLOBAL",
                    "type":"COUPON",
                    "amount": 1,
                    "refund_amount": 1,
                    "currency": "HKD"
                }                
            ]
        }
    ]
}

{
"code":"INVALID_REQUEST",
"message":"參數(shù)格式校驗(yàn)錯(cuò)誤",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"與ALLOF schema不符",
    "location":"body"
   }
}

錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
SYSTEMERROR	接口返回錯(cuò)誤	請(qǐng)嘗試再次掉調(diào)用API。
REFUNDNOTEXIST	退款訂單查詢失敗	請(qǐng)檢查訂單號(hào)是否有誤以及訂單狀態(tài)是否正確，如：未支付、已支付未退款，如果訂單下沒有退款單，則會(huì)返回此錯(cuò)誤碼，其他信息是不返回的
INVALID_TRANSACTIONID	無效transaction_id	請(qǐng)求參數(shù)錯(cuò)誤，檢查原交易號(hào)是否存在或發(fā)起支付交易接口返回失敗
PARAM_ERROR	參數(shù)錯(cuò)誤	請(qǐng)求參數(shù)錯(cuò)誤，請(qǐng)檢查參數(shù)再調(diào)用退款申請(qǐng)
APPID_NOT_EXIST	APPID不存在	請(qǐng)檢查APPID是否正確
MchID_NOT_EXIST	MchID不存在	請(qǐng)檢查MchID是否正確
REQUIRE_POST_METHOD	請(qǐng)使用post方法	請(qǐng)檢查請(qǐng)求參數(shù)是否通過post方法提交
SIGNERROR	簽名錯(cuò)誤	請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

公眾號(hào)支付

查詢所有退款

注意：

接口說明

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

請(qǐng)求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯(cuò)誤碼

版本說明