1. 浏览器订阅支付返回
opensosen
  • NewAPI - 全量后端接口包
    • 外部 API：Midjourney
      • 读取 /{mode}/mj/image/{id} 接口
      • 提交 /{mode}/mj/insight-face/swap 接口
      • 提交 /{mode}/mj/submit/action 接口
      • 提交 /{mode}/mj/submit/blend 接口
      • 提交 /{mode}/mj/submit/change 接口
      • 提交 /{mode}/mj/submit/describe 接口
      • 提交 /{mode}/mj/submit/edits 接口
      • 提交 /{mode}/mj/submit/imagine 接口
      • 提交 /{mode}/mj/submit/modal 接口
      • 提交 /{mode}/mj/submit/shorten 接口
      • 提交 /{mode}/mj/submit/simple-change 接口
      • 提交 /{mode}/mj/submit/upload-discord-images 接口
      • 提交 /{mode}/mj/submit/video 接口
      • 读取 /{mode}/mj/task/{id}/fetch 接口
      • 读取 /{mode}/mj/task/{id}/image-seed 接口
      • 提交 /{mode}/mj/task/list-by-condition 接口
      • 读取 /mj/image/{id} 接口
      • 提交 /mj/insight-face/swap 接口
      • 提交 /mj/submit/action 接口
      • 提交 /mj/submit/blend 接口
      • 提交 /mj/submit/change 接口
      • 提交 /mj/submit/describe 接口
      • 提交 /mj/submit/edits 接口
      • 提交 /mj/submit/imagine 接口
      • 提交 /mj/submit/modal 接口
      • 提交 /mj/submit/shorten 接口
      • 提交 /mj/submit/simple-change 接口
      • 提交 /mj/submit/upload-discord-images 接口
      • 提交 /mj/submit/video 接口
      • 读取 /mj/task/{id}/fetch 接口
      • 读取 /mj/task/{id}/image-seed 接口
      • 提交 /mj/task/list-by-condition 接口
    • 公共内容与首次安装
      • 读取站点关于页面内容
      • 读取首页内容配置
      • 读取公开或当前用户可见的定价目录
      • 读取隐私政策正文
      • 读取 /api/rankings 接口
      • 读取首次安装状态
      • 完成首次安装并可创建 Root 用户
      • 读取用户协议正文
    • 管理员用户、权限与预填组
      • 读取 /api/authz/catalog 接口
      • 读取系统可配置分组名称
      • 读取预填组列表
      • 新建预填组
      • 完整更新预填组
      • 删除预填组
      • 分页读取管理员用户列表
      • 管理员新建用户
      • 管理员更新用户资料与权限
      • 硬删除管理员用户
      • 读取管理员用户详情与细粒度权限
      • 管理员强制禁用目标用户 2FA
      • 管理员清除目标用户的内建身份绑定
      • 管理员读取目标用户的自定义 OAuth 绑定
      • 管理员解除目标用户的自定义 OAuth 绑定
      • 管理员重置目标用户 Passkey
      • 读取全站 2FA 覆盖率
      • 获取用户分组列表
      • 管理员执行用户状态、角色或额度操作
      • 搜索管理员用户列表
    • 管理员渠道：基础管理
      • 分页读取渠道列表
      • 创建一个或批量创建渠道
      • 更新渠道配置
      • 删除一个渠道
      • 读取单个渠道详情
      • 更新单个渠道状态
      • 批量删除渠道
      • 批量设置渠道标签
      • 复制渠道
      • 删除全部非启用渠道
      • 读取所有启用渠道的模型名
      • 搜索渠道
      • 批量更新渠道状态
      • 按标签批量编辑渠道配置
      • 按标签禁用渠道
      • 按标签启用渠道
      • 读取标签下模型 CSV 模板
    • 管理员渠道：运维、密钥与 Codex
      • 提交 /api/channel/{id}/codex/refresh 接口
      • 读取 /api/channel/{id}/codex/usage 接口
      • 提交 /api/channel/{id}/codex/usage/reset 接口
      • 读取 /api/channel/{id}/codex/usage/reset-credits 接口
      • 一次性读取渠道明文密钥
      • 查询或管理多密钥渠道中的密钥
      • 读取渠道运维全局设置
      • 创建全渠道测试后台任务
      • 测试单个渠道
      • 刷新全部启用渠道余额
      • 刷新单个渠道余额
    • 管理员渠道：上游模型同步
      • 按候选配置拉取上游模型
      • 使用已保存渠道拉取上游模型
      • 修复渠道能力索引
      • 读取本地渠道模型目录
      • 应用单个渠道的上游模型差异
      • 批量应用全部渠道待处理上游模型差异
      • 检测单个渠道的上游模型差异
      • 创建全渠道上游模型差异检测任务
    • 管理员渠道：Ollama 模型操作
      • 删除 /api/channel/ollama/delete 接口
      • 提交 /api/channel/ollama/pull 接口
      • 提交 /api/channel/ollama/pull/stream 接口
      • 读取 /api/channel/ollama/version/{id} 接口
    • 支付 Provider 服务端回调
      • Creem Webhook
      • Stripe Webhook
      • 接收 Epay 订阅支付服务端回调
      • 接收 Epay 订阅支付服务端回调
      • 接收 Epay 用户充值服务端回调
      • 接收 Epay 用户充值服务端回调
      • 提交 /api/waffo-pancake/webhook/{env} 接口
      • 提交 /api/waffo/webhook 接口
    • Root 自定义 OAuth Provider
      • 读取 /api/custom-oauth-provider/ 接口
      • 提交 /api/custom-oauth-provider/ 接口
      • 删除 /api/custom-oauth-provider/{id} 接口
      • 读取 /api/custom-oauth-provider/{id} 接口
      • 更新 /api/custom-oauth-provider/{id} 接口
      • 提交 /api/custom-oauth-provider/discovery 接口
    • 仪表盘与用量分析
      • 管理员读取按模型和小时聚合的额度趋势
      • 读取按分组和模型聚合的用量流
      • 读取当前用户按分组和模型聚合的用量流
      • 读取当前用户按模型和小时聚合的额度趋势
      • 管理员读取按用户和小时聚合的额度趋势
      • 读取仪表盘可用模型的渠道映射
      • 获取Uptime Kuma状态
    • 管理员模型部署
      • 读取 /api/deployments/ 接口
      • 提交 /api/deployments/ 接口
      • 删除 /api/deployments/{id} 接口
      • 读取 /api/deployments/{id} 接口
      • 更新 /api/deployments/{id} 接口
      • 读取 /api/deployments/{id}/containers 接口
      • 读取 /api/deployments/{id}/containers/{container_id} 接口
      • 提交 /api/deployments/{id}/extend 接口
      • 读取 /api/deployments/{id}/logs 接口
      • 更新 /api/deployments/{id}/name 接口
      • 读取 /api/deployments/available-replicas 接口
      • 读取 /api/deployments/check-name 接口
      • 读取 /api/deployments/hardware-types 接口
      • 读取 /api/deployments/locations 接口
      • 提交 /api/deployments/price-estimation 接口
      • 读取 /api/deployments/search 接口
      • 读取 /api/deployments/settings 接口
      • 提交 /api/deployments/settings/test-connection 接口
      • 提交 /api/deployments/test-connection 接口
    • 使用日志、Midjourney 与任务历史
      • 管理员分页读取全站使用日志
      • 已废弃：搜索全站日志
      • 分页读取当前用户使用日志
      • 已废弃：搜索当前用户日志
      • 读取当前用户日志统计
      • 管理员读取全站日志统计
      • 管理员分页读取 Midjourney 任务历史
      • 分页读取当前用户 Midjourney 任务历史
      • 管理员分页读取异步任务历史
      • 分页读取当前用户异步任务历史
    • Root 运行状态、性能与系统任务
      • 读取 /api/log/channel_affinity_usage_cache 接口
      • 读取 /api/perf-metrics 接口
      • 读取 /api/perf-metrics/summary 接口
      • 删除 /api/performance/disk_cache 接口
      • 提交 /api/performance/gc 接口
      • 删除 /api/performance/logs 接口
      • 读取 /api/performance/logs 接口
      • 提交 /api/performance/reset_stats 接口
      • 读取 /api/performance/stats 接口
      • 测试系统状态
      • 读取 /api/system-info/instances 接口
      • 删除 /api/system-info/instances/{node_name} 接口
      • 删除 /api/system-info/stale-instances 接口
      • 读取 /api/system-task/{task_id} 接口
      • 读取 /api/system-task/current 接口
      • 读取 /api/system-task/list 接口
      • 创建日志清理任务
    • API Key 与 Key 自助用量
      • 读取当前认证 API Key 的最近日志
      • 分页读取当前用户 API Key
      • 创建当前用户 API Key
      • 更新当前用户 API Key
      • 删除当前用户 API Key
      • 读取当前用户单个 API Key 详情
      • 一次性读取当前用户 API Key 明文
      • 读取当前用户可选的 API Key 自动分组
      • 批量删除当前用户 API Key
      • 一次性批量读取当前用户 API Key 明文
      • 搜索当前用户 API Key
      • 查询当前 Relay API Key 的兼容用量
    • 管理员模型与厂商目录
      • 分页读取模型元数据目录
      • 新建模型元数据
      • 更新模型元数据或仅更新状态
      • 删除模型元数据
      • 读取单个模型元数据
      • 读取缺失的模型元数据名称
      • 搜索模型元数据目录
      • 执行官方模型目录同步
      • 预览官方模型目录同步差异
      • 分页读取厂商目录
      • 新建厂商元数据
      • 完整更新厂商元数据
      • 删除厂商元数据
      • 读取单个厂商元数据
      • 搜索厂商目录
    • 全局公告
      • 读取全局公告正文
    • 浏览器 OAuth 与登录回调
      • 读取 /api/oauth/{provider} 接口
      • 完成 Telegram 绑定
      • Telegram登录
      • 微信OAuth登录
    • 个人资料与安全中心
      • 绑定当前用户邮箱
      • 开始 Telegram 账号绑定流程
      • 绑定当前用户微信账号
      • 重新生成 2FA 备用码
      • 禁用 2FA
      • 确认并启用已初始化的 2FA
      • 初始化 2FA 登记材料
      • 读取当前用户 2FA 状态
      • 读取当前用户自定义 OAuth 绑定
      • 解绑当前用户自定义 OAuth Provider
      • 解绑当前用户 Passkey
      • 读取当前用户 Passkey 状态
      • 开始 Passkey 注册
      • 完成 Passkey 注册
      • 开始 Passkey 安全验证
      • 完成 Passkey 安全验证并签发 proof
      • 注销当前用户账号
      • 读取当前用户安全资料
      • 更新当前用户资料、语言、侧边栏或密码
      • 读取当前用户可用分组
      • 列出当前用户设备会话
      • 撤销指定设备会话
      • 撤销除当前会话外的所有设备会话
      • 更新当前用户通知与日志设置
      • 轮换 Dashboard 管理个人访问令牌
      • 用 2FA 签发短期安全证明
    • 登录、注册与会话
      • 创建 OAuth 绑定或登录流程
      • 发送密码重置邮件
      • 读取公开系统状态和功能开关
      • 退出当前 Dashboard 会话
      • 使用 HttpOnly Cookie 刷新 Dashboard access token
      • 密码登录并建立会话
      • 完成密码登录的 2FA 验证
      • 开始 Passkey 登录
      • 完成 Passkey 登录
      • 注册本地账号
      • 用邮件重置令牌生成一次性新密码
      • 发送邮箱验证码
    • Root 系统选项与支付配置
      • 读取 Root 可见的系统选项
      • 更新单项 Root 系统选项
      • 删除 /api/option/channel_affinity_cache 接口
      • 读取 /api/option/channel_affinity_cache 接口
      • 提交 /api/option/payment_compliance 接口
      • 读取 Waffo Pancake Store 与可绑定产品目录
      • 临时创建 Waffo Pancake Store 与钱包充值产品
      • 原子保存 Waffo Pancake 钱包充值配置
      • 创建订阅计划可绑定的 Waffo Pancake 产品
      • 读取已保存 Store 的订阅计划产品选项
    • 管理员定价与倍率同步
      • 重置默认模型倍率
      • 读取公开倍率配置
      • 读取可用于倍率同步的渠道与预设
      • 获取上游倍率并计算差异
    • 管理员兑换码
      • 分页读取兑换码
      • 批量创建兑换码
      • 更新兑换码业务字段或状态
      • 删除单个兑换码
      • 读取单个兑换码
      • 批量删除无效兑换码
      • 搜索兑换码
    • 订阅计划与用户订阅
      • 提交 /api/subscription/admin/bind 接口
      • 读取 /api/subscription/admin/plans 接口
      • 提交 /api/subscription/admin/plans 接口
      • 部分更新 /api/subscription/admin/plans/{id} 接口
      • 更新 /api/subscription/admin/plans/{id} 接口
      • 提交 /api/subscription/admin/plans/{id}/subscriptions/reset 接口
      • 删除 /api/subscription/admin/user_subscriptions/{id} 接口
      • 提交 /api/subscription/admin/user_subscriptions/{id}/invalidate 接口
      • 读取 /api/subscription/admin/users/{id}/subscriptions 接口
      • 提交 /api/subscription/admin/users/{id}/subscriptions 接口
      • 提交 /api/subscription/admin/users/{id}/subscriptions/reset 接口
      • 提交 /api/subscription/balance/pay 接口
      • 提交 /api/subscription/creem/pay 接口
      • 提交 /api/subscription/epay/pay 接口
      • 读取 /api/subscription/plans 接口
      • 读取 /api/subscription/self 接口
      • 更新 /api/subscription/self/preference 接口
      • 提交 /api/subscription/stripe/pay 接口
      • 提交 /api/subscription/waffo-pancake/pay 接口
    • 浏览器订阅支付返回
      • 处理 Epay 订阅支付后的浏览器返回
        GET
      • 处理 Epay 订阅支付后的浏览器返回
        POST
    • 钱包、充值与推广
      • 读取或首次生成当前用户推广码
      • 把当前用户推广额度转入可用额度
      • 计算易支付充值金额
      • 读取 /api/user/checkin 接口
      • 提交 /api/user/checkin 接口
      • 创建 Creem Checkout 充值订单
      • 创建易支付充值订单并获取跳转参数
      • 计算 Stripe 充值金额
      • 创建 Stripe Checkout 充值订单
      • 获取所有充值记录
      • 提交 /api/user/topup 接口
      • 管理员完成充值
      • 读取当前用户钱包可用的充值配置
      • 分页读取当前用户最近充值订单
      • 提交 /api/user/waffo-pancake/amount 接口
      • 提交 /api/user/waffo-pancake/pay 接口
      • 提交 /api/user/waffo/amount 接口
      • 提交 /api/user/waffo/pay 接口
    • 在线 Playground
      • 读取当前用户指定可用分组的模型名
      • 提交 /pg/chat/completions 接口
    • 外部 API：兼容计费查询
      • 读取 /dashboard/billing/subscription 接口
      • 读取 /dashboard/billing/usage 接口
      • 读取 /v1/dashboard/billing/subscription 接口
      • 读取 /v1/dashboard/billing/usage 接口
    • 外部 API：视频生成任务
      • 即梦视频生成
      • Kling 图生视频
      • 获取 Kling 图生视频任务状态
      • Kling 文生视频
      • 获取 Kling 文生视频任务状态
      • 创建视频生成任务
      • 获取视频生成任务状态
      • 创建视频
      • 获取视频任务状态
      • 获取视频内容
      • 提交 /v1/videos/{video_id}/remix 接口
    • 外部 API：Suno 音乐任务
      • 提交 /suno/fetch 接口
      • 读取 /suno/fetch/{id} 接口
      • 提交 /suno/submit/{action} 接口
    • 外部 API：OpenAI 文本与 Responses
      • 提交 /v1/alpha/search 接口
      • 创建聊天对话
      • 创建文本补全
      • 内容审核
      • 创建响应 (OpenAI Responses API)
      • 压缩对话 (OpenAI Responses API)
    • 外部 API：OpenAI 图像与音频
      • 文本转语音
      • 音频转录
      • 音频翻译
      • 提交 /v1/edits 接口
      • 编辑图像(qwen-image-edit)
      • 生成图像(qwen-image)
    • 外部 API：OpenAI 模型与嵌入
      • 创建文本嵌入
      • Gemini 嵌入(Embeddings)
      • 获取模型列表
      • 读取 /v1/models/{model} 接口
    • 外部 API：已注册但未实现
      • 列出文件 (未实现)
      • 上传文件 (未实现)
      • 删除文件 (未实现)
      • 获取文件信息 (未实现)
      • 获取文件内容 (未实现)
      • 列出微调任务 (未实现)
      • 创建微调任务 (未实现)
      • 获取微调任务详情 (未实现)
      • 取消微调任务 (未实现)
      • 获取微调任务事件 (未实现)
      • 提交 /v1/images/variations 接口
      • 删除 /v1/models/{model} 接口
    • 外部 API：Anthropic Messages
      • Claude 聊天
    • 外部 API：Gemini
      • 提交 /v1/models/{path} 接口
      • Gemini 格式获取
      • 提交 /v1beta/models/{path} 接口
      • 读取 /v1beta/openai/models 接口
    • 外部 API：Realtime 与 Rerank
      • 实时 WebSocket 连接
      • 文档重排序
    • 数据模型
      • ApiResponse
      • AuthSessionIssuanceError
      • PageInfo
      • Log
      • User
      • Channel
      • Token
      • Redemption
      • ErrorResponse
      • Usage
      • Model
      • ModelsResponse
      • GeminiModelsResponse
      • Message
      • MessageContent
      • ToolCall
      • Tool
      • ResponseFormat
      • ChatCompletionRequest
      • ChatCompletionResponse
      • ChatCompletionStreamResponse
      • CompletionRequest
      • CompletionResponse
      • ResponsesRequest
      • ResponsesResponse
      • ResponsesCompactionResponse
      • ResponsesCompactionRequest
      • ResponsesStreamResponse
      • ClaudeRequest
      • ClaudeMessage
      • ClaudeResponse
      • EmbeddingRequest
      • EmbeddingResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • ImageResponse
      • AudioTranscriptionRequest
      • AudioTranslationRequest
      • AudioTranscriptionResponse
      • SpeechRequest
      • RerankRequest
      • RerankResponse
      • ModerationRequest
      • ModerationResponse
      • GeminiRequest
      • GeminiResponse
      • VideoRequest
      • VideoResponse
      • VideoTaskResponse
      • VideoTaskMetadata
      • VideoTaskError
      • OpenAIVideo
      • OpenAIVideoError
      • DashboardApiEnvelope
      • DashboardAuthError
      • OpenAIErrorEnvelope
      • UnknownJsonObject
  1. 浏览器订阅支付返回

