通知退款结果

更新时间：

2024-07-25

下载文档

通知退款结果

本章主要介绍通知退款结果接口，当退款成功后，翼辉支付平台会把退款结果通过 URL 回调的形式发送给商户，商户需要接收处理，并按文档规范返回应答。

注意：

同样的通知可能会多次发送给商户系统，商户必须能够正确处理重复的通知。
当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过先进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，避免函数重入造成的数据混乱。
后台通知交互时，如果翼辉支付平台收到商户的应答不符合规范或超时，平台会判定本次通知失败，重新发送通知，直到成功为止（在通知一直不成功的情况下，翼辉支付平台会发起多次通知，通知频率依次为 0 s、30 s、1 ms、5 ms、10 ms、1 h、6 h、6 h、6 h，在 20 小时内总计发送 9 次通知），但不保证通知最终一定能成功。
在退款状态不明或者没有收到翼辉支付结果通知的情况下，建议商户主动调用翼辉支付查询退款结果接口确认订单状态。
商户对于退款结果通知的内容一定要做签名验证，并校验返回的订单金额是否与商户侧的订单金额一致，防止数据泄漏导致出现“假通知”，造成资金损失。

接口描述

该链接通过退款申请接口中提交的参数 notify_url 设置，如果链接无法访问，商户将无法接收到翼辉支付平台的通知。

notify_url 必须为直接可访问的 URL，请求方式为 POST，不允许 URL 传参，且必须是 HTTPS 地址。

示例：https://your.domain.com/path/to/refund/notify

请求参数

字段名	类型	是否必填	示例值	说明
mch_no	String(32)	是	ea887713933c42a0bd7e657b06f279d3	翼辉支付平台分配的商户号
nonce	String(32)	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，长度不大于 32 位
sign	String(344)	是	C380BEC2BFD727A4B6845133519F3AD6	签名值，商户需要验证签名，详情请参见验证数字签名
sign_type	String(20)	是	SHA256withRSA	签名类型，目前支持 SHA256withRSA
notify_time	String(32)	是	2024-05-20T14:37:35+08:00	通知创建的时间，遵循 rfc3339 标准格式，格式为 YYYY-MM-DDTHH:mm:ss+TIMEZONE，各字段含义如下： YYYY-MM-DD：年月日 T：出现在字符串中，表示 time 元素的开头 HH:mm:ss：时分秒 TIMEZONE：时区（+08:00 表示东八区时间，领先 UTC 8 小时，即北京时间）
mch_trade_no	String(50)	是	mp202104021606341385640107521832	商户订单号
transaction_no	String(50)	是	4af336b1bd904c69ab2edb76af3a2a35	翼辉支付订单号
mch_refund_no	String(50)	是	mr202104061510448896486137426083	商户申请退款时使用的退款单号，同一商户号下唯一
refund_no	String(50)	是	AR202112151405438637829842922855012187	翼辉支付退款单号，翼辉支付退款订单的唯一标志
code	String(20)	是	SUCCESS	业务状态代码，取值如下： HANDLE：退款请求处理中 SUCCESS：退款成功 FAIL：退款失败
description	String(200)	是	退款成功	业务状态代码描述
refund_amount	String(9)	是	21.00	退款总金额，单位为元，保留小数点后两位
success_time	String(32)	是	2024-04-24T18:00:28+8:00	退款成功的时间，遵循 rfc3339 标准格式，格式为 YYYY-MM-DDTHH:mm:ss+TIMEZONE，各字段含义如下： YYYY-MM-DD：年月日 T：出现在字符串中，表示 time 元素的开头 HH:mm:ss：时分秒 TIMEZONE：时区（+08:00 表示东八区时间，领先 UTC 8 小时，即北京时间）
refund_reason	String(100)	否	库存不足	商户申请退款的原因
refund_channel	String(10)	是	WECHAT_PAY	订单的退款渠道，取值如下： ALI_PAY：支付宝 WECHAT_PAY：微信

请求示例

{
  "mch_no": "ea887713933c42a0bd7e657b06f279d3",
  "nonce": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6",
  "sign_type": "SHA256withRSA",
  "notify_time": "2024-05-20T14:37:35+08:00",
  "mch_trade_no": "mp202104021606341385640107521832",
  "transaction_no": "4af336b1bd904c69ab2edb76af3a2a35",
  "mch_refund_no": "mr202104061510448896486137426083",
  "refund_no": "AR202112151405438637829842922855012187",
  "code": "SUCCESS",
  "description": "退款成功",
  "refund_amount": "21.00",
  "success_time": "2024-04-24T18:00:28+8:00",
  "refund_reason": "库存不足",
  "refund_channel": "WECHAT_PAY"
}

响应参数

字段名	类型	示例值	说明
status	String(10)	SUCCESS	处理状态，是否接收到异步通知，取值如下： SUCCESS：成功接收 FAIL：不返回，继续尝试发送通知
message	String(10)	成功	处理状态，若商户处理异步通知失败，将返回错误信息

响应示例

正确响应示例

{
  "status": "SUCCESS",
  "message": "成功"
}

错误响应示例

{
  "status": "FAIL",
  "message": "验签失败"
}

查询退款结果

下载账单

文档内容是否对您有所帮助？

有帮助

没帮助

通知退款结果

# 通知退款结果

# 接口描述

# 请求参数

# 请求示例

# 响应参数

# 响应示例

# 正确响应示例

# 错误响应示例

通知退款结果

接口描述

请求参数

请求示例

响应参数

响应示例

正确响应示例

错误响应示例