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 - 크레딧 한도를 초과한 사용량을 다음 인보이스에 청구한 후 잔액을 초기화합니다.
• 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

크레딧이 이 금액보다 낮아지면 알림을 보냅니다. 고객이 크레딧을 모두 사용하기 전에 알리는 데 유용합니다.

​

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 섹션의 + 버튼을 클릭하여 미터를 추가합니다. 구독에는 최대 3개의 미터를 사용할 수 있습니다.

3

Enable Credit Billing on the Meter

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

​

Free Threshold

number

필수

크레딧 차감이 시작되기 전에 무료로 제공되는 사용량 단위입니다.

​

Bill usage in Credits

boolean

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

​

Meter units per credit

number

필수

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

4

Configure Credit Issuance

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

5

Verify Attachment

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

​

크레딧 설정

​

롤오버

​

초과 사용

​

만료

​

크레딧을 사용한 사용량 결제

​

미터 기반 크레딧 차감 방식

1. 애플리케이션에서 사용량 이벤트를 전송합니다 - 각 이벤트에는 고객 ID, 이벤트 이름 및 메타데이터가 포함됩니다
2. 미터가 이벤트를 집계합니다 - Count, Sum, Max 또는 Last 집계를 사용합니다
3. 크레딧이 자동으로 차감됩니다 - 백그라운드 워커가 매분 이벤트를 처리하고, 구성된 비율을 사용해 미터 단위를 크레딧으로 변환한 다음 FIFO 순서(가장 오래된 부여분부터)로 고객 잔액에서 차감합니다
4. 초과 사용량이 추적됩니다 - 크레딧 잔액이 0이 되고 초과 사용이 활성화된 경우 시스템은 주기 종료 시 청구할 초과 사용량을 추적합니다

​

미터 패널

​

고객 경험

​

Checkout

​

Customer Portal

• Available Balance - 현재 크레딧 잔액을 눈에 띄게 표시
• Credit Tabs - 서로 다른 크레딧 유형 간 전환(예: “OpenAI Credits”, “Usage Tokens”)
• Recent Transactions - 날짜, 거래 ID, 유형, 수량 및 실행 잔액이 포함된 전체 내역

​

구독 세부 정보

• 결제 주기별 크레딧 할당량(예: “매 주기 1000 크레딧”)
• 남은 잔액(예: “7500 크레딧 남음”)
• 다음 크레딧 발급을 위한 갱신일
• 소비된 단위, 기준, 단가 및 총비용을 미터 수준으로 보여주는 Usage History 탭

​

거래 세부 정보

​

크레딧 관리

​

대시보드 보기

​

크레딧 권한 목록

​

고객 크레딧 세부 정보

• Credit Selector - 서로 다른 크레딧 권한 간 전환
• Available Balance - 현재 잔액을 크고 눈에 띄게 표시
• Apply Credit/Debit - 고객 잔액을 수동으로 조정하는 버튼
• Recent Transactions - 날짜, 거래 ID, 유형, 수량 및 실행 잔액이 포함된 전체 원장

​

수동 조정

​

크레딧 원장

​

Webhooks

​

API 관리

​

통합 예시

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: 'prod_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 }
  }]
});

​

실제 사례

​

모범 사례

• 간단하게 시작하기: 단일 크레딧 유형과 롤오버 없음으로 시작합니다. 고객 피드백과 사용 패턴에 따라 복잡성을 추가하세요.
• 명확한 기대치 설정: 제품 페이지와 Customer Portal에 크레딧 할당량, 남은 잔액 및 초과 사용 가격을 눈에 띄게 표시하세요.
• 의미 있는 단위 사용: 일반적인 용어 대신 크레딧이 나타내는 대상을 기준으로 이름을 지정하세요(예: “API Calls”, “AI Tokens”). 고객이 가치를 이해하는 데 도움이 됩니다.
• 신중하게 만료 구성하기: 짧은 만료 기간(7일)은 긴급성을 높이지만 고객을 불편하게 할 수 있습니다. 대부분의 SaaS 제품에는 더 긴 기간(30~90일)이 고객 친화적입니다.
• 낮은 잔액 모니터링: 낮은 잔액 기준을 설정하여 고객이 크레딧을 모두 사용하기 전에 알림을 보내면 예상치 못한 초과 사용 요금을 줄일 수 있습니다.
• 테스트 모드에서 테스트하기: 크레딧을 생성하고 테스트 제품에 연결한 뒤 실제 운영을 시작하기 전에 전체 구매 → 사용량 → 차감 → 만료 주기를 시뮬레이션하세요.