사용량 기반 청구를 통해 고객이 실제로 사용하는 것에 대해 요금을 부과할 수 있습니다—API 호출, 저장소, AI 토큰 또는 정의한 모든 메트릭에 대해. 고객은 고정 요금이 아닌 소비에 대해 지불합니다.
적합한 경우: API, AI 서비스, 인프라 플랫폼 및 사용량에 따라 가치가 증가하는 모든 제품.
작동 방식
사용량 이벤트 전송
청구 가능한 작업이 발생할 때 애플리케이션이 이벤트를 전송합니다.{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
계량기 집계 사용량
계량기는 Count, Sum, Max 또는 Last 집계를 사용하여 이벤트를 청구 가능한 수량으로 집계합니다.
자동 청구
단위당 가격과 무료 한도를 설정합니다. 고객은 매 사이클마다 자동으로 청구됩니다.
핵심 개념
이벤트
이벤트는 애플리케이션에서의 사용 행동을 나타냅니다. 각 이벤트에는 다음이 포함됩니다:
- 이벤트 이름: 사용 유형 (예:
api.call)
- 고객 ID: 사용한 사람
- 메타데이터: 집계를 위한 추가 속성
계량기
계량기는 이벤트를 청구 가능한 수량으로 집계합니다:
- Count: 총 이벤트 (API 호출)
- Sum: 값 추가 (총 바이트)
- Max: 최고 값 (최대 사용자 수)
- Last: 가장 최근 값
사용량 가격 책정이 있는 제품
단위당 가격과 선택적 무료 한도를 설정합니다:
예시: 2,500 호출 - 1,000 무료 = 1,500 × 0.02=30.00
고객 크레딧
고객에게 포함된 사용량 크레딧을 제공하여 각 청구 주기마다 새로 고칩니다. 크레딧은 유료 사용 전에 적용됩니다.
빠른 시작
계량기 생성
대시보드에서: 계량기 → 계량기 생성
- 이벤트 이름 설정 (예:
api.call)
- 집계 선택 (개수, 합계, 최대, 마지막)
- 선택적 필터 추가
제품에 추가
가격이 있는 제품에 계량기를 연결합니다:
- 사용량 기반 청구 선택
- 계량기 선택
- 단위당 가격 및 무료 한도 설정
이벤트 전송
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: "unique_event_id",
customer_id: "cus_abc123",
event_name: "api.call",
metadata: { endpoint: "/v1/users" }
}]
})
});
사용량 모니터링
계량기 대시보드에서 이벤트 및 사용량 집계를 확인합니다. 고객은 매 사이클마다 자동으로 청구됩니다. 사용 사례
API 및 인프라
API 호출, 컴퓨팅 시간, 대역폭, 저장소를 추적합니다. 예: 10,000 무료 이후 호출당 $0.001.
AI 사용량 추적
토큰, 생성, 처리 시간을 추적합니다. 예: 표준 이미지당 $0.04, HD당 $0.08.
데이터 및 분석
처리된 데이터, 실행된 쿼리, 분석된 레코드에 따라 청구합니다. 예: 10GB 무료 이후 GB당 $5.
통신
메시지, 분, 전송된 데이터 수를 계산합니다. 예: 전송된 SMS당 $0.01.
다음 단계
