Credit-Based Billing

​

Credit-Based Billing이란 무엇인가요?

• AI 및 LLM 플랫폼: 요금제 등급별로 토큰 또는 생성 크레딧 부여
• API 서비스: 초과 사용 가격이 적용되는 API 호출 크레딧 할당
• 인프라 플랫폼: 컴퓨팅 시간 또는 스토리지 크레딧 발급
• 커뮤니케이션 서비스: 구독별 메시지 또는 통화 시간 크레딧 제공
• 사용량 등급이 있는 SaaS: 포함된 사용량을 크레딧 풀로 묶기

​

핵심 개념

​

크레딧 유형

​

크레딧 수명 주기

​

부여 출처

​

크레딧 생성

1

Navigate to Credits

대시보드에서 Products로 이동하고 Credits 탭을 선택합니다. Create Credit을 클릭하여 시작합니다.

2

Configure Basic Information

Credit Name을 입력합니다. 이는 크레딧의 내부 식별자입니다.

3

Set General Settings

크레딧 유형과 표시 속성을 구성합니다:

​

Credit Type

string

필수

Custom Unit 또는 Fiat Credits를 선택합니다.

• Custom Unit: 자체 지표(토큰, API 호출, 컴퓨팅 시간)를 정의합니다. Unit Name(예: “Platform tokens”) 및 Precision 설정이 필요합니다.
• Fiat Credits: 크레딧이 실제 통화 가치를 나타냅니다. Unit Currency(USD, EUR, GBP, INR 등)를 선택해야 합니다.

​

Unit Name

string

Custom Unit 크레딧에만 해당합니다. 고객에게 표시되는 이 크레딧의 라벨입니다(예: “AI Tokens” 또는 “API Calls”). Checkout 및 Customer Portal에 표시됩니다.

​

Precision

number

Custom Unit 크레딧에만 해당합니다. 허용되는 소수점 이하 자릿수는 0에서 10까지입니다:

• 0: 정수(API 호출과 같이 셀 수 있는 항목에 적합)
• 1: 소수점 한 자리(0.0)
• 2: 소수점 두 자리(0.00)—기본값
• 3: 소수점 세 자리(0.000)
• 10까지: 높은 정밀도가 필요한 단위(예: 소수 토큰 또는 마이크로 사용량)

크레딧을 생성한 후에는 정밀도를 변경할 수 없습니다.

​

Credit Expiry

string

발급 후 크레딧이 유효한 기간입니다:

• 7일, 30일(기본값), 60일, 90일, Custom 또는 Never

사용자 지정 일수를 지정하려면 Custom을 선택합니다(최소 1일).

4

Configure Subscription Settings (Optional)

이 설정은 반복 구독 내에서 크레딧 동작을 제어합니다:

​

Rollover

boolean

사용하지 않은 크레딧을 다음 결제 주기로 이월합니다. 활성화하면 다음을 구성합니다:

• Max Rollover Percentage (0~100%): 이월되는 양의 최대 비율
• Rollover Timeframe: 이월된 크레딧이 유효한 기간(예: 1 Month)
• Max Rollover Count: 크레딧이 소멸되기 전 연속 이월 가능한 최대 횟수

크레딧이 소진되거나 구독이 만료되는 경우:

​

Allow Overage

boolean

크레딧 잔액이 0이 된 후에도 고객이 서비스를 계속 사용하도록 허용합니다. 활성화하면 다음을 구성합니다:

• Overage Limit: 고객이 잔액을 초과하여 사용할 수 있는 최대 크레딧
• Price Per Unit: 초과 사용이 활성화된 경우 추가 크레딧당 비용(통화 선택기 포함)

​

Overage Behavior

string

필수

결제 주기 종료 시 초과 사용을 처리하는 방법을 제어합니다:

