메인 콘텐츠로 건너뛰기
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"

{
  "success": true,
  "credits": 500,
  "sessionId": "cs_test_a1b2c3d4e5f6"
}

​
개요

결제가 끝난 뒤 이 엔드포인트로 결제 처리 여부와 계정 크레딧 반영을 확인합니다. 웹훅이 처리되지 않은 경우 등의 대안으로 유용합니다.
크레딧은 일반적으로 Stripe 웹훅으로 자동 반영됩니다. 이 엔드포인트는 예외적인 경우나 클라이언트 측 확인을 위한 수동 검증 옵션입니다.
서드파티 연동: API 키 인증을 사용할 때는 대신 GET /credits/verify-session/{sessionId}/api를 사용하세요.

​
인증

​
Authorization
string
필수
JWT 액세스 토큰(세션 인증)입니다. 형식: Bearer YOUR_ACCESS_TOKEN

​
경로 매개변수

​
sessionId
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"

{
  "success": true,
  "credits": 500,
  "sessionId": "cs_test_a1b2c3d4e5f6"
}

​
응답 필드

​
success
boolean
세션 검증 성공 여부입니다.
​
credits
integer
구매에서 얻은 크레딧 수입니다.
​
sessionId
string
검증한 세션 ID입니다.

​
오류 응답

​
400
잘못된 요청 — 결제가 완료되지 않았거나 세션 메타데이터가 잘못되었습니다.
​
401
인증 실패 — 토큰이 없거나 유효하지 않습니다.
​
403
접근 거부 — 세션이 현재 인증된 사용자에게 속하지 않습니다.

​
멱등성

이 엔드포인트는 멱등합니다. 크레딧이 이미(웹훅 등으로) 반영된 경우 추가로 두 번 더하지 않고, 성공과 크레딧 금액을 반환합니다.

​
일반적인 흐름

  1. 사용자가 Stripe에서 결제를 마칩니다
  2. Stripe가 successUrl로 리디렉션합니다
  3. 이 엔드포인트를 호출해 크레딧 반영을 검증합니다
  4. 사용자에게 확인 화면을 보여 줍니다
  5. UI에서 크레딧 잔액을 새로고칩니다
이 엔드포인트를 사용할 수 있지만, 권장 흐름은 Stripe 웹훅을 수신하고 UI는 /credits/balance로 갱신하는 것입니다.

​
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"