登录
基础
连接微信
办公
企业内部开发 服务端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
}
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| mchid | string | 企业微信分配的商户号。示例值：1900000100 |
| out_trade_no | string | 返回的商户订单号。示例值： 1217752501201407033233368018 |
| out_refund_no | string | 商户退款单号。示例值： 1217752501201407033233368018 |
| refund_id | string | 微信退款单号。示例值： 1217752501201407033233368018 |
| refund_status | string | 退款状态，枚举值： SUCCESS：退款成功 CLOSED：退款关闭 ABNORMAL：退款异常，退款到银行发现用户的卡作废或者冻结了，导致原路退款银行卡失败 示例值：SUCCESS |
| success_time | string | 1、退款成功时间，遵循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_account | string | 取当前退款单的退款入账方。 1、退回银行卡：{银行名称}{卡类型}{卡尾号} 2、退回支付用户零钱: 支付用户零钱 3、退还商户: 商户基本账户、商户结算银行账户 4、退回支付用户零钱通：支付用户零钱通 示例值：招商银行信用卡0403 |
| amount | object | 金额信息，详见Amount。 |
Amount结构说明：
- 退款通知
本节内容
