訂閱

訂閱

訂閱功能定義透過 Inbox Manager 代理程式路由公開的帳戶擁有者訂閱和計畫操作。 它為所有者提供了直接的計劃生命週期控制，同時保持嚴格的帳戶和角色檢查。

為什麼這很重要

此功能將擁有者訂閱操作整合到收件匣管理員 API 介面下，同時保留對不記名令牌聲明的嚴格帳戶和角色檢查。它公開結帳、入口網站、同步和規劃變更操作，而不需要客戶端重複訂閱編排邏輯。

核心流程

操作

營運	端點	目的
列出訂閱	GET /api/subscriptions	擷取所選令牌帳戶的訂閱
列出功能	GET /api/subscriptions/features	檢索有效訂閱功能集
取得訂閱身分	GET /api/subscriptions/identity	取得帳號訂閱身分綁定
商家清單	GET /api/subscriptions/merchants	檢索商家/提供者選項
同步訂閱	POST /api/subscriptions/sync	從提供者刷新訂閱狀態
更改訂閱	POST /api/subscriptions/:subscription_id/change	修改計畫或間隔
取消訂閱	POST /api/subscriptions/:subscription_id/cancel	結束訂閱生命週期
建立結帳會話	POST /api/subscriptions/stripe/checkout-session	開始結帳新的或更改的計劃
建立入口網站會話	POST /api/subscriptions/stripe/portal-session	開啟自助訂閱入口網站
同步結帳會話	POST /api/subscriptions/stripe/checkout-session-sync	將結帳完成連結到訂閱狀態

關鍵數據和狀態

{
  data: {
    account_id: "acc_...",
    subscription_id: "sub_...",
    status: "active"
  },
  links: {
    checkout_url: "https://checkout.stripe.com/..."
  }
}

所有回應都使用代理信封樣式的有效負載，由 data 和可選的 links 鍵入。

故障模式與控制

缺少或無效的 acc 聲明會拒絕所有者訂閱操作，並且非所有者呼叫者將被阻止執行所有者範圍內的訂閱操作。上游代理失敗會作為明確操作失敗返回，訂閱突變仍然僅限於明確變更或取消路由。

相關

訂閱代理信封、11-訂閱擁有者控制。