क्रेडिट-आधारित Billing

Credit-Based Billing आपको ग्राहकों को credits का balance देने की सुविधा देता है—API calls, tokens, compute units या कोई भी custom metric—और आपकी service का उपयोग करने पर उस balance से credits घटाता है। Credits सभी product types में काम करते हैं: subscriptions, one-time purchases और usage-based billing।

Credit-Based Billing क्या है?

Credit-Based Billing आपको अपने products के हिस्से के रूप में ग्राहकों को credit entitlements जारी करने की flexible system देता है। प्रति उपयोग charge करने या feature flags के माध्यम से access सीमित करने के बजाय, आप credits का एक pool allocate करते हैं, जिसका उपयोग ग्राहक आपकी service इस्तेमाल करते समय करते हैं। Credits इन मामलों के लिए उपयोगी हैं:

AI और LLM platforms: प्रत्येक plan tier के लिए tokens या generation credits दें
API services: overage pricing के साथ API call credits allocate करें
Infrastructure platforms: compute hours या storage credits जारी करें
Communication services: प्रत्येक subscription के लिए message या minute credits दें
Consumption tiers वाले SaaS: शामिल usage को credit pools में bundle करें

Checkout showing included credits with the product purchase — Credits appear as entitlements on your products and show in checkout, customer portal, and subscription details.

मुख्य अवधारणाएँ

Credit Types

Credit बनाते समय, आप दो types में से एक चुनते हैं:

Custom Unit
Fiat Credits

Credits को अपनी स्वयं की unit में परिभाषित करें—tokens, API calls, compute hours या आपके product के लिए महत्वपूर्ण कोई भी metric। Custom units आपके द्वारा सेट की गई precision का उपयोग करती हैं (0 से 10 decimal places)।इनके लिए सर्वोत्तम: API calls, AI tokens, compute hours, storage units, messages

Credit Lifecycle

Credits जारी होने से लेकर उपयोग होने तक एक स्पष्ट lifecycle का पालन करते हैं:

Credits Issued

Credits तब दिए जाते हैं जब कोई customer attached credit entitlements वाले product (subscription या one-time) को खरीदता है। Subscriptions के लिए, प्रत्येक billing cycle में credits फिर से जारी किए जाते हैं।

Credits Consumed

ग्राहक आपकी service का उपयोग करने पर credits खर्च करते हैं। Usage-based products के लिए meters real-time events के आधार पर credits अपने-आप घटाते हैं। आप dashboard या API के माध्यम से credits manually भी घटा सकते हैं।

Credits Expire or Roll Over

Billing cycle के अंत में (या configured expiry period के बाद), unused credits आपकी settings के आधार पर expire हो जाते हैं या अगले period में rollover हो जाते हैं।

Overage Handling

यदि credits cycle के बीच में समाप्त हो जाते हैं, तो आप overage की अनुमति दे सकते हैं (balance से अधिक usage जारी रखना) और चुन सकते हैं कि overage को कैसे संभाला जाए: उसे माफ करें, उसका bill बनाएं या deficit को आगे carry करें।

Grant Sources

Credits कई sources से दिए जा सकते हैं:

स्रोत	विवरण
Subscription	Subscription खरीदने पर जारी किए गए Credits, प्रत्येक billing cycle में फिर से जारी किए जाते हैं
One-Time	One-time payment product के साथ जारी किए गए Credits
Add-on	Subscription से जुड़े add-on के साथ जारी किए गए Credits
API	API या dashboard के माध्यम से मैन्युअल रूप से दिए गए Credits
Rollover	पिछले billing cycle से आगे ले जाए गए Credits

Credits बनाना

अपने dashboard के Products → Credits section में credit entitlements बनाएं। प्रत्येक credit में unit, precision, expiry rules और lifecycle behavior define होता है।

Credits listing page showing created credit entitlements — The Credits tab under Products shows all your credit entitlements.

Navigate to Credits

अपने dashboard में Products पर जाएं और Credits tab चुनें। शुरू करने के लिए Create Credit पर क्लिक करें।

Configure Basic Information

एक Credit Name दर्ज करें—यह credit के लिए आपका internal identifier है।

Credit creation form showing basic info, general settings, and subscription settings — The credit creation form with all configuration sections.

Set General Settings

Credit type और display properties configure करें:

string

आवश्यक

Custom Unit या Fiat Credits चुनें।