• Forgive overage at reset(기본값): 크레딧 한도를 초과한 사용량은 추적되지만 청구되지 않습니다. 잔액은 각 주기에 재설정됩니다.
• Bill overage at billing: 크레딧 한도를 초과한 사용량이 다음 invoice에 청구된 후 잔액이 재설정됩니다.
• Carry over deficit: 크레딧 한도를 초과한 사용량이 음수 잔액으로 다음 주기에 이월됩니다.
• Carry over deficit (auto-repay): 적자가 이월되며 다음 주기에 새 크레딧에서 자동으로 상환됩니다.

5

Create Credit

Create Credit을 클릭하여 저장합니다. 이제 모든 제품에 연결할 수 있는 크레딧이 준비되었습니다.

크레딧 권한이 준비되었습니다. 제품에 연결하여 고객에게 크레딧을 발급하세요.

​

제품에 크레딧 연결

​

구독 제품

1

Create or Edit a Subscription Product

Products → Create Product로 이동하거나 기존 제품을 편집합니다. 가격 유형으로 Subscription을 선택하고 반복 가격을 구성합니다.

2

Open Entitlements Section

Entitlements 섹션을 펼치고 Credits 옆의 Attach 버튼을 클릭합니다.

3

Select Credits to Attach

Add Credits 패널이 열립니다. 드롭다운에서 기존 크레딧을 선택하거나 Create new credit을 클릭하여 즉시 새 크레딧을 정의할 수 있습니다.

제품당 최대 5개의 크레딧을 연결할 수 있습니다. 각 크레딧은 자체 구성을 가질 수 있습니다.

4

Configure Credit Settings

연결된 각 크레딧에 대해 다음을 구성합니다:

​

Credits issued per billing cycle

number

필수

각 결제 기간에 고객에게 부여할 크레딧 수입니다.

​

Low Balance Threshold

number

잔액이 이 비율(0–100%) 미만으로 떨어지면 알림을 보냅니다. 고객이 잔액을 모두 소진하기 전에 알림을 보내는 데 유용합니다.

​

Credits During Free Trial

number

체험 기간에 다른 크레딧 수량을 설정합니다. Expire trial credits after trial ends를 활성화하면 체험판이 유료 구독으로 전환될 때 사용하지 않은 체험판 크레딧이 회수됩니다.

​

Allow Proration

boolean

고객이 구독 요금제를 업그레이드하거나 다운그레이드할 때 남은 크레딧을 비례 배분합니다.

​

Import Default Credit Settings

boolean

크레딧 권한의 기본 롤오버, 초과 사용 및 만료 설정을 사용합니다. 이 옵션을 끄면 이 제품에만 적용되는 설정을 사용자 지정할 수 있습니다.

5

Review and Add

이름, 수량 및 만료 정보가 표시된 연결된 크레딧을 검토합니다. Add to Subscription을 클릭하여 확인합니다.

​

일회성 결제 제품

1

Create a One-Time Product

가격 유형이 Single Payment인 제품을 생성합니다.

2

Attach Credits

Entitlements 섹션을 열고 크레딧을 연결합니다. 구매 시 발급되는 총 일회성 크레딧인 number of credits issued를 구성합니다.

​

사용량 기반 결제 제품

1

Create a Usage-Based Product

가격 유형으로 Usage Based Billing을 선택합니다. 기본 가격과 결제 주기를 구성합니다.

2

Add a Meter

Select meter 섹션의 + 버튼을 클릭하여 meter를 추가합니다. 하나의 구독에는 최대 50 meters를 추가할 수 있습니다.

3

Enable Credit Billing on the Meter

Bill usage in Credits를 켜서 크레딧을 미터에 연결합니다. 드롭다운에서 크레딧 권한을 선택합니다.

​

Free Threshold

number

meter가 금액으로 청구되는 경우에만 적용됩니다. meter가 크레딧으로 청구되면 모든 단위가 크레딧 잔액에서 차감됩니다.

​

Bill usage in Credits

boolean

활성화하면 미터 사용량이 단위별로 청구되는 대신 고객의 크레딧 잔액에서 차감됩니다.

​

Meter units per credit

number

필수

크레딧 1개를 차감하는 데 필요한 사용량 단위 수입니다. 예를 들어 1000로 설정하면 API 호출 1,000회가 크레딧 1개를 소비합니다.

