定期購入

サブスクリプション

サブスクリプション機能は、アカウント所有者のサブスクリプションと、受信トレイ マネージャーのプロキシ ルートを通じて公開されるプラン操作を定義します。 これにより、アカウントとロールのチェックを厳格に保ちながら、所有者にプランのライフサイクルを直接制御できるようになります。

なぜこれが重要なのか

この機能は、所有者サブスクリプション アクションを受信トレイ マネージャー API サーフェスの下に統合し、ベアラー トークン要求からの厳密なアカウントとロールのチェックを維持します。これにより、クライアントがサブスクリプション オーケストレーション ロジックを複製する必要がなく、チェックアウト、ポータル、同期、およびプラン変更の操作が公開されます。

コアフロー

操作

操作	エンドポイント	目的
サブスクリプションをリストする	GET /api/subscriptions	トークンで選択されたアカウントのサブスクリプションを取得する
リスト機能	GET /api/subscriptions/features	アクティブなサブスクリプション機能セットを取得する
サブスクリプション ID を取得	GET /api/subscriptions/identity	アカウントのサブスクリプション ID バインディングを取得する
販売者をリストする	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-subscription-owner-control。