通知退款结果
本章主要介绍通知退款结果接口，当退款成功后，翼辉支付平台会把退款结果通过 URL 回调的形式发送给商户，商户需要接收处理，并按文档规范返回应答。
接口描述
该链接通过 退款申请 接口中提交的参数 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，各字段含义如下：
|
| 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 | 业务状态代码，取值如下：
|
| 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，各字段含义如下：
|
| refund_reason | String(100) | 否 | 库存不足 | 商户申请退款的原因 |
| refund_channel | String(10) | 是 | 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 | 处理状态，是否接收到异步通知，取值如下：
|
| message | String(10) | 成功 | 处理状态，若商户处理异步通知失败，将返回错误信息 |
响应示例
正确响应示例
{
"status": "SUCCESS",
"message": "成功"
}
错误响应示例
{
"status": "FAIL",
"message": "验签失败"
}
陕公网安备61019002002605号