4

Configure Credit Issuance

발급할 크레딧 수를 설정하고 필요에 따라 이 제품의 크레딧 설정을 사용자 지정합니다.

5

Verify Attachment

구성이 완료되면 미터에 연결된 크레딧 이름, 단가 및 무료 기준이 표시됩니다.

​

크레딧 설정

​

롤오버

​

초과 사용

​

만료

​

크레딧을 사용한 Usage Billing

​

Meter 기반 크레딧 차감 방식

1. 애플리케이션에서 usage event를 전송합니다: 각 이벤트에는 customer ID, event name 및 metadata가 포함됩니다.
2. meter가 이벤트를 집계합니다: Count, Sum, Max 또는 Last aggregation을 사용합니다.
3. 크레딧이 자동으로 차감됩니다: 백그라운드 worker가 매분 이벤트를 처리하고, 구성된 rate를 사용하여 meter 단위를 크레딧으로 변환한 다음 FIFO 순서(가장 먼저 만료되는 grant 우선)에 따라 고객 잔액에서 차감합니다.
4. 초과 사용량이 추적됩니다: 크레딧 잔액이 0에 도달하고 초과 사용이 활성화된 경우 시스템은 주기 종료 시 billing을 위해 초과 사용량을 추적합니다.

​

Meters 패널

​

고객 경험

​

Checkout

​

Customer Portal

• Available Balance: 현재 크레딧 잔액이 눈에 띄게 표시됩니다.
• Credit Tabs: 서로 다른 크레딧 유형 간에 전환합니다(예: “OpenAI Credits” 또는 “Usage Tokens”).
• Recent Transactions: 날짜, transaction ID, 유형, 금액 및 누적 잔액을 포함한 전체 내역

​

Subscription Details

• billing cycle별 Credit allocation(예: “1000 credits each cycle”)
• Remaining balance(예: “7500 credits remaining”)
• 다음 크레딧 발행을 위한 Renewal date
• 소비된 단위, threshold, unit price 및 총 비용을 meter 수준으로 분석하는 Usage History 탭

​

Transaction Details

​

크레딧 관리

​

Dashboard 보기

​

Credit Entitlements 목록

​

Customer Credit Details

• Credit Selector - 서로 다른 credit entitlement 간에 전환
• Available Balance - 크고 눈에 띄게 표시되는 현재 잔액
• Apply Credit/Debit - 고객 잔액을 수동으로 조정하는 버튼
• Recent Transactions - 날짜, transaction ID, 유형, 금액 및 누적 잔액을 포함한 전체 ledger

​

수동 조정

​

Credit Ledger

​

Webhooks

​

API Management

​

Integration Example

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_ai_pro_plan',
      quantity: 1,
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

실제 사용 사례

​

모범 사례

• 간단하게 시작하기: 단일 크레딧 유형과 rollover 없이 시작합니다. 고객 피드백과 사용 패턴에 따라 복잡성을 추가하세요.
• 명확한 기대치 설정: 제품 페이지와 Customer Portal에 크레딧 할당량, 잔여 잔액 및 overage 가격을 눈에 띄게 표시하세요.
• 의미 있는 단위 사용: 일반적인 용어 대신 크레딧이 나타내는 대상을 기준으로 이름을 지정하세요(예: “API Calls” 또는 “AI Tokens”). 이를 통해 고객이 가치를 이해할 수 있습니다.
• 신중하게 expiry 구성하기: 짧은 expiry window(7일)는 긴급성을 높이지만 고객에게 불편을 줄 수 있습니다. 대부분의 SaaS 제품에서는 더 긴 window(30~90일)가 고객에게 더 친화적입니다.
• 낮은 잔액 모니터링: 고객이 크레딧을 모두 사용하기 전에 알림을 받을 수 있도록 low balance threshold를 설정하여 예상치 못한 overage charge를 줄이세요.
• test mode에서 테스트하기: 크레딧을 생성하고 test product에 연결한 후, 출시 전에 전체 purchase → usage → deduction → expiration cycle을 시뮬레이션하세요.