메인 콘텐츠로 건너뛰기
POST
/
subscriptions
/
cancel
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

​
개요

구독을 취소합니다. 현재 과금 기간이 끝날 때까지는 구독이 유지되며, 이후에는 갱신되지 않습니다. 세션 기반 인증(JWT 액세스 토큰)이 필요합니다.
서드파티 연동: API 키 인증을 사용할 때는 대신 POST /subscriptions/cancel/api를 사용하세요.
이 작업은 기간 종료 시 취소를 예약합니다. 사용자는 currentPeriodEnd까지 이용할 수 있습니다. 즉시 해지하려면 청구 포털을 사용하세요.

​
인증

​
Authorization
string
필수
JWT 액세스 토큰입니다. 형식: Bearer YOUR_ACCESS_TOKEN
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

​
응답 필드

​
success
boolean
취소 예약 성공 여부입니다.
​
message
string
사람이 읽을 수 있는 상태 메시지입니다.
​
cancellationDate
string
구독이 종료될 시각(ISO 8601, 성공 시에만)입니다.

​
오류 응답

​
400
잘못된 요청 — 취소할 활성 구독이 없거나 API로 취소할 수 없는 구독입니다.
​
401
인증 실패 — 토큰이 없거나 유효하지 않습니다.

​
취소 동작

시나리오동작
활성 구독기간 종료 시 취소로 표시됨
이미 취소됨오류 반환
구독 없음오류 반환
Stripe 구독 ID 없음오류(API로 취소 불가)

​
재활성화

사용자가 다시 이용하려면:
  1. 청구 포털(/subscriptions/portal)을 사용하거나
  2. 현재 구독이 끝난 뒤 새 구독을 만들 수 있습니다.

​
권장 사항

  • 확인 대화 상자: 취소 전 항상 확인을 받습니다
  • 사유 수집: 피드백을 위해 취소 사유를 묻습니다
  • 이탈 방지: 할인 또는 일시정지 옵션을 고려합니다
  • 명확한 안내: 서비스 이용 종료 시점을 사용자에게 표시합니다

​
POST /subscriptions/cancel/api

API 키 인증으로 사용자 구독을 취소(기간 종료 예약)합니다. 서드파티 연동에 적합합니다.

​
인증

API 키 인증이 필요합니다. Authorization 헤더에 API 키를 넣습니다: 
Authorization: Bearer llmgen_your_api_key_here

​
응답

/subscriptions/cancel와 동일합니다. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel/api \
  -H "Authorization: Bearer llmgen_your_api_key_here"