路由:POST /api/subscription/epay/notify
注册处理器:github.com/QuantumNous/new-api/controller.SubscriptionEpayNotify。
鉴权:Provider 签名。路由没有 Dashboard 登录或 relay API Key 鉴权。Epay 服务端使用已配置商户密钥计算 MD5 签名,后端再校验订单所属网关和状态;浏览器和管理台不得主动调用、构造或重放。
字段状态:controller-confirmed-epay-subscription-provider-callback。字段为动态上游数据或回调负载时,文档会明确标记,不能补造 Schema。
页面/功能:Epay 在订阅付款后通知后端完成 SubscriptionOrder 并创建用户订阅。该流程由 Provider 服务端触发,不是前端支付确认接口。
前端传参:无。该请求只允许 Epay Provider 按其签名回调协议发送;Vue 页面、浏览器脚本、管理台调试工具都不得构造或重放。GET 由 Provider 放入 query,POST 由 Provider 用 application/x-www-form-urlencoded 放入请求体。
前端展示:无直接页面响应。页面若需要刷新订阅状态,应调用既有订阅查询接口;不能根据 notify 的文本或浏览器 URL 假设订阅已完成。
调试:使用本操作的 x-debug 里的占位符;示例不含真实密码、API Key、签名、Cookie 或 Provider 密钥。