メインコンテンツへスキップ
POST
/
subscriptions
/
checkout
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'

{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

​
概要

プランへの登録のため Stripe Checkout セッションを作成します。決済完了用にユーザーへリダイレクトすべき URL を返します。セッション認証（JWT アクセストークン）が必要です。
サードパーティ連携: API キー認証で POST /subscriptions/checkout/api を利用してください。

​
認証

​
Authorization
string
必須
JWT アクセストークン。形式: Bearer YOUR_ACCESS_TOKEN

​
リクエストボディ

​
planId
string
必須
契約するプラン ID。次のいずれかです: starter、professional、business、agency。
​
billingCycle
string
デフォルト:"monthly"
請求頻度。monthly または yearly。
​
successUrl
string
決済成功後のリダイレクト URL。既定はアプリのダッシュボードです。
​
cancelUrl
string
ユーザーが決済をキャンセルした場合のリダイレクト URL。既定は料金ページです。
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'

{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

​
レスポンスフィールド

​
sessionId
string
Stripe Checkout セッション ID。後からセッションを検証する際に利用できます。
​
url
string
決済ページへユーザーを転送する URL。Stripe ホストの Checkout です。
​
plan
object
選択されたプランの詳細。

​
Checkout の流れ

  1. セッション作成: 希望プランで本エンドポイントを呼び出す
  2. ユーザーを転送: 返却された url へ誘導する
  3. 決済処理: ユーザーが Stripe 上で支払いを完了する
  4. Webhook: Stripe が Webhook で通知する
  5. 成功後の転送: ユーザーが successUrl へリダイレクトされる
  6. 検証（任意）: /subscriptions/current で契約状態を確認する

​
エラーレスポンス

​
400
不正なリクエスト — 無効なプラン ID、または既にアクティブな契約がある場合など。
​
401
未認証 — トークンが無効または未指定です。
既にアクティブな契約がある場合は Checkout ではなく、請求ポータル（/subscriptions/portal）からプラン変更する必要があります。

​
POST /subscriptions/checkout/api

API キー認証で Stripe Checkout セッションを作成します。サードパーティ連携向けです。

​
認証

API キー認証が必要です。Authorization ヘッダーに API キーを付与します。 
Authorization: Bearer llmgen_your_api_key_here

​
リクエストボディ

/subscriptions/checkout と同一です。

​
レスポンス

/subscriptions/checkout と同一です。 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'