Skip to content

渠道回调入口 ​

这些路径由支付渠道调用,使用渠道原生协议验签或解密,不使用商户 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 混用。

接口行为以当前 payment 实现为准。示例商户号与密钥均为虚构。