订阅
AM 为账户管理完整的 Stripe 订阅生命周期，让你专注于定价与访问控制，而不是处理 Webhook 细节。
你可以创建结账会话，让客户自助管理套餐，并保持账户访问状态与 Stripe 同步。
订阅流程
Endpoints
| Endpoint | 用途 |
|---|---|
POST /api/accounts/:account_id/subscriptions/stripe/checkout-session |
发起订阅结账 |
POST /api/accounts/:account_id/subscriptions/stripe/portal-session |
打开客户门户 |
POST /api/accounts/:account_id/subscriptions/stripe/checkout-session-sync |
将结账会话同步为订阅 |
POST /api/accounts/:account_id/subscriptions/sync |
从 Stripe 同步订阅 |
POST /api/accounts/:account_id/subscriptions/change |
变更套餐或价格 |
POST /api/accounts/:account_id/subscriptions/cancel |
取消订阅 |
GET /api/accounts/:account_id/subscriptions |
列出订阅 |
GET /api/accounts/:account_id/subscriptions/features |
列出当前启用功能 |
GET /api/accounts/:account_id/subscriptions/identity |
获取 Stripe 客户身份 |
POST /api/applications/:application_id/subscriptions/stripe/webhook |
Stripe Webhook 接收端点 |
Checkout Session
为新订阅创建 Stripe Checkout 会话：
// Request
{
price_id: "price_...",
success_url: "https://app.example.com/success",
cancel_url: "https://app.example.com/cancel"
}
// Response
{
url: "https://checkout.stripe.com/..."
}将用户重定向到返回的 URL。支付完成后，Stripe 会跳转到你的 success URL。
Customer Portal
允许客户自助管理：
- 更新支付方式
- 查看发票
- 取消订阅
- 变更套餐
// Request
{
return_url: "https://app.example.com/settings";
}
// Response
{
url: "https://billing.stripe.com/...";
}Subscription Identity
每个账户都有一个订阅身份，用于将账户映射到 Stripe 客户对象。该映射用于解析 Stripe Webhook 并同步计费状态。
Webhook 事件
AM 处理 Stripe Webhook，并在失败时自动重试：
| Event | 动作 |
|---|---|
checkout.session.completed |
关联客户并创建订阅 |
customer.subscription.* |
同步订阅数据 |
invoice.paid |
同步发票并更新访问权限 |
invoice.payment_failed |
更新访问宽限窗口 |