Custom Unit: अपना metric परिभाषित करें (tokens, API calls, compute hours)। इसके लिए Unit Name (उदाहरण के लिए, “Platform tokens”) और Precision setting आवश्यक है।
Fiat Credits: Credits वास्तविक currency value को दर्शाते हैं। इसके लिए Unit Currency selection (USD, EUR, GBP, INR आदि) आवश्यक है।

string

केवल Custom Unit credits के लिए। इस credit के लिए customers को दिखाई देने वाला label (उदाहरण के लिए, “AI Tokens” या “API Calls”)। यह checkout और customer portal में दिखता है।

number

केवल Custom Unit credits के लिए। अनुमत decimal places की संख्या, 0 से 10 तक:

0: पूर्ण संख्याएँ (API calls जैसी गिनी जा सकने वाली items के लिए सर्वोत्तम)
1: एक decimal (0.0)
2: दो decimals (0.00)—default
3: तीन decimals (0.000)
10 तक: high-precision units के लिए (उदाहरण के लिए, fractional tokens या micro-usage)

Credit बनने के बाद precision बदली नहीं जा सकती।

string

जारी होने के बाद credits कितने समय तक valid रहते हैं:

7 days, 30 days (default), 60 days, 90 days, Custom, या Never

Custom दिनों की संख्या (न्यूनतम 1) निर्दिष्ट करने के लिए Custom चुनें।

Configure Subscription Settings (Optional)

ये settings recurring subscriptions के भीतर credit behavior नियंत्रित करती हैं:

boolean

Unused credits को अगले billing cycle में carry forward करने की अनुमति दें। सक्षम होने पर configure करें:

Max Rollover Percentage (0–100%): Carry over होने वाली मात्रा की सीमा
Rollover Timeframe: Rolled-over credits कितने समय तक valid रहते हैं (उदाहरण के लिए, 1 Month)
Max Rollover Count: Credits forfeited होने से पहले consecutive rollovers की अधिकतम संख्या

जब Credits समाप्त हो जाएं या Subscription expire हो जाए:

boolean

Customers को credit balance शून्य होने के बाद भी आपकी service का उपयोग जारी रखने दें। सक्षम होने पर configure करें:

Overage Limit: Customers अपने balance से अधिकतम कितने credits consume कर सकते हैं
Price Per Unit: Overage enabled होने पर प्रत्येक अतिरिक्त credit की cost (currency selector के साथ)

string

आवश्यक

Billing cycle के अंत में overage को कैसे संभालना है, यह नियंत्रित करता है:

Forgive overage at reset (default): Credit limit से अधिक usage को track किया जाता है, लेकिन bill नहीं किया जाता। Balance प्रत्येक cycle में reset होता है।
Bill overage at billing: Credit limit से अधिक usage को next invoice में charge किया जाता है, फिर balance reset होता है।
Carry over deficit: Credit limit से अधिक usage negative balance के रूप में अगले cycle में carry forward होता है।
Carry over deficit (auto-repay): Deficit carry forward होता है और अगले cycle में नए credits से automatically repay किया जाता है।

Create Credit

Save करने के लिए Create Credit पर क्लिक करें। अब यह credit किसी भी product से attach करने के लिए उपलब्ध है।

आपका credit entitlement तैयार है। Customers को credits जारी करना शुरू करने के लिए इसे products से attach करें।

सरल settings से शुरू करें—न rollover, न overage—और customers के credits उपयोग करने के तरीके को समझने के साथ complexity बढ़ाएं। अधिकांश settings को existing grants को प्रभावित किए बिना किसी भी समय update किया जा सकता है। ध्यान दें कि credit बनने के बाद precision बदली नहीं जा सकती।

Products से Credits Attach करना

Product creation या editing flow में credits को entitlements के रूप में products से attach किया जाता है। आप प्रत्येक product में अधिकतम 5 credits attach कर सकते हैं। Credits सभी तीन pricing types के साथ काम करते हैं।

Subscription Products

Subscriptions के लिए credits प्रत्येक billing cycle में जारी किए जाते हैं और proration, trial credits तथा cycle-specific settings के साथ configure किए जा सकते हैं।

Create or Edit a Subscription Product

Products → Create Product पर जाएं या किसी existing product को edit करें। Pricing type के रूप में Subscription चुनें और अपनी recurring price configure करें।

Open Entitlements Section

Entitlements section को expand करें और Credits के पास मौजूद Attach button पर क्लिक करें।