处理 Epay 订阅支付后的浏览器返回

GET
/api/subscription/epay/return

本地契约说明#

路由：GET /api/subscription/epay/return
注册处理器：github.com/QuantumNous/new-api/controller.SubscriptionEpayReturn。
消费方：browser_callback。
鉴权：浏览器支付返回。路由没有 Dashboard 登录要求，但只应由 Epay 支付页面重定向访问。后端仍用已配置商户密钥验证回调签名；前端不得把 URL 参数当作支付成功凭据。
字段状态：controller-confirmed-epay-subscription-browser-return。字段为动态上游数据或回调负载时，文档会明确标记，不能补造 Schema。
页面/功能：Epay 订阅支付页完成后将浏览器带回此路径。后端验签并尝试完成订阅订单后，以 302 导向钱包页；该回调不是 Vue 通过 axios 调用的接口。
前端传参：无。该请求只允许 Epay Provider 按其签名回调协议发送；Vue 页面、浏览器脚本、管理台调试工具都不得构造或重放。GET 由 Provider 放入 query，POST 由 Provider 用 application/x-www-form-urlencoded 放入请求体。
前端展示：钱包页只读取 pay=success、pay=pending 或 pay=fail 来呈现提示并按既有查询接口刷新状态。pay 是用户体验提示，不是前端可用来确认订单安全性的凭据。
调试：使用本操作的 x-debug 里的占位符；示例不含真实密码、API Key、签名、Cookie 或 Provider 密钥。

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'http://api-dev.opensosen.cn/api/subscription/epay/return?pid=%3Credacted-epay-partner-id%3E&trade_no=%3Credacted-epay-provider-trade-no%3E&out_trade_no=SUBUSR42NO%3Credacted-order-suffix%3E&type=alipay&name=SUB%3Adebug-plan&money=9.99&trade_status=TRADE_SUCCESS&sign=%3Credacted-epay-signature%3E&sign_type=MD5&param=undefined'

返回响应

🔵302
浏览器重定向。Controller 在验签与订单完成后不会输出 JSON：成功完成跳转到 /wallet?pay=success；签名、配置、表单、订单处理失败跳转到 /wallet?pay=fail；验签通过但 trade_status 不是 TRADE_SUCCESS 时跳转到 /wallet?pay=pending。
Headers

该响应没有 Body
修改于 2026-08-14 17:19:51
上一页
提交 /api/subscription/waffo-pancake/pay 接口
下一页
处理 Epay 订阅支付后的浏览器返回
Built with