主题
渠道回调入口
这些路径由支付渠道调用,使用渠道原生协议验签或解密,不使用商户 MD5 签名。商户业务系统应接收自己的 notifyUrl 通知,不直接调用这些路径模拟支付成功。
| 方法 | 路径 | 用途 |
|---|---|---|
| ANY | /api/pay/notify/ | 支付渠道通知 |
| ANY | /api/pay/notify/{ifCode}/ | 带平台支付单号的渠道通知 |
| POST | /api/refund/notify/ | 退款渠道通知 |
| POST | /api/refund/notify/{ifCode}/ | 带平台退款号的渠道通知 |
| POST | /api/channel/notify/alipayzft | 直付通非支付消息,由 msg_method 分发 |
| POST | /api/channel/notify/wxpaysft/withdraw/ | 微信收付通提现回调 |
| POST | /api/complaints/notify/ | 投诉通知 |
ifCode、业务单号、提现请求号和投诉 token 用于定位原交易或授权范围,再核对对应渠道签名。响应格式遵循渠道自身要求,不使用商户开放接口统一响应。
回调地址域名必须使用实际部署的外部可访问域名,通过管理端渠道配置及部署设置生成。不要在商户客户端拼接这些入口,也不要将这里的 token 与收银台 token 混用。