Product entitlements section showing Credits attach button — The Entitlements section in the product form with Credits, License Key, and Digital Product Delivery options.

Select Credits to Attach

एक Add Credits panel खुलता है। आप dropdown से existing credit चुन सकते हैं या वहीं नया credit define करने के लिए Create new credit पर क्लिक कर सकते हैं।

Add Credits panel with credit selection dropdown — The Add Credits panel lets you select existing credits or create new ones.

आप प्रत्येक product में अधिकतम 5 credits attach कर सकते हैं। प्रत्येक credit का अपना configuration हो सकता है।

Configure Credit Settings

प्रत्येक attached credit के लिए configure करें:

number

आवश्यक

प्रत्येक billing period में customer को दिए जाने वाले credits की संख्या।

number

जब बैलेंस इस प्रतिशत से कम हो जाए, तब सूचना भेजें (0–100)। ग्राहकों के क्रेडिट समाप्त होने से पहले उन्हें सचेत करने के लिए उपयोगी।

number

Trial periods के लिए अलग credit amount सेट करें। Trial के paid subscription में convert होने पर unused trial credits revoke करने के लिए Expire trial credits after trial ends सक्षम करें।

boolean

Customer द्वारा subscription plan upgrade या downgrade करने पर remaining credits को prorate करें।

boolean

Credit entitlement की default rollover, overage और expiry settings का उपयोग करें। इसे बंद करके विशेष रूप से इस product के लिए settings customize करें।

Credit configuration form with billing cycle, trial, and proration settings — Credit configuration showing per-cycle amount, trial credits, proration, and custom settings.

Review and Add

Attached credit का name, amount और expiration review करें। पुष्टि करने के लिए Add to Subscription पर क्लिक करें।

Add Credits panel showing selected credit with details — Review attached credits before adding them to the subscription.

One-Time Payment Products

One-time payments के लिए credits खरीदारी के समय एक बार जारी किए जाते हैं।

Create a One-Time Product

Single Payment pricing type वाला product बनाएं।

Product pricing section with Single Payment selected — Single Payment pricing selected for a one-time credit product.

Attach Credits

Entitlements section खोलें और credits attach करें। खरीदारी पर जारी किए जाने वाले credits की number of credits issued (कुल one-time grant) configure करें।

One-time credit products credit top-up packs, promotional bundles या prepaid credit purchases के लिए आदर्श हैं।

Usage-Based Billing Products

Usage-based products के लिए credits meters से linked होते हैं और real-time consumption events के आधार पर automatically deduct किए जाते हैं।

Create a Usage-Based Product

Pricing type के रूप में Usage Based Billing चुनें। Base price और billing frequency configure करें।

Usage Based Billing pricing configuration — Usage Based Billing pricing type with meter configuration.

Add a Meter

Meter जोड़ने के लिए Select meter section में + button पर click करें। एक subscription में अधिकतम 50 meters हो सकते हैं।

Select Meter panel showing free threshold and credit toggle — The Select Meter panel with meter configuration and credit toggle.

Enable Credit Billing on the Meter

Meter से credit attach करने के लिए Bill usage in Credits toggle करें। Dropdown से credit entitlement चुनें।

number

यह केवल तब लागू होता है जब meter money में bill करता है। जब meter credits में bill करता है, तो प्रत्येक unit credit balance से घटाई जाती है।

boolean

सक्षम होने पर meter usage, per-unit charge करने के बजाय customer के credit balance से deduct होता है।

number

आवश्यक

1 credit deduct करने के लिए आवश्यक usage units की संख्या। उदाहरण के लिए, यदि इसे 1000 पर सेट किया गया है, तो 1,000 API calls से 1 credit consume होगा।

Meter configuration with credit selection and meter units per credit — Credit attached to a meter with per-unit conversion rate.

Configure Credit Issuance

जारी किए जाने वाले credits की संख्या सेट करें और चाहें तो इस product के लिए credit settings customize करें।

Credit configuration for UBB product — Configure how many credits to issue and whether to use default settings.

Verify Attachment

Configure होने के बाद meter attached credit name, unit price और free threshold दिखाता है।

Configured meter showing credit attachment details — Meter with credit attached showing price, threshold, and credit name.

जब credits meters से link होते हैं, तो system ingested usage events के आधार पर credits automatically deduct करता है। एक background worker प्रत्येक minute में events process करता है, उन्हें meter के configuration के अनुसार aggregate करता है और customer के non-expired grants से FIFO (first-in, first-out) deduction लागू करता है—सबसे पहले उस grant से जो सबसे पहले expire होता है।

