通知支付结果
本章主要介绍通知支付结果接口，当用户支付成功后，翼辉支付平台会把支付结果通过数据流的形式发送给商户，商户需要接收处理，并按文档规范返回应答。
接口描述
该链接通过 统一下单 中提交的参数 notify_url 设置，如果链接无法访问，商户将无法接收到翼辉支付平台的通知。
notify_url 必须为直接可访问的 URL，请求方式为 POST，不允许 URL 传参，且必须是 HTTPS 地址。
示例：https://your.domain.com/path/to/pay/notify。
请求参数
| 字段名 | 类型 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|---|
| mch_no | String(32) | 是 | MCH1000000 | 翼辉支付平台分配的商户号 |
| 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，各字段含义如下：
|
| transaction_no | String(50) | 是 | 5a53ce6c3833446eb667286e2e7e9aa5 | 翼辉支付订单号，翼辉支付的订单唯一标志 |
| mch_trade_no | String(50) | 是 | mp202104021606341385640107521832 | 商户下单时使用的订单号，同一商户号下订单号唯一 |
| app_no | String(32) | 是 | APP1000000 | 支付应用号 |
| extra | String(100) | 否 | 购买游戏元宝 | 附加数据，在查询和通知支付结果的 API 中原样返回，该字段主要用于商户携带订单的自定义数据 |
| code | String(20) | 否 | SUCCESS | 业务状态代码 |
| description | String(200) | 否 | 成功 | 业务状态代码描述 |
| amount_total | String(9) | 是 | 21.00 | 订单支付总金额，单位为元，保留小数点后两位，最大值为 1000.00，最小值为 0.01 |
| success_time | String(32) | 是 | 2024-05-20T14:37:35+08:00 | 支付成功时间，格式为 YYYY-MM-DDTHH:mm:ss+TIMEZONE，各字段含义如下：
|
| amount_currency | String(10) | 是 | CNY | 支付金额币种，目前仅支持人民币：CNY，CNY 符合 ISO 4217 标准的三位字母代码 |
| acoid | String(30) | 否 | 1008 | 付款者的翼辉 ID |
| pay_channel | String(10) | 是 | WECHAT_PAY | 订单的支付渠道，取值如下：
|
| pay_method | String(20) | 是 | NATIVE | 订单的支付方式，取值如下：
|
请求示例
{
"mch_no":"MCH1000000",
"nonce":"5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
"sign":"C380BEC2BFD727A4B6845133519F3AD6",
"sign_type":"SHA256withRSA",
"notify_time":"2024-05-20T14:37:35+08:00",
"transaction_no":"5a53ce6c3833446eb667286e2e7e9aa5",
"mch_trade_no":"mp202104021606341385640107521832",
"app_no":"APP1000000",
"extra":"购买游戏元宝",
"code":"SUCCESS",
"description":"成功",
"amount_total":"21.00",
"success_time":"2024-05-20T14:37:35+08:00",
"amount_currency":"CNY",
"acoid":"1008",
"pay_channel": "WECHAT_PAY",
"pay_method": "NATIVE"
}
响应参数
| 字段名 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| status | String(10) | SUCCESS | 返回状态码，表示是否接收到异步通知，取值如下：
|
| message | String(10) | 成功 | 商户处理异步通知失败时，返回错误信息 |
响应示例
正确响应示例
{
"status": "SUCCESS",
"message": "成功"
}
错误响应示例
{
"status": "FAIL",
"message": "验签失败"
}
陕公网安备61019002002605号