微信支付-JSAPI支付V3-查询退款
接口地址
接口链接:https://api.mch.weixin.qq.com/pay/refundquery
是否需要证书
不需要。
请求参数
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
公众账号ID |
appid |
是 |
String(32) |
wx8888888888888888 |
微信分配的公众账号ID |
商户号 |
mch_id |
是 |
String(32) |
1900000109 |
微信支付分配的商户号 |
设备号 |
device_info |
否 |
String(32) |
013467007045764 |
商户自定义的终端设备号,如门店编号、设备的ID等 |
随机字符串 |
nonce_str |
是 |
String(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
随机字符串,不长于32位。推荐随机数生成算法 |
签名 |
sign |
是 |
String(32) |
C380BEC2BFD727A4B6845133519F3AD6 |
签名,详见签名生成算法 |
微信订单号 |
transaction_id |
否 |
String(28) |
1217752501201407033233368018 |
微信订单号 |
商户订单号 |
out_trade_no |
是 |
String(32) |
1217752501201407033233368018 |
商户系统内部的订单号 |
商户退款单号 |
out_refund_no |
否 |
String(32) |
1217752501201407033233368018 |
商户退款单号 |
微信退款单号 |
refund_id |
否 |
String(28) |
1217752501201407033233368018 |
微信退款单号 refund_id、out_refund_no、out_trade_no、transaction_id四个参数必填一个,如果同时存在优先级为: refund_id>out_refund_no>transaction_id>out_trade_no |
返回数据
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回状态码 |
return_code |
是 |
String(16) |
SUCCESS |
SUCCESS/FAIL |
返回信息 |
return_msg |
否 |
String(128) |
签名失败 |
返回信息,如非空,为错误原因 签名失败 参数格式校验错误 |
以下字段在return_code为SUCCESS的时候有返回
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
业务结果 |
result_code |
是 |
String(16) |
SUCCESS |
SUCCESS/FAIL SUCCESS退款申请接收成功,结果通过退款查询接口查询 FAIL |
错误码 |
err_code |
是 |
String(32) |
SYSTEMERROR |
错误码详见第6节 |
错误描述 |
err_code_des |
是 |
String(32) |
系统错误 |
结果信息描述 |
公众账号ID |
appid |
否 |
String(32) |
wx8888888888888888 |
微信分配的公众账号ID |
商户号 |
mch_id |
是 |
String(32) |
1900000109 |
微信支付分配的商户号 |
设备号 |
device_info |
是 |
String(32) |
013467007045764 |
微信支付分配的终端设备号,与下单一致 |
随机字符串 |
nonce_str |
是 |
String(28) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
随机字符串,不长于32位 |
签名 |
sign |
是 |
String(32) |
C380BEC2BFD727A4B6845133519F3AD6 |
签名,详见签名算法 |
微信订单号 |
transaction_id |
是 |
String(32) |
1217752501201407033233368018 |
微信订单号 |
商户订单号 |
out_trade_no |
是 |
String(32) |
1217752501201407033233368018 |
商户系统内部的订单号 |
订单总金额 |
total_fee |
是 |
Int |
100 |
订单总金额,单位为分,只能为整数,详见支付金额 |
订单金额货币种类 |
fee_type |
否 |
String(8) |
CNY |
订单金额货币类型,符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型 |
现金支付金额 |
cash_fee |
是 |
Int |
100 |
现金支付金额,单位为分,只能为整数,详见支付金额 |
货币种类 |
cash_fee_type |
否 |
String(8) |
CNY |
货币类型,符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型 |
退款金额 |
refund_fee |
是 |
Int |
100 |
退款总金额,单位为分,可以做部分退款 |
代金券或立减优惠退款金额 |
coupon_refund_fee |
否 |
Int |
100 |
代金券或立减优惠退款金额=订单金额-现金退款金额,注意:满立减金额不会退回 |
退款笔数 |
refund_count |
是 |
Int |
1 |
退款记录数 |
商户退款单号 |
out_refund_no_$n |
是 |
String(32) |
1217752501201407033233368018 |
商户退款单号 |
微信退款单号 |
refund_id_$n |
是 |
String(28) |
1217752501201407033233368018 |
微信退款单号 |
退款渠道 |
refund_channel_$n |
否 |
String(16) |
ORIGINAL |
ORIGINAL—原路退款 BALANCE—退回到余额 |
退款金额 |
refund_fee_$n |
是 |
Int |
100 |
退款总金额,单位为分,可以做部分退款 |
货币种类 |
fee_type_$n |
否 |
String(8) |
CNY |
货币类型,符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型 |
代金券或立减优惠退款金额 |
coupon_refund_fee_$n |
否 |
Int |
100 |
代金券或立减优惠退款金额<=退款金额,退款金额-代金券或立减优惠退款金额为现金,说明详见代金券或立减优惠 |
代金券或立减优惠使用数量 |
coupon_refund_count_$n |
否 |
Int |
1 |
代金券或立减优惠使用数量 ,$n为下标,从1开始编号 |
代金券或立减优惠批次ID |
coupon_refund_batch_id_$n_$m |
否 |
String(20) |
100 |
批次ID ,$n为下标,$m为下标,从1开始编号 |
代金券或立减优惠ID |
coupon_refund_id_$n_$m |
否 |
String(20) |
10000 |
代金券或立减优惠ID, $n为下标,$m为下标,从1开始编号 |
单个代金券或立减优惠支付金额 |
coupon_refund_fee_$n_$m |
否 |
Int |
100 |
单个代金券或立减优惠支付金额, $n为下标,$m为下标,从1开始编号 |
退款状态 |
refund_status_$n |
是 |
String(16) |
SUCCESS |
退款状态: SUCCESS—退款成功 FAIL—退款失败 PROCESSING—退款处理中 NOTSURE—未确定,需要商户原退款单号重新发起 CHANGE—转入代发,退款到银行发现用户的卡作废或者冻结了,导致原路退款银行卡失败,资金回流到商户的现金帐号,需要商户人工干预,通过线下或者财付通转账的方式进行退款。 |
后台代码:

/// <summary>
/// 查询退款
/// </summary>
/// <param name="trade"></param>
/// <returns></returns>
public JsonResult RefundQuery(TRADE_Model trade)
{
string nonceStr = Senparc.Weixin.MP.TenPayLibV3.TenPayV3Util.GetNoncestr(); Senparc.Weixin.MP.TenPayLibV3.RequestHandler packageReqHandler = new Senparc.Weixin.MP.TenPayLibV3.RequestHandler(null); packageReqHandler.SetKey(Key); packageReqHandler.SetParameter("appid", AppId);
packageReqHandler.SetParameter("mch_id", MchId);
packageReqHandler.SetParameter("nonce_str", nonceStr);
//packageReqHandler.SetParameter("transaction_id", "");//微信订单号
packageReqHandler.SetParameter("out_trade_no", trade.TRADE_NO);//商户系统内部的订单号
//packageReqHandler.SetParameter("out_refund_no", "");//商户退款单号
//packageReqHandler.SetParameter("refund_id", "");//微信退款单号
//注意:refund_id、out_refund_no、out_trade_no、transaction_id四个参数必填一个,如果同时存在优先级为:refund_id>out_refund_no>transaction_id>out_trade_no string querysign = packageReqHandler.CreateMd5Sign("key", Key); packageReqHandler.SetParameter("sign", querysign); //签名 string data = packageReqHandler.ParseXML(); var result = Senparc.Weixin.MP.AdvancedAPIs.TenPayV3.RefundQuery(data);
var res = System.Xml.Linq.XDocument.Parse(result); string return_code = res.Element("xml").Element("return_code").Value; Hashtable hashtable = new Hashtable(); return Json(hashtable);
}

微信支付-JSAPI支付V3-查询退款的更多相关文章
- ThinkPHP中实现微信支付(jsapi支付)流程
https://blog.csdn.net/sinat_35861727/article/details/72783988 之前写过一篇文章讲了 PHP实现微信支付(jsapi支付)流程 ,详见文章: ...
- 微信支付JSAPI支付
1.介绍 JSAPI支付是用户在微信中打开商户的H5页面,商户在H5页面通过调用微信支付提供的JSAPI接口调起微信支付模块完成支付.应用场景有: ◆ 用户在微信公众账号内进入商家公众号,打开某 ...
- 微信h5支付/jsapi支付/小程序支付
一. 介绍------------------------------------------------------------------ 微信支付官方开发文档: https://pay.wei ...
- C# 微支付 JSAPI支付方式 V3.3.6版本
<script type="text/javascript">//结算 (订单号) function PayClearing(num) { $.ajax({ type: ...
- 微信支付(JsApi)
这两天有个小项目用的微信网页jsapi支付 用的thinkphp框架开发 ,首次做微信支付 碰了很多壁,做了简单就记录,方便回顾 也希望对大家能有点帮助,也希望路过的大神批评指正.. 一.必备条件及相 ...
- 微信JSApi支付~集成到MVC环境后的最后一个坑(网上没有这种解决方案)
返回目录 大叔第一人 之前写了关于微信的坑<微信JSApi支付~坑和如何填坑>,今天将微信的jsapi支付封装到了MVC环境里,当然也出现了一些新的坑,如支付参数应该是Json对象而不是J ...
- asp.net微信jsapi支付
1.前台页面: <!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"><head ru ...
- 微信公众号配置及微信jsAPI支付
公众号配置 一.基本配置 首先登陆微信公众平台,在开发--->配置--->公众号开发信息,获取到AppId,开发者秘钥是后台需要的,给到后台,IP白名单配置就是你服务器的IP地址写到里面就 ...
- 【weixi】微信支付---微信公众号JSAPI支付
一.JSAPI支付 JSAPI支付是用户在微信中打开商户的H5页面,商户在H5页面通过调用微信支付提供的JSAPI接口调起微信支付模块完成支付.应用场景有: ◆ 用户在微信公众账号内进入商家公众号,打 ...
随机推荐
- [C#] 區分 abstract、virtual、override 和 new
abstract.virtual.override和new是在類別的繼承關係中常用的四個修飾方法的關鍵字,在此略作總結. 1. 常用的中文名稱: n abstract => 抽象方法. n ...
- SpringMVC学习总结(七)——SpringMVC注解@..详解
<context:component-scan/> 扫描指定的包中的类上的注解,常用的注解有: @Controller 声明Action组件@Service 声明Service组件 ...
- Linux软链接和硬链接
Linux中的链接有两种方式,软链接和硬链接.本文试图清晰彻底的解释Linux中软链接和硬链接文件的区别. 1.Linux链接文件 1)软链接文件 软链接又叫符号链接,这个文件包含了另一个文件的路径 ...
- iOS复杂动画之抽丝剥茧(Objective-C & Swift)
一.前言 随着开发者的增多和时间的累积,AppStore已经有非常多的应用了,每年都有很多新的APP产生.但是我们手机上留存的应用有限,所以如何吸引用户,成为产品设计的一项重要内容.其中炫酷的动画效果 ...
- Java-马士兵设计模式学习笔记-责任链模式-模拟处理Reques Response
一.目标 1.用Filter模拟处理Request.Response 2.思路细节技巧: (1)Filter的doFilter方法改为doFilter(Request,Resopnse,FilterC ...
- uchome 积分体系
一.总体流程 1):管理员在后台修改积分规则2):数据被写入数据表creditrule 中,并将数据写入缓存文件data/data_creditrule.php 中3):用户发表文章或者进行其他操作的 ...
- [iOS]iPhone推送原理
推送原理,先上图 说一下原理吧, 由App向iOS设备发送一个注册通知 iOS向APNs远程推送服务器发送App的Bundle Id和设备的UDID APNs根据设备的UDID和App的Bundle ...
- mfc Clistctr 单元格嵌入图片(bmp)
示例:http://download.csdn.net/detail/zahxz/4652543 代码: CListCtrl mCtrlist;//列表控件 CImageList m_ImageLis ...
- 《Linux shell变量总结回顾》RHEL6(转)
文章版权:http://www.cnblogs.com/linux-super-meng/ 环境变量路径: [root@localhost ~]# set //查看到的是局部变量和全局变量2种 [ ...
- json 得到时分秒为00:00:00,拿不到时分秒 解决办法
数据库查询时间没有了时分秒的解决办法 问题出处,公司一个项目中使用动态sql方式查询Oracle数据库,在展示时Date类型字段只展示日期,无时分秒. 分析: ...