Credit Settings

Rollover

Rollover unused credits को expire होने के बजाय अगले billing cycle में carry forward करता है।

Setting	Description
Rollover Enabled	Unused credits को carry forward करने की अनुमति देने के लिए toggle करें
Max Rollover Percentage	Carry over होने वाली मात्रा सीमित करें (0–100%)। 50% पर unused credits का केवल आधा rollover होता है
Rollover Timeframe	Rolled-over credits कितने समय तक valid रहें (day, week, month, year)
Max Rollover Count	Credits को लगातार rollover किए जाने की अधिकतम संख्या। इस सीमा के बाद remaining credits forfeited हो जाते हैं

उदाहरण: Cycle के अंत में customer के पास 200 unused credits हैं। 75% rollover के साथ 150 credits आगे carry होते हैं और 50 forfeited हो जाते हैं।

Overage

Overage नियंत्रित करता है कि cycle के बीच में customer का credit balance शून्य होने पर क्या होता है।

Setting	Description
Allow Overage	Customers को अपने credit balance से अधिक service का उपयोग जारी रखने देने के लिए toggle करें
Overage Limit	Customers अपने balance से अधिकतम कितने credits consume कर सकते हैं
Price Per Unit	Overage के रूप में consume किए गए प्रत्येक अतिरिक्त credit की cost (currency के साथ)
Overage Behavior	Billing cycle के अंत में overage के साथ क्या होगा, इसे नियंत्रित करता है (नीचे देखें)

Overage Behavior options:

Behavior	Description
Forgive overage at reset	Credit limit से अधिक usage को track किया जाता है, लेकिन bill नहीं किया जाता। Balance प्रत्येक cycle में reset होता है
Bill overage at billing	Credit limit से अधिक usage को next invoice में charge किया जाता है, फिर balance reset होता है
Carry over deficit	Overage negative balance के रूप में अगले cycle में carry forward होता है
Carry over deficit (auto-repay)	Deficit carry forward होता है और अगले cycle में नए credits से automatically repay किया जाता है

जब balance zero पर पहुंचता है, तो Dodo Payments usage को block नहीं करता। यदि आप नहीं चाहते कि customers बिना credits के service का उपयोग जारी रखें, तो request serve करने से पहले अपने application में balance check करें। ऐसा overage behavior चुनें जो आपके billing model के अनुरूप हो। Forgive at reset default और सबसे सरल option है।

Expiration

Setting	Description
Credit Expiry	Issuance के बाद credits expire होने तक की duration (7, 30, 60, 90, custom days या never)
Trial Credits Expire After Trial	क्या trial-specific credits trial period समाप्त होने पर expire होते हैं

Expired credits एक credit_expired ledger entry बनाते हैं। यदि rollover enabled है, तो expiration से पहले rollover percentage लागू किया जाता है और केवल शेष credits expire होते हैं।

Credits के साथ Usage Billing

जब credits usage meters से link होते हैं, तो system एक शक्तिशाली consumption-based billing model बनाता है। Customers को credit allocation मिलता है और usage events उनके balance से automatically deduct हो जाते हैं।

Usage Billing dashboard showing events table with credits consumed — The Usage Billing dashboard shows meter events with units consumed, credits consumed, and customer details.

Meter-Based Credit Deduction कैसे काम करता है

आपका application usage events भेजता है: प्रत्येक event में customer ID, event name और metadata शामिल होते हैं
Meters events को aggregate करते हैं: Count, Sum, Max या Last aggregation का उपयोग करके
Credits automatically deduct होते हैं: एक background worker प्रत्येक minute में events process करता है, configured rate का उपयोग करके meter units को credits में convert करता है और FIFO ordering (सबसे पहले expire होने वाले grants) के अनुसार customer के balance से deduct करता है
Overage track होता है: यदि credit balance zero पर पहुंचता है और overage enabled है, तो system end-of-cycle billing के लिए overage usage track करता है

Meters Panel

Usage Billing dashboard में एक Meters panel शामिल है, जिसमें सभी defined meters उनके aggregation type के साथ सूचीबद्ध होते हैं:

Aggregation	Description	Example
Count	Events की कुल संख्या	API calls
Sum	किसी value field का योग	Total bytes transferred
Max	Record की गई सबसे अधिक value	Peak concurrent users
Last	सबसे recent value	Current storage used

