curl -X GET https://api.llmgenerator.com/api/v1/credits/verify-session/cs_test_a1b2c3d4e5f6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const sessionId = 'cs_test_a1b2c3d4e5f6';
const response = await fetch(
`https://api.llmgenerator.com/api/v1/credits/verify-session/${sessionId}`,
{
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
}
);
const data = await response.json();
if (data.success) {
console.log(`Added ${data.credits} credits`);
}
import requests
session_id = 'cs_test_a1b2c3d4e5f6'
response = requests.get(
f'https://api.llmgenerator.com/api/v1/credits/verify-session/{session_id}',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
data = response.json()
print(f"Verified: {data['credits']} credits")
{
"success": true,
"credits": 500,
"sessionId": "cs_test_a1b2c3d4e5f6"
}
{
"success": false,
"message": "Payment not completed"
}
クレジット
Checkout セッションの検証
完了した Checkout セッションを検証し、クレジットが付与されたことを確認します。
GET
/
credits
/
verify-session
/
{sessionId}
curl -X GET https://api.llmgenerator.com/api/v1/credits/verify-session/cs_test_a1b2c3d4e5f6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const sessionId = 'cs_test_a1b2c3d4e5f6';
const response = await fetch(
`https://api.llmgenerator.com/api/v1/credits/verify-session/${sessionId}`,
{
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
}
);
const data = await response.json();
if (data.success) {
console.log(`Added ${data.credits} credits`);
}
import requests
session_id = 'cs_test_a1b2c3d4e5f6'
response = requests.get(
f'https://api.llmgenerator.com/api/v1/credits/verify-session/{session_id}',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
data = response.json()
print(f"Verified: {data['credits']} credits")
{
"success": true,
"credits": 500,
"sessionId": "cs_test_a1b2c3d4e5f6"
}
{
"success": false,
"message": "Payment not completed"
}
概要
決済完了後に本エンドポイントで支払い処理とクレジット付与を確認します。Webhook が処理されなかった場合のフォールバックや、クライアント側での確認に役立ちます。クレジットは通常 Stripe の Webhook で自動付与されます。本エンドポイントはエッジケースやクライアント側確認用の手動検証手段です。
サードパーティ連携の場合: API キー認証の
GET /credits/verify-session/{sessionId}/api を利用してください。認証
string
必須
JWT アクセストークン（セッション認証）。形式:
Bearer YOUR_ACCESS_TOKENパスパラメーター
string
必須
/credits/checkout から返された Stripe Checkout セッション ID。curl -X GET https://api.llmgenerator.com/api/v1/credits/verify-session/cs_test_a1b2c3d4e5f6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const sessionId = 'cs_test_a1b2c3d4e5f6';
const response = await fetch(
`https://api.llmgenerator.com/api/v1/credits/verify-session/${sessionId}`,
{
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
}
);
const data = await response.json();
if (data.success) {
console.log(`Added ${data.credits} credits`);
}
import requests
session_id = 'cs_test_a1b2c3d4e5f6'
response = requests.get(
f'https://api.llmgenerator.com/api/v1/credits/verify-session/{session_id}',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
data = response.json()
print(f"Verified: {data['credits']} credits")
{
"success": true,
"credits": 500,
"sessionId": "cs_test_a1b2c3d4e5f6"
}
{
"success": false,
"message": "Payment not completed"
}
レスポンスフィールド
boolean
セッション検証が成功したかどうか。
integer
購入によるクレジット数。
string
検証したセッション ID。
エラーレスポンス
不正なリクエスト — 決済未完了、またはセッションのメタデータが無効です。
未認証 — トークンが無効または未指定です。
禁止 — セッションが認証ユーザーに属しません。
べき等性
本エンドポイントはべき等です。クレジットが既に Webhook により付与済みの場合、二重付与は行わず、成功とクレジット量を返します。典型的な流れ
- ユーザーが Stripe で決済を完了する
- Stripe が
successUrlにリダイレクトする - 本エンドポイントで付与を検証・確認する
- ユーザーに完了を表示する
- UI の残高表示を更新する
利用可能ではありますが、推奨フローは Stripe Webhook を受信し、
/credits/balance に基づいて UI を更新することです。GET /credits/verify-session//api
API キー認証で Checkout セッションを検証します。サードパーティ連携向けです。認証
API キー認証が必要です。Authorization ヘッダーに API キーを付与します。
Authorization: Bearer llmgen_your_api_key_here
パスパラメーター
上記と同じです。レスポンス
上記と同じです。curl -X GET https://api.llmgenerator.com/api/v1/credits/verify-session/cs_test_a1b2c3d4e5f6/api \
-H "Authorization: Bearer llmgen_your_api_key_here"
const sessionId = 'cs_test_a1b2c3d4e5f6';
const response = await fetch(
`https://api.llmgenerator.com/api/v1/credits/verify-session/${sessionId}/api`,
{
headers: {
'Authorization': 'Bearer llmgen_your_api_key_here'
}
}
);
const data = await response.json();
if (data.success) {
console.log(`Added ${data.credits} credits`);
}
import requests
session_id = 'cs_test_a1b2c3d4e5f6'
response = requests.get(
f'https://api.llmgenerator.com/api/v1/credits/verify-session/{session_id}/api',
headers={'Authorization': 'Bearer llmgen_your_api_key_here'}
)
data = response.json()
print(f"Verified: {data['credits']} credits")
このページは役に立ちましたか？
⌘I