Skip to main content
POST

概述

创建 Stripe Customer Portal 会话,用户可在此:
  • 更新支付方式
  • 查看账单历史
  • 更换订阅套餐
  • 下载发票
  • 取消订阅
需要 JWT 访问令牌(会话鉴权)。
**第三方集成:**请改用 POST /subscriptions/portal/api 并以 API Key 鉴权。

认证

string
必填
JWT 访问令牌。格式:Bearer YOUR_ACCESS_TOKEN

请求体

string
用户退出门户后的跳转 URL,默认返回应用控制台。

响应字段

string
用户需跳转到的 Stripe 托管账单门户 URL。

门户能力

Stripe Customer Portal 支持用户:

错误响应

错误请求——未找到账单账户,用户需先完成购买。
未授权——令牌无效或缺失。
账单门户仅对已发生过购买或拥有活跃订阅的用户可用;新用户请使用结账接口。

POST /subscriptions/portal/api

使用 API Key 创建 Stripe Customer Portal 会话,适合第三方集成。

认证

需要 API Key:

请求体

/subscriptions/portal 相同。

响应

/subscriptions/portal 相同。

最佳实践

  • 设置页入口:在应用设置中提供「管理账单」按钮
  • 结账后:订阅购买完成后可引导用户进入门户
  • 客服:将门户作为账单问题的自助渠道