Customer Experience

Checkout

जब कोई customer attached credits वाला product खरीदता है, तो checkout page product offering के हिस्से के रूप में included credits दिखाता है।

Credits product description के नीचे Includes section में दिखाई देते हैं, जिसमें credit amount और type दिखते हैं (उदाहरण के लिए, “$1000 API calls”)।

Customer Portal

Customers Credits section के अंतर्गत Customer Portal में अपने credit balances देख और manage कर सकते हैं।

Portal यह दिखाता है:

Available Balance: Current credit balance प्रमुख रूप से प्रदर्शित होता है
Credit Tabs: विभिन्न credit types के बीच switch करें (उदाहरण के लिए, “OpenAI Credits” या “Usage Tokens”)
Recent Transactions: date, transaction ID, type, amount और running balance के साथ पूरी history

Customers को दिखाए जाने वाले transaction types में शामिल हैं:

Type	Description	Amount
Credits with Subscription	Subscription purchase या renewal के साथ जारी किए गए credits	Green (+)
One-Time Credits	One-time purchases या manual grants से प्राप्त credits	Green (+)
Usage Deduction	Service usage के माध्यम से consume किए गए credits	Red (−)
Overage	Credit balance से अधिक usage	Red (−)

Subscription Details

Subscription detail page अन्य plan information के साथ credit entitlements दिखाता है।

दिखाई जाने वाली मुख्य जानकारी:

प्रत्येक billing cycle के लिए Credit allocation (उदाहरण के लिए, “1000 credits each cycle”)
Remaining balance (उदाहरण के लिए, “7500 credits remaining”)
अगली credit issuance की Renewal date
Usage History tab, जिसमें meter-level breakdown के साथ consumed units, thresholds, unit prices और total costs दिखते हैं

Transaction Details

Payment transaction pages में एक Entitlements section शामिल होता है, जिसमें payment के साथ delivered सभी entitlements, including credits, दिखाए जाते हैं।

Credits Manage करना

Dashboard Views

Credit Entitlements List

Products → Credits में अपने सभी credit entitlements देखें। Table में credit name और expiry settings दिखाई जाती हैं तथा editing या archiving के लिए quick actions उपलब्ध होते हैं।

Credits listing page in the Products section — Credits listing with total count, creation button, and management actions.

Customer Credit Details

Customers → [Customer Name] → Credits से किसी specific customer के credit balances और transaction history देखें।

Customer details page with Credits tab showing balance and transactions — Customer detail page showing credit balance and full transaction ledger.

Customer credit view में शामिल हैं:

Credit Selector - विभिन्न credit entitlements के बीच switch करें
Available Balance - Current balance बड़े और प्रमुख display में
Apply Credit/Debit - Customer के balance को manually adjust करने के लिए button
Recent Transactions - Date, transaction ID, type, amount और running balance के साथ पूरा ledger

Manual Adjustments

आप dashboard से सीधे customer के balance को manually credit या debit कर सकते हैं:

Navigate to Customer

Customers पर जाएं और customer चुनें।

Open Credits Tab

Credits tab पर click करें और wallet selector से उपयुक्त credit entitlement चुनें।

Apply Credit or Debit

Adjustment interface खोलने के लिए Apply Credit/Debit पर click करें।

string

आवश्यक

Credits जोड़ने के लिए Credit या customer के balance से credits हटाने के लिए Debit चुनें।

number

आवश्यक

जोड़ने या हटाने वाले credits की संख्या।

string

Adjustment के लिए optional explanation (उदाहरण के लिए, “Service compensation” या “Promotional bonus”)।

Confirm

Adjustment की review करके उसे apply करें। यह change customer के balance में तुरंत दिखाई देता है और credit ledger में record हो जाता है।

Manual adjustments एक manual_adjustment ledger entry बनाते हैं, जिसमें full audit trail होता है।

Credit Ledger

हर credit operation credit ledger में record होता है, जो complete audit trail प्रदान करता है:

Transaction Type	Description
Credit Added	दिए गए credits (subscription, one-time या API)
Credit Deducted	Usage या manual debit के माध्यम से consume किए गए credits
Credit Expired	Rollover के बिना expire हुए credits
Credit Rolled Over	अगले period में carry forward किए गए credits
Rollover Forfeited	Max rollover count पूरा होने के बाद forfeited rolled credits
Overage Charged	Overage enabled होने पर credit balance से अधिक usage
Overage Reset	Billing-cycle reset पर cleared tracked overage
Auto Top-Up	Low balance पर automatic credit replenishment
Manual Adjustment	Merchant द्वारा manually लागू किया गया credit या debit
Refund	Refunded credits

