구독 - 3Min API 사용자 매뉴얼

메뉴 경로: 대시보드 > 설정 > 구독

개요

구독 페이지에서는 현재 플랜과 이번 기간 사용량을 확인하고, 플랜 변경(업그레이드·다운그레이드)·구독 취소·재활성화를 관리할 수 있습니다.

진입 경로

상단 메뉴 설정 → 왼쪽 서브메뉴 구독
대시보드 하단 플랜 업그레이드 바로가기 카드

플랜과 월간 한도

3가지 플랜이 제공되며, 모든 플랜의 빌링 주기는 30일입니다.

플랜	월간 한도	가격	초과 호출 처리
Free	1,000회	$0	한도 도달 시 API 호출 거부
Basic	100,000회	$10/월	한도 도달 시 API 호출 거부
Pro	1,000,000회	$30/월	한도 도달 시 API 호출 거부

사용량 카드

페이지 상단에 현재 구독의 사용 현황이 카드 형태로 표시됩니다.

현재 플랜 이름과 월 한도
이번 기간 사용량: 사용 / 한도 표기와 진행률 바
남은 호출 수
현재 기간 종료일: 다음 결제/갱신 예정일

사용량 알림

80% 도달 시: 이메일 발송
100% 초과 시: 이메일 발송. Free/Basic/Pro는 이 시점부터 호출 차단

플랜 변경

플랜 변경 버튼을 누르면 변경 가능한 플랜 목록이 표시됩니다. 현재 플랜보다 상위는 업그레이드, 하위는 다운그레이드로 구분되어 표시돼요.

업그레이드

즉시 적용됩니다
남은 기간에 대한 차액이 즉시 청구됩니다 (일할 계산)
API 호출 한도가 즉시 상향됩니다
이번 기간 동안 쌓인 사용량은 그대로 유지되며, 새 한도 기준으로 차감됩니다
업그레이드는 횟수 제한 없음

다운그레이드

즉시 적용됩니다
남은 기간에 대한 크레딧이 발급됩니다 (다음 결제에 반영)
API 호출 한도가 즉시 하향됩니다

다운그레이드 제약 사항

다운그레이드에는 두 가지 제약이 있습니다. 하나라도 만족하지 못하면 다운그레이드가 거부됩니다.

1. 결제 주기당 1회 제한

같은 결제 주기 안에서는 다운그레이드를 1회만 할 수 있습니다. 이미 다운그레이드한 경우, 다음 결제 갱신일 이후에 다시 시도할 수 있어요.

2. 현재 사용량 기반 허용 한도

다운그레이드하려는 플랜의 한도를 현재까지 너무 많이 사용했다면 거부됩니다. 허용 사용량은 다음 공식으로 계산돼요.

허용 사용량 = min(
  타겟 플랜 한도 × (경과일 ÷ 전체 주기일) × 1.1,
  타겟 플랜 한도
)

쉽게 설명하면, 결제 주기가 얼마나 지났는지에 비례해서 다운그레이드 대상 플랜의 한도를 허용합니다. 10% 여유는 보너스로 주어지고, 어떤 경우에도 타겟 플랜의 전체 한도를 초과해서는 안 됩니다.

예시: Pro(100만) → Basic(10만)으로 다운그레이드하려는 경우, 30일 주기 기준

현재 시점	Basic 허용 사용량	현재 사용량 60,000회인 경우
주기 5일차	약 18,300회	거부 (계산식 결과보다 많음)
주기 15일차	약 55,000회	거부 (계산식 결과보다 많음)
주기 25일차	약 91,700회	허용
주기 30일차	100,000회 (상한)	허용

즉시 판단되는 경계값:

현재 사용량이 0회면 무조건 허용
현재 사용량이 타겟 플랜 한도 이상이면 즉시 거부

다운그레이드가 거부되면

거부 시 화면에 사유가 표시됩니다.

이미 이번 주기에 다운그레이드했습니다 — 다음 결제 갱신일 이후 재시도
현재 사용량이 허용 한도를 초과합니다 — 다음 결제 갱신일 이후 재시도

구독 취소

구독 취소 버튼으로 유료 구독을 해지할 수 있습니다.

현재 결제 기간이 끝날 때까지 서비스는 그대로 이용 가능합니다
결제 기간 종료 후 Free 플랜으로 자동 전환됩니다
이후에는 Free 플랜 정책이 예외 없이 적용되어, 생성한 지 7일이 지난 엔드포인트는 샌드박스·프로덕션 데이터와 함께 다음 정리 주기에 삭제됩니다
취소 이후에도 재활성화 버튼으로 취소를 철회할 수 있습니다 (결제 기간 내에만 가능)

예약된 다운그레이드 취소

Paddle 특성상 구독 종료 예약(취소)과 플랜 변경은 함께 사용할 수 없습니다. 구독 취소가 예약되어 있으면 플랜 변경 버튼이 비활성화되며, 먼저 재활성화한 뒤 플랜 변경을 진행해야 합니다.

결제 수단 관리

결제 수단 업데이트 버튼으로 카드 정보를 갱신할 수 있습니다. 결제 실패(카드 만료 등)로 업그레이드가 진행되지 않을 때 이 메뉴에서 새 카드를 등록하세요.

자주 막히는 부분

업그레이드했는데 결제가 안 돼요: 결제 수단이 만료되었거나 거절되었을 수 있습니다. 결제 수단 업데이트로 새 카드를 등록한 뒤 다시 시도하세요
다운그레이드 버튼이 비활성이에요: 이번 주기에 이미 다운그레이드했거나, 현재 사용량이 타겟 플랜 한도를 초과했거나, 구독 취소가 예약된 상태입니다. 화면의 안내 메시지를 확인하세요
Free로 전환되면 기존 데이터는 어떻게 되나요?: Free 플랜 정책이 예외 없이 적용됩니다. 생성한 지 7일이 지난 엔드포인트는 모든 데이터와 함께 다음 정리 주기에 삭제돼요. 대부분의 엔드포인트가 여기에 해당하므로, 남겨야 할 데이터는 해지 전에 로그 화면이나 목록 API로 미리 내려받아 주세요
환불은 어떻게 받나요?: 계정이 유효한 상태에서 구독 취소 후 남은 기간 크레딧이 다음 결제에 반영됩니다. 별도 환불 정책(미사용 30일 이내 전액 환불 등)은 서비스 환불 정책 페이지를 확인하세요
사용량이 갑자기 늘었어요: 통계 페이지에서 협업 키별 호출 분포를 확인하면 어느 협업자가 많이 호출 중인지 파악할 수 있습니다
계정을 삭제하려면?: 환불이 필요하다면 이 페이지에서 먼저 구독을 취소한 뒤 프로필 페이지에서 계정을 삭제하세요. 계정 삭제 후에는 과거 결제 정보에 접근할 수 없습니다

프로필

ChatGPT 연동