メインコンテンツへスキップ
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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.llmgenerator.com/llms.txt

Use this file to discover all available pages before exploring further.

概要

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

認証

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

リクエストボディ

planId
string
必須
契約するプラン ID。次のいずれかです: starterprofessionalbusinessagency
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"
  }'