हर ledger entry में transaction से पहले और बाद का balance, पहले और बाद का overage, description और source का reference (payment, subscription आदि) record होता है।

Webhooks

Credit-Based Billing प्रत्येक credit lifecycle change के लिए webhook events fire करता है। इनका उपयोग अपने application को credit balances के साथ sync रखने, notifications trigger करने या custom billing workflows बनाने के लिए करें।

Event	Description
`credit.added`	Customer को credits दिए जाते हैं (subscription, one-time purchase, add-on या API के माध्यम से)
`credit.deducted`	Usage या manual debit के माध्यम से credits consume किए जाते हैं
`credit.expired`	Configured expiry period के बाद unused credits expire हो गए
`credit.rolled_over`	Cycle end पर unused credits को नए grant में carry forward किया गया
`credit.rollover_forfeited`	Max rollover count पूरा होने के कारण credits forfeited हुए
`credit.overage_charged`	Zero balance के बाद usage जारी रहने पर overage charges लागू किए गए
`credit.overage_reset`	Accumulated overage charges reset किए गए (उदाहरण के लिए, नए billing cycle की शुरुआत में)
`credit.manual_adjustment`	Dashboard या API के माध्यम से manual credit या debit adjustment किया गया
`credit.balance_low`	Credit balance configured low balance threshold से नीचे चला गया

सभी ledger events (credit.balance_low event को छोड़कर हर credit.* event) में full CreditLedgerEntry payload शामिल होता है, जिसमें पहले/बाद का balance, पहले/बाद का overage, source reference और grant के source subscription या payment का metadata शामिल होता है (API के माध्यम से सीधे बनाए गए grants के लिए empty)। credit.balance_low event में threshold configuration और current balance शामिल होते हैं।

Credit Webhook Payloads

सभी credit webhook events के लिए full payload schemas, field descriptions और integration examples देखें।

API Management

Create Credit Entitlements

Rollover, overage और expiration settings पर full control के साथ programmatically credit entitlements बनाने के लिए API का उपयोग करें।

Create Credit Entitlement

Rollover, overage और expiry configuration के साथ नया credit entitlement बनाएं।

List Credit Entitlements

अपने business के सभी credit entitlements retrieve करें।

Manage Credit Entitlements

Credit entitlements retrieve, update या delete करें। Deleted entitlements restore किए जा सकते हैं।

Get Credit Entitlement

ID के आधार पर specific credit entitlement retrieve करें।

Update Credit Entitlement

Rollover, overage, expiry या अन्य settings update करें।

Delete Credit Entitlement

Credit entitlement को soft-delete करें।

Undelete Credit Entitlement

पहले से deleted credit entitlement restore करें।

Grant and Adjust Credits

Purchase की आवश्यकता के बिना सीधे customer के balance में credits grant करें या billing adjustments के लिए manual debit entries बनाएं।

Create Ledger Entry

Full audit trail और idempotency support के साथ customer के balance को credit या debit करें।

Query Balances and Ledger

किसी भी credit entitlement के लिए customer का current credit balance, grant history और transactions का पूरा ledger retrieve करें।

List Balances

किसी credit entitlement के लिए सभी customer balances list करें।

Get Customer Balance

किसी specific customer का balance प्राप्त करें।

List Customer Grants

किसी customer के सभी credit grants देखें।

List Customer Ledger

Customer की पूरी transaction history।

Integration Example

Dodo Payments client initialize करें:

import DodoPayments from 'dodopayments';

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

Checkout के दौरान subscription product में credits attach करें:

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

ऐसे usage events भेजें जो credits को automatically deduct करें:

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

Real-World Examples

AI SaaS Platform

Pricing Structure:

Plan	Price	Credits/Month	Overage
Starter	$29/mo	10,000 tokens	$0.003/token
Pro	$99/mo	100,000 tokens	$0.002/token
Enterprise	$499/mo	1,000,000 tokens	$0.001/token

Configuration:

Credit Type: Custom Unit (“AI Tokens”)
Precision: 0 (whole tokens)
Rollover: 25% max, 1-month timeframe
Overage: Enabled, bill overage at billing
Meter: ai.generation with Sum aggregation on tokens field

