企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
小程序接入对外收款
回调通知
退款通知
退款通知
最后更新:2022/11/24

当用户退款成功后,企业微信会推送退款成功的通知到『对外收款』应用中配置的指令回调URL。按照概述中介绍的解密方法,可以得到回调的结构体。

退款成功回调结构体示例:

{
	"mchid": "1900000100",
	"out_trade_no": "20150806125346",
	"refund_id": "50200207182018070300011301001",
	"out_refund_no": "7752501201407033233368018",
	"refund_status": "SUCCESS",
	"success_time": "2018-06-08T10:34:56+08:00",
	"user_received_account": "招商银行信用卡0403",
	"amount": {
		"total": 999,
		"refund": 999,
		"payer_total": 999,
		"payer_refund": 999
	}
}

参数说明:

参数类型说明
mchidstring企业微信分配的商户号。示例值:1900000100
out_trade_nostring返回的商户订单号。示例值: 1217752501201407033233368018
out_refund_nostring商户退款单号。示例值: 1217752501201407033233368018
refund_idstring微信退款单号。示例值: 1217752501201407033233368018
refund_statusstring退款状态,枚举值:
SUCCESS:退款成功
CLOSED:退款关闭
ABNORMAL:退款异常,退款到银行发现用户的卡作废或者冻结了,导致原路退款银行卡失败
示例值:SUCCESS
success_timestring1、退款成功时间,遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
2、当退款状态为退款成功时返回此参数。
示例值:2018-06-08T10:34:56+08:00
user_received_accountstring取当前退款单的退款入账方。
1、退回银行卡:{银行名称}{卡类型}{卡尾号}
2、退回支付用户零钱: 支付用户零钱
3、退还商户: 商户基本账户、商户结算银行账户
4、退回支付用户零钱通:支付用户零钱通
示例值:招商银行信用卡0403
amountobject金额信息,详见Amount。

Amount结构说明:

参数类型说明
totalint订单总金额,单位为分,只能为整数,详见支付金额
示例值:999
refundint退款金额,币种的最小单位,只能为整数,不能超过原订单支付金额,如果有使用券,后台会按比例退。
示例值:999
payer_totalint用户实际支付金额,单位为分,只能为整数,详见支付金额
示例值:999
payer_refundint退款给用户的金额,不包含所有优惠券金额
示例值:999
上一篇支付通知
下一篇交易账单申请
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们