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

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

개요

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

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

플랜	월간 한도	가격	초과 호출 처리
Free	1,000회	$0	한도 도달 시 API 호출 거부
Basic	30,000회	$10/월	한도 도달 시 API 호출 거부
Pro	300,000회	$30/월	한도 도달 시 API 호출 거부
Enterprise	1,000,000회	$100/월	한도 초과도 호출 허용. 초과분은 다음 결제 시 자동 청구

Enterprise 초과 요금: 월 한도를 넘은 호출 1건당 $0.0005 로 계산되어, 다음 결제 주기 갱신 시점에 추가 청구됩니다 (예: 10,000회 초과 → $5 추가).

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

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

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

1. 결제 주기당 1회 제한

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

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

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

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

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

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

즉시 판단되는 경계값:

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

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

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

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

Enterprise 플랜 사용 중이라면 초과 사용량(Overage) 이력 섹션이 추가로 표시됩니다.

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