API Gateway

Pricing Structure:

Plan	Price	Credits/Month	Overage
Free	$0/mo	1,000 calls	Blocked
Developer	$19/mo	50,000 calls	$0.001/call
Business	$99/mo	500,000 calls	$0.0005/call

Configuration:

Credit Type: Custom Unit (“API Calls”)
Precision: 0 (whole calls)
Rollover: Disabled
Overage: Developer+ plans allow overage (forgive at reset), Free plan disables overage
Meter: api.request with Count aggregation

Cloud Storage Service

Pricing Structure:

Plan	Price	Credits/Month	Overage
Personal	$9/mo	100 GB-hours	$0.05/GB-hour
Team	$49/mo	1,000 GB-hours	$0.03/GB-hour

कॉन्फ़िगरेशन:

क्रेडिट प्रकार: Custom Unit (“GB-hours”)
सटीकता: 2 (दो दशमलव स्थान)
रोलओवर: अधिकतम 50%, एक बार आगे ले जाया जाता है
अतिरिक्त उपयोग: सक्षम, GB-hours में अतिरिक्त उपयोग सीमा सेट की गई है
मीटर: storage.usage, Sum aggregation के साथ

Best Practices

Start simple: एक single credit type और बिना rollover के शुरू करें। Customer feedback और usage patterns के आधार पर complexity जोड़ें।
Set clear expectations: अपने product pages और customer portal में credit allocations, remaining balances और overage pricing को प्रमुख रूप से दिखाएं।
Use meaningful units: Generic terms के बजाय credits का नाम उनके representation के आधार पर रखें (उदाहरण के लिए, “API Calls” या “AI Tokens”)। इससे customers को value समझने में मदद मिलती है।
Configure expiry thoughtfully: Short expiry windows (7 days) urgency बढ़ाती हैं, लेकिन customers को निराश कर सकती हैं। अधिकांश SaaS products के लिए longer windows (30–90 days) अधिक customer-friendly होती हैं।
Monitor low balances: Customers के credits समाप्त होने से पहले alert करने के लिए low balance thresholds सेट करें, जिससे unexpected overage charges कम हों।
Test in test mode: Live जाने से पहले credits बनाएं, उन्हें test products से attach करें और पूरे purchase → usage → deduction → expiration cycle को simulate करें।

Credit-Based Billing अन्य सभी Dodo Payments features के साथ काम करता है: trials वाली subscriptions, proration के साथ plan changes और customer portal। Basic setup से शुरू करें और अपने pricing model के विकसित होने के साथ इसका विस्तार करें।

​Credit-Based Billing क्या है?

​मुख्य अवधारणाएँ

​Credit Types

​Credit Lifecycle

​Grant Sources

​Credits बनाना

​Products से Credits Attach करना

​Subscription Products

​One-Time Payment Products

​Usage-Based Billing Products

​Credit Settings

​Rollover

​Overage

​Expiration

​Credits के साथ Usage Billing

​Meter-Based Credit Deduction कैसे काम करता है

​Meters Panel

​Customer Experience

​Checkout

​Customer Portal

​Subscription Details

​Transaction Details

​Credits Manage करना

​Dashboard Views

​Credit Entitlements List

​Customer Credit Details

​Manual Adjustments

​Credit Ledger

​Webhooks

Credit Webhook Payloads

​API Management

Create Credit Entitlement

List Credit Entitlements

Get Credit Entitlement

Update Credit Entitlement

Delete Credit Entitlement

Undelete Credit Entitlement

Create Ledger Entry

List Balances

Get Customer Balance

List Customer Grants

List Customer Ledger

​Integration Example

​Real-World Examples

​Best Practices

Credit-Based Billing क्या है?

मुख्य अवधारणाएँ

Credit Types

Credit Lifecycle

Grant Sources

Credits बनाना

Products से Credits Attach करना

Subscription Products

One-Time Payment Products

Usage-Based Billing Products

Credit Settings

Rollover

Overage

Expiration

Credits के साथ Usage Billing

Meter-Based Credit Deduction कैसे काम करता है

Meters Panel

Customer Experience

Checkout

Customer Portal

Subscription Details

Transaction Details

Credits Manage करना

Dashboard Views

Credit Entitlements List

Customer Credit Details

Manual Adjustments

Credit Ledger

Webhooks

API Management

Integration Example

Real-World Examples

Best Practices