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

商戶進件
特約商戶進件
基礎支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合單支付
付款碼支付
經營能力
支付即服務
點金計劃
行業(yè)方案
平臺收付通（商戶進件）
平臺收付通（普通支付）
平臺收付通（合單支付）
平臺收付通（分賬）
平臺收付通（補差）
平臺收付通（退款）
平臺收付通（余額查詢）
平臺收付通（商戶提現）
平臺收付通（注銷申請）
平臺收付通（注銷后提現）
平臺收付通（跨境付款）
平臺收付通（下載賬單）
智慧商圈
微信支付分停車服務
電子發(fā)票
營銷工具
代金券
商家券
委托營銷
支付有禮
小程序發(fā)券插件
H5發(fā)券
圖片上傳(營銷專用)
現金紅包
資金應用
分賬
連鎖品牌分賬
風險合規(guī)
商戶開戶意愿確認
消費者投訴2.0
商戶違規(guī)通知回調
其他能力
圖片上傳
視頻上傳
微信支付平臺證書

查詢單筆退款API

最新更新時間：2022.08.29 版本說明


提交退款申請后，通過調用該接口查詢退款狀態(tài)。退款有一定延時，建議在提交退款申請后1分鐘發(fā)起查詢退款狀態(tài)，一般來說零錢支付的退款5分鐘內到賬，銀行卡支付的退款1-3個工作日到賬。

接口說明

適用對象：服務商

請求URL：https://api.mch.weixin.qq.com/v3/refund/domestic/refunds/{out_refund_no}

請求方式：GET


path 指該參數為路徑參數

query 指該參數為URL參數

body 指該參數需在請求JSON傳參


請求參數

參數名 變量 類型[長度限制] 必填 描述
商戶退款單號 out_refund_no string[1, 64] 是 path商戶系統(tǒng)內部的退款單號，商戶系統(tǒng)內部唯一，只能是數字、大小寫字母_-|*@ ，同一退款單號多次請求只退一筆。
示例值：1217752501201407033233368018
子商戶號 sub_mchid string[1, 32] 是 query子商戶的商戶號，由微信支付生成并下發(fā)。
示例值：1900000109

請求示例


https://api.mch.weixin.qq.com/v3/refund/domestic/refunds/1217752501201407033233368018?sub_mchid=1900000109


｛
JAVA示例代碼
｝

返回參數

