支付
关闭订单
申请退款
退款回调
本文档使用 MrDoc 发布
-
+
首页
退款回调
# 微信退款通知回调 ## 接口概述 业务系统需提供一个回调接口,用于接收微信支付退款通知。 ## 接口信息 - **接口名称**: 微信退款通知回调接口 - **接口类型**: POST - **Content-Type**: application/json ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | notifyId | String | 是 | 通知ID,回调通知的唯一编号 | | createTime | String | 是 | 通知创建时间 | | eventType | String | 是 | 通知的类型,如REFUND.SUCCESS、REFUND.ABNORMAL、REFUND.CLOSED | | resourceType | String | 是 | 通知数据类型,退款成功通知为encrypt-resource | | summary | String | 是 | 回调摘要,微信支付对回调内容的摘要备注 | | spMchid | String | 是 | 服务商商户号,微信支付分配给电商平台的商户号 | | subMchid | String | 是 | 二级商户号,分账出资的电商平台二级商户 | | outTradeNo | String | 是 | 商户订单号,返回的商户订单号 | | transactionId | String | 是 | 微信订单号,微信支付订单号 | | outRefundNo | String | 是 | 商户退款单号,商户退款单号 | | refundId | String | 是 | 微信退款单号,微信退款单号 | | refundStatus | String | 是 | 退款状态,枚举值:SUCCESS/CLOSE/ABNORMAL | | successTime | String | 是 | 退款成功时间 | | userReceivedAccount | String | 是 | 退款入账账户,取当前退款单的退款入账方 | | total | Integer | 是 | 订单金额,订单总金额,单位为分 | | refund | Integer | 是 | 退款金额,单位为分 | | payerTotal | Integer | 是 | 用户支付金额,单位为分 | | payerRefund | Integer | 是 | 用户退款金额,退款给用户的金额 | ## 请求示例 ```json { "notifyId": "ebaf5d74-c394-530e-899c-170edc8804f0", "createTime": "2025-11-25 14:43:31", "eventType": "REFUND.SUCCESS", "resourceType": "encrypt-resource", "summary": "退款成功", "spMchid": "1636821877", "subMchid": "1657150077", "outTradeNo": "202511252xxxxx", "transactionId": "420000293520251125373xxxxxxx", "outRefundNo": "202511252xxxxx", "refundId": "5030260542202511252418xxxxxxx", "refundStatus": "SUCCESS", "successTime": "2025-11-25 14:43:31", "userReceivedAccount": "支付用户零钱", "total": 1, "refund": 1, "payerTotal": 1, "payerRefund": 1 } ``` ## 响应要求 - **成功响应**: HTTP状态码200,返回固定字符串"success" - **失败响应**: HTTP状态码500,返回错误信息
admin
2025年11月26日 10:28
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码