订阅与账单

管理 Alphio 订阅、查看发票、升降级套餐、跳转 Stripe Billing Portal。

入口路径：/account/subscribe（套餐管理）和 /account/billing（发票与支付记录）。

---

1. 套餐档位简介

Alphio 共 4 档 —— Free、Base、Pro、Elite，每档对应一套权益、Credits 配额和 Signals 访问范围。

完整权益矩阵见 /reference/subscription-tiers。

---

2. 升级 / 降级

套餐变更走 预览 → 确认 两步流程，先看清按比例换算的费用影响再下手。

1. 打开 /account/subscribe，选择目标套餐和计费周期。
2. Alphio 调用 previewPlanChange，展示：
   • Immediate charge（或退款）—— 本次按比例需要立即结算的金额
   • Next billing amount —— 生效后下一次扣款金额
   • Effective time —— 升级即时生效；降级在本周期结束后生效
3. 点确认。Alphio 调用 changeSubscriptionPlan 真正下发变更。

升级即时解锁新档位权益；降级则保留当前权益到周期结束，到期后下沉到低档。

---

3. 取消 / 暂停 / 恢复

• 取消（Cancel） —— /account/subscribe → "Cancel subscription"。订阅继续生效到当前付费周期结束（cancel_at_period_end），到期自动降到 Free。
• 反悔取消（Reactivate） —— 周期结束前可点 "Reactivate" 撤销取消，按当前套餐继续自动续费。仅 Stripe 支持；MoonPay 取消不可逆，只能重新订阅。
• 暂停（Pause） —— 暂时停止扣费和权益，之后可在同一页面恢复。
• 恢复（Resume） —— 重启已暂停订阅，下一周期重新扣费。

---

4. 支付方式

Alphio 支持 5 个支付服务商（PSP），各自有不同的区域覆盖和能力范围。

PSP	典型场景	备注
Stripe	大多数地区的卡支付	全功能（Billing Portal、Reactivate、Custom Credits 充值都依赖 Stripe）
Paddle	Stripe 不优先的地区，卡 / 本地支付替代方案	仅订阅
Apple IAP	iOS 内购	苹果托管，取消走 iOS 设置 → 订阅
Google IAP	Android 内购	Google Play 托管，取消走 Play Store → 订阅
MoonPay	加密货币支付	取消 不可逆，不支持 Reactivate，只能重新订阅

注意

各 PSP 在各区域的具体可用性正在最终确认。订阅页只展示当前区域可用的 PSP —— 以页面实际显示为准。

---

5. Stripe Billing Portal

应用内没有暴露的高级操作 —— 管理保存的卡、查看 Stripe 侧完整发票历史、修改税务信息 —— Alphio 通过一次性签名 URL 跳转到 Stripe Billing Portal。

打开 /account/billing，点击 "Manage payment methods"。Alphio 会基于当前 Stripe 订阅生成 portal session 并跳转到 Stripe 托管页面。修改完毕后会自动同步回 Alphio。

Portal 仅对 Stripe 订阅生效。Paddle / IAP / MoonPay 订阅请走各自平台（Paddle Dashboard、App Store / Play Store、MoonPay 确认邮件里的 manage_url）管理。

---

6. 发票

/account/billing 列出每一笔账单事件：

• 订阅续费
• 套餐变更及按比例调整
• Custom Credits 充值
• 退款

每行都有 Download PDF 按钮，调用 Alphio 的发票下载接口直接拉取文件。

---

7. Custom Credits

订阅周期外按需购买 Credits —— 入口在 Top-Up Credits 页 /top-up-credits。Custom Credits 落到 Recharge Credits，永不过期（扣减顺序见 /reference/credits-system）。

Custom Credits 的深度文档在 Phase 2 单独成页 —— 在此之前直接用 /top-up-credits 应用内入口。

注意

Custom Credits 仅限 Base / Pro / Elite 订阅用户购买。Free 用户会被付费墙拦回 /account/subscribe。