微信支付-跨境開發(fā)者中心

1. 接口說明

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

請求URL:https://apihk.mch.weixin.qq.com/v3/global/refunds

請求方式: POST

頻率限制:150qps

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

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

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

2. 請求參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

商戶號

mchid

string[1,32]

是

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

APPID

appid

string[1,32]

是

Body 商戶在微信開放平臺申請移動應用對應的APPID
注意：僅適用于直連模式
示例值：wx8888888888888888

機構(gòu)商戶號

sp_mchid

string[1,32]

是

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

子商戶號

sub_mchid

string[1,32]

是

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

機構(gòu)APPID

sp_appid

string[1,32]

是

Body商戶在微信公眾平臺申請服務(wù)號對應的APPID
注意：僅適用于機構(gòu)模式
示例值：wx8888888888888888

子商戶APPID

sub_appid

string[1,32]

否

Body 子商戶在微信開放平臺申請移動應用對應的APPID
付款碼支付/掃碼支付/公眾號支付使用商戶公眾號appid
小程序支付使用商戶小程序appid
APP支付使用商戶APP應用appid
注意：僅適用于機構(gòu)模式
示例值：wx8888888888888888

微信訂單號

transaction_id

string[1,32]

二選一

Body 原支付交易對應的微信訂單號
示例值：1217752501201407033233368018

商戶訂單號

out_trade_no

string[1,32]

Body 原支付交易對應的訂單號
示例值：1217752501201407033233368018

商戶退款單號

out_refund_no

string[1,64]

是

Body 商戶系統(tǒng)內(nèi)部的退款單號，商戶系統(tǒng)內(nèi)部唯一，只能是數(shù)字、大小寫字母_-|*@ ，同一退款單號多次請求只退一筆。
示例值：1217752501201407033233368018

退款原因

reason

string[1,80]

否

Body 若商戶傳入，會在下發(fā)給用戶的退款消息中體現(xiàn)退款原因
注意：若訂單退款金額≤1元，且屬于部分退款，則不會在退款消息中體現(xiàn)退款原因
示例值：商品已售完

退款資金來源

source

string[1,30]

否

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

訂單金額

amount

object

是

Body 訂單金額信息，詳細說明見下文

參數(shù)名

變量

類型

必填

描述

退款金額

refund

int

是

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

原訂單金額

total

int

是

原支付交易的訂單總金額，幣種的最小單位，只能為整數(shù)，詳見交易金額
示例值：888

退款幣種

currency

string[1,16]

是

符合ISO 4217標準的三位字母代碼，退款幣種必須和標價幣種一致，幣種列表詳見幣種類型
示例值：HKD

退款出資來源及金額

from

array

否

跨境分賬訂單傳遞此參數(shù)指定出資來源及金額；
分賬訂單如果不傳此參數(shù)，則默認優(yōu)先從訂單未分可退余額出資退款，不足部分由可墊付退款額度補足，具體出資來源及金額需要根據(jù)返回參數(shù)中 from 字段確認。
此參數(shù)使用場景需要滿足以下條件：
1、訂單屬于跨境分賬訂單，非跨境訂單請不要傳遞此參數(shù)。
參數(shù)傳遞需要滿足條件：
1、可墊付退款余額出資金額和訂單未分可退余額出資金額之和等于退款金額；
2、出資來源不能重復。
上述任一條件不滿足將返回錯誤。

參數(shù)名	變量	類型	必填	描述
出資來源	fund_source	string[1,32]	是	退款出資來源，下面枚舉值多選一。枚舉值： FUNDS_REFUNDABLE_BALANCE : 可墊付退款余額 ORDER_REFUNDABLE_BALANCE : 訂單未分可退余額示例值：FUNDS_REFUNDABLE_BALANCE
出資金額	amount	int	是	對應出資來源金額（幣種的最小單位，只能為整數(shù)）示例值：888

收起

退款通知地址

notify_url

string[1,256]

否

Body異步接收微信退款狀態(tài)變更的回調(diào)地址，通知url必須為外網(wǎng)可訪問的url，不能攜帶參數(shù)。請使用https協(xié)議鏈接
示例值：https://www.weixin.qq.com/wxpay/pay.php

請求示例

場景一: 普通訂單退款請求場景二: 分賬訂單指定出資來源退款請求


{
    "sp_appid": "wx2421b1c4370ec43b",
    "sub_appid": "1900000109",
    "sp_mchid": "10000100",
    "sub_mchid": "20000100",
    "transaction_id": "1008450740201411110005820873",
    "out_refund_no": "R20150806125346",
    "amount" : {
        "refund": 50,
        "total":100,
         "currency":"HKD"
    },
    "reason": "商品已售完",
    "source": "REFUND_SOURCE_UNSETTLED_FUNDS"
}