參數名 變量 類型[長度限制] 必填 描述
微信支付退款單號 refund_id string[1, 32] 是 微信支付退款單號
示例值：50000000382019052709732678859
商戶退款單號 out_refund_no string[1, 64] 是 商戶系統(tǒng)內部的退款單號，商戶系統(tǒng)內部唯一，只能是數字、大小寫字母_-|*@ ，同一退款單號多次請求只退一筆。
示例值：1217752501201407033233368018
微信支付訂單號 transaction_id string[1, 32] 是 微信支付交易訂單號
示例值：1217752501201407033233368018
商戶訂單號 out_trade_no string[1, 32] 是 原支付交易對應的商戶訂單號
示例值：1217752501201407033233368018
退款渠道 channel string[1, 16] 是 枚舉值：
ORIGINAL：原路退款
BALANCE：退回到余額
OTHER_BALANCE：原賬戶異常退到其他余額賬戶
OTHER_BANKCARD：原銀行卡異常退到其他銀行卡
示例值：ORIGINAL
退款入賬賬戶 user_received_account string[1, 64] 是 取當前退款單的退款入賬方，有以下幾種情況：
1）退回銀行卡：{銀行名稱}{卡類型}{卡尾號}
2）退回支付用戶零錢:支付用戶零錢
3）退還商戶:商戶基本賬戶商戶結算銀行賬戶
4）退回支付用戶零錢通:支付用戶零錢通
示例值：招商銀行信用卡0403
退款成功時間 success_time string[1, 64] 否 退款成功時間，當退款狀態(tài)為退款成功時有返回。
示例值：2020-12-01T16:18:12+08:00
退款創(chuàng)建時間 create_time string[1, 64] 是 退款受理時間
示例值：2020-12-01T16:18:12+08:00
退款狀態(tài) status string[1, 32] 是 退款到銀行發(fā)現用戶的卡作廢或者凍結了，導致原路退款銀行卡失敗，可前往服務商平臺-交易中心，手動處理此筆退款。
枚舉值：
SUCCESS：退款成功
CLOSED：退款關閉
PROCESSING：退款處理中
ABNORMAL：退款異常
示例值：SUCCESS
資金賬戶 funds_account string[1, 32] 否 退款所使用資金對應的資金賬戶類型
枚舉值：
UNSETTLED : 未結算資金
AVAILABLE : 可用余額
UNAVAILABLE : 不可用余額
OPERATION : 運營戶
BASIC : 基本賬戶（含可用余額和不可用余額）
示例值：UNSETTLED
+金額信息 amount object 是 金額詳細信息
參數名 變量 類型[長度限制] 必填 描述
訂單金額 total int 是 訂單總金額，單位為分
示例值：100
退款金額 refund int 是 退款標價金額，單位為分，可以做部分退款
示例值：100
+退款出資賬戶及金額 from array 否 退款出資的賬戶類型及金額信息
參數名 變量 類型[長度限制] 必填 描述
出資賬戶類型 account string[1, 32] 是 下面枚舉值多選一。
枚舉值：
AVAILABLE : 可用余額
UNAVAILABLE : 不可用余額
示例值：AVAILABLE
出資金額 amount int 是 對應賬戶出資金額
示例值：444
用戶支付金額 payer_total int 是 現金支付金額，單位為分，只能為整數
示例值：90
用戶退款金額 payer_refund int 是 退款給用戶的金額，不包含所有優(yōu)惠券金額
示例值：90
應結退款金額 settlement_refund int 是 去掉非充值代金券退款金額后的退款金額，單位為分，退款金額=申請退款金額-非充值代金券退款金額，退款金額<=申請退款金額
示例值：100
應結訂單金額 settlement_total int 是 應結訂單金額=訂單金額-免充值代金券金額，應結訂單金額<=訂單金額，單位為分
示例值：100
優(yōu)惠退款金額 discount_refund int 是 優(yōu)惠退款金額<=退款金額，退款金額-代金券或立減優(yōu)惠退款金額為現金，說明詳見代金券或立減優(yōu)惠，單位為分
示例值：10
退款幣種 currency string[1, 16] 是 符合ISO 4217標準的三位字母代碼，目前只支持人民幣：CNY。
示例值：CNY
手續(xù)費退款金額 refund_fee int 否 手續(xù)費退款金額，單位為分。
示例值：10
+優(yōu)惠退款信息 promotion_detail array 否 優(yōu)惠退款信息
參數名 變量 類型[長度限制] 必填 描述
券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-代金券，需要走結算資金的充值型代金券
DISCOUNT-優(yōu)惠券，不走結算資金的免充值型優(yōu)惠券
示例值：DISCOUNT
優(yōu)惠券面額 amount int 是 用戶享受優(yōu)惠的金額（優(yōu)惠券面額=微信出資金額+商家出資金額+其他出資方金額 ），單位為分
示例值：5
優(yōu)惠退款金額 refund_amount int 是 優(yōu)惠退款金額<=退款金額，退款金額-代金券或立減優(yōu)惠退款金額為用戶支付的現金，說明詳見代金券或立減優(yōu)惠，單位為分
示例值：100
+商品列表 goods_detail array 否 優(yōu)惠商品發(fā)生退款時返回商品信息
參數名 變量 類型[長度限制] 必填 描述
商戶側商品編碼 merchant_goods_id string[1, 32] 是 由半角的大小寫字母、數字、中劃線、下劃線中的一種或幾種組成
示例值：1217752501201407033233368018
微信支付商品編碼 wechatpay_goods_id string[1, 32] 否 微信支付定義的統(tǒng)一商品編號（沒有可不傳）
示例值：1001
商品名稱 goods_name string[1, 256] 否 商品的實際名稱
示例值：iPhone6s 16G
商品單價 unit_price int 是 商品單價金額，單位為分
示例值：528800
商品退款金額 refund_amount int 是 商品退款金額，單位為分
示例值：528800
商品退貨數量 refund_quantity int 是 單品的退款數量
示例值：1

返回示例


{
  "refund_id": "50000000382019052709732678859",
  "out_refund_no": "1217752501201407033233368018",
  "transaction_id": "1217752501201407033233368018",
  "out_trade_no": "1217752501201407033233368018",
  "channel": "ORIGINAL",
  "user_received_account": "招商銀行信用卡0403",
  "success_time": "2020-12-01T16:18:12+08:00",
  "create_time": "2020-12-01T16:18:12+08:00",
  "status": "SUCCESS",
  "funds_account": "UNSETTLED",
  "amount": {
    "total": 100,
    "refund": 100,
    "from": [
      {
        "account": "AVAILABLE",
        "amount": 444
      }
    ],
    "payer_total": 90,
    "payer_refund": 90,
    "settlement_refund": 100,
    "settlement_total": 100,
    "discount_refund": 10,
    "currency": "CNY"
  },
  "promotion_detail": [
    {
      "promotion_id": "109519",
      "scope": "SINGLE",
      "type": "DISCOUNT",
      "amount": 5,
      "refund_amount": 100,
      "goods_detail": [
	  	{
			"merchant_goods_id": "1217752501201407033233368018",
			"wechatpay_goods_id": "1001",
			"goods_name": "iPhone6s 16G",
			"unit_price": 528800,
			"refund_amount": 528800,
			"refund_quantity": 1
      	}
	  ]
    }
  ]
}
                    

http://2323weixin.qq.com

錯誤碼公共錯誤碼

狀態(tài)碼 錯誤碼 描述 解決方案
500 SYSTEM_ERROR 系統(tǒng)超時 請不要更換商戶退款單號，請使用相同參數再次調用API。
400 PARAM_ERROR 參數錯誤 請求參數錯誤，請檢查參數再調用退款查詢
404 MCH_NOT_EXISTS MCHID不存在 請檢查MCHID是否正確
404 RESOURCE_NOT_EXISTS 退款單查詢失敗 請檢查退款單號是否有誤以及訂單狀態(tài)是否正確，如：未支付、已支付未退款
401 SIGN_ERROR 簽名錯誤 請檢查簽名參數和方法是否都符合簽名算法要求




技術咨詢

文檔反饋