{
	"sp_appid": "wx7bc98d929da735fe",
	"sp_mchid": "999952224",
	"sub_mchid": "999968479",
	"out_trade_no": "20220724trade004",
	"out_refund_no": "20220724trade004refund001",
	"amount": {
		"currency": "CNY",
		"refund": 500,
		"total": 1000,
		"from": [{
				"fund_source": "FUNDS_REFUNDABLE_BALANCE",
				"amount": 200
			},
			{
				"fund_source": "ORDER_REFUNDABLE_BALANCE",
				"amount": 300
			}??//#注: 出資來源金額之和必須等于總退款金額， 即 200 + 300 = 500
		]
	},
	"reason": "商品已售完"
}


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


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

3. 返回參數(shù)

正常返回

參數(shù)名

變量

類型

必填

描述

微信支付退款訂單號

id

string[1,32]

是

微信支付退款訂單號
示例值：1217752501201407033233368018

商戶退款單號

out_refund_no

string[1,64]

是

返回的退款訂單號。
示例值：1217752501201407033233368018

退款創(chuàng)建時間

create_time?

string[1,64]

是

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

退款金額

amount

object

是

退款金額信息，詳細說明見下文

參數(shù)名

變量

類型

必填

描述

退款金額

refund

int

是

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

退款幣種

currency

string[1,16]

是

符合ISO 4217標準的三位字母代碼
示例值：CNY

用戶退款金額

payer_refund

int

是

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

支付幣種

payer_currency

string[1,16]

是

符合ISO 4217標準的三位字母代碼
示例值：CNY

結(jié)算幣種退款金額

settlement_refund

int

是

商戶結(jié)算幣種所對應的退款金額，幣種的最小單位，只能為整數(shù)
示例值：888

結(jié)算幣種

settlement_currency

string[1,16]

是

結(jié)算幣種，符合ISO 4217標準的三位字母代碼，幣種列表詳見幣種類型
示例值：HKD

匯率

exchange_rate

object?

是

匯率信息

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

收起

退款出資來源及金額

from

array

否

跨境分賬訂單傳遞此參數(shù)指定出資來源及金額；
分賬訂單如果不傳此參數(shù)，則默認優(yōu)先從訂單未分可退余額出資退款，不足部分由可墊付退款額度補足，具體出資來源及金額需要根據(jù)返回參數(shù)中 from 字段確認。
此參數(shù)使用場景需要滿足以下條件：
1、訂單屬于跨境分賬訂單，非跨境訂單請不要傳遞此參數(shù)。
參數(shù)傳遞需要滿足條件：
1、可墊付退款余額出資金額和訂單未分可退余額出資金額之和等于退款金額；
2、出資來源不能重復。
上述任一條件不滿足將返回錯誤。

參數(shù)名	變量	類型	必填	描述
出資來源	fund_source	string[1,32]	是	退款出資來源，下面枚舉值多選一。枚舉值： FUNDS_REFUNDABLE_BALANCE : 可墊付退款余額 ORDER_REFUNDABLE_BALANCE : 訂單未分可退余額示例值：FUNDS_REFUNDABLE_BALANCE
出資金額	amount	int	是	對應出資來源金額（幣種的最小單位，只能為整數(shù)）示例值：888

收起

優(yōu)惠退款詳情

detail

Object

否

優(yōu)惠退款詳情信息，詳細說明見下文

參數(shù)名	變量	類型	必填	描述
券ID	promotion_id	string[1,32]	是	券或者立減優(yōu)惠id 示例值：109519
優(yōu)惠范圍	scope	string[1,32]	否	GLOBAL：全場代金券 SINGLE：單品優(yōu)惠示例值：SINGLE
優(yōu)惠類型	type	string[1,32]	否	COUPON：代金券，需要走結(jié)算資金的充值型代金券,（境外商戶券幣種與支付幣種一致） DISCOUNT：優(yōu)惠券，不走結(jié)算資金的免充值型優(yōu)惠券，（境外商戶券幣種與標價幣種一致示例值：DISCOUNT
優(yōu)惠券面額	amount	int	否	用戶享受優(yōu)惠的金額（優(yōu)惠券面額=微信出資金額+商家出資金額+其他出資方金額）示例值：5
優(yōu)惠券退款額	refund_amount	int	否	按比例退款的優(yōu)惠券金額示例值：5
貨幣類型	currency	string[1,16]	是	符合ISO 4217標準的三位字母代碼示例值：CNY

收起

注意：goods_remark為備注字段，按照配置原樣返回，goods_tag是訂單優(yōu)惠標記，用于區(qū)分訂單是否可以享受優(yōu)惠，兩個字段內(nèi)容都在微信后臺配置券時進行設(shè)置。

異常返回

參數(shù)名

變量

類型[長度限制]

必填

描述

返回狀態(tài)碼

code

string[1, 32]

是

錯誤碼，枚舉值見錯誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

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

詳細的錯誤描述

detail

object

否

當code為PARAM_ERROR時返回，詳細說明見下

參數(shù)名	變量	類型[長度限制]	必填	描述
指示錯誤參數(shù)的位置	field	string[1, 256]	是	當錯誤參數(shù)位于請求body的JSON時，填寫指向參數(shù)的JSON Pointer 當錯誤參數(shù)位于請求的url或者querystring時，填寫參數(shù)的變量名示例值：#/properties/payer
錯誤參數(shù)的值	value	string[1, 256]	是	錯誤參數(shù)的值示例值：1346177081915535577
具體錯誤原因	issue	string[1, 256]	是	具體錯誤原因示例值：與ALLOF schema不符
錯誤參數(shù)的位置	location	string[1, 256]	否	body：錯誤參數(shù)位于請求body的JSON中 url：錯誤參數(shù)位于請求url中 query：錯誤參數(shù)位于請求的querystring中示例值：body

收起

返回示例

場景一返回示例場景二: 返回示例異常示例


{
    "id": "50202002642022072801898085012",
    "out_refund_no": "20220724trade003refund001",
    "create_time": "2022-07-28T15:44:07+08:00",
    "amount": {
        "refund": 500,
        "currency": "CNY",
        "payer_refund": 250,
        "payer_currency": "CNY",
        "settlement_refund": 578,
        "settlement_currency": "HKD",
        "exchange_rate": {
            "type": "SETTLEMENT_RATE",
            "rate": 86500000
        }
    },
    "detail": [
        {
            "promotion_id": "11006096615",
            "scope": "GLOBAL",
            "type": "COUPON",
            "amount": 500,
            "refund_amount": 250,
            "currency": "CNY"
        }
    ]
}


{
    "id": "50201702652022072801898085013",
    "out_refund_no": "20220724trade004refund001",
    "create_time": "2022-07-28T15:51:57+08:00",
    "amount": {
        "refund": 500,
        "currency": "CNY",
        "payer_refund": 250,
        "payer_currency": "CNY",
        "settlement_refund": 578,
        "settlement_currency": "HKD",
        "exchange_rate": {
            "type": "SETTLEMENT_RATE",
            "rate": 86490000
        },
        "from": [
            {
                "fund_source": "ORDER_REFUNDABLE_BALANCE",
                "amount": 300
            },
            {
                "fund_source": "FUNDS_REFUNDABLE_BALANCE",
                "amount": 200
            }
        ]
    },
    "detail": [
        {
            "promotion_id": "11006096908",
            "scope": "GLOBAL",
            "type": "COUPON",
            "amount": 500,
            "refund_amount": 250,
            "currency": "CNY"
        }
    ]
}


{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "與ALLOF schema不符",
		"location": "body"
	}
}

4. 錯誤碼

錯誤碼	描述	解決方案
RESOURCE_NOT_EXISTS	查詢的資源不存在	請檢查查詢資源的對應id是否填寫正確
SYSTEM_ERROR	接口返回錯誤	請不要更換商戶退款單號，請使用相同參數(shù)再次調(diào)用API。否則可能造成資金損失
BIZERR_NEED_RETRY	退款業(yè)務(wù)流程錯誤，需要商戶觸發(fā)重試來解決	請不要更換商戶退款單號，請使用相同參數(shù)再次調(diào)用API。否則可能造成資金損失
TRADE_OVERDUE	訂單已經(jīng)超過退款期限	請選擇其他方式自行退款
ERROR	業(yè)務(wù)錯誤	該錯誤都會返回具體的錯誤原因，請根據(jù)實際返回做相應處理。
USER_ACCOUNT_ABNORMAL	退款請求失敗	此狀態(tài)代表退款申請失敗，商戶可自行處理退款。
INVALID_REQ_TOO_MUCH	無效請求過多	請檢查業(yè)務(wù)是否正常，確認業(yè)務(wù)正常后請在1分鐘后再來重試
NOT_ENOUGH	余額不足	此狀態(tài)代表退款申請失敗，商戶可根據(jù)具體的錯誤提示做相應的處理。
INVALID_TRANSACTIONID	無效transaction_id	請求參數(shù)錯誤，檢查原交易號是否存在或發(fā)起支付交易接口返回失敗
PARAM_ERROR	參數(shù)錯誤	請求參數(shù)錯誤，請重新檢查再調(diào)用退款申請
APPID_NOT_EXIST	APPID不存在	請檢查APPID是否正確
MCHID_NOT_EXIST	MchID不存在	請檢查MchID是否正確
REQUIRE_POST_METHOD	請使用post方法	請檢查請求參數(shù)是否通過post方法提交
SIGN_ERROR	簽名錯誤	請檢查簽名參數(shù)和方法是否都符合簽名算法要求
FREQUENCY_LIMITED	頻率限制	該筆退款未受理，請降低頻率后重試，該筆退款未受理，請降低頻率后原單重試，請勿更換單號
ORDER_NOT_EXIST	訂單號不存在	請檢查你的訂單號是否正確且是否已支付，未支付的訂單不能發(fā)起退款
INVALID_REQUEST	請求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則	此狀態(tài)代表退款申請失敗，商戶可根據(jù)具體的錯誤提示做相應的處理。

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類產(chǎn)品

其他產(chǎn)品

申請退款API

1. 接口說明

2. 請求參數(shù)

請求示例

3. 返回參數(shù)

正常返回

異常返回

返回示例

4. 錯誤碼