Credit-Based Billing

​

क्रेडिट-आधारित बिलिंग क्या है?

• AI और LLM प्लेटफ़ॉर्म: प्रत्येक प्लान टियर के लिए टोकन या जेनरेशन क्रेडिट प्रदान करें
• API सेवाएं: ओवरएज प्राइसिंग के साथ API कॉल क्रेडिट आवंटित करें
• इन्फ्रास्ट्रक्चर प्लेटफ़ॉर्म: compute घंटे या स्टोरेज क्रेडिट जारी करें
• कम्युनिकेशन सेवाएं: प्रत्येक सब्सक्रिप्शन पर संदेश या मिनट क्रेडिट प्रदान करें
• उपयोग आधारित 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 कॉल, compute घंटे) परिभाषित करें। इसके लिए एक Unit Name (जैसे “Platform tokens”) और एक Precision सेटिंग आवश्यक है।
• Fiat Credits - क्रेडिट वास्तविक मुद्रा मूल्य का प्रतिनिधित्व करते हैं। इसके लिए Unit Currency चयन (USD, EUR, GBP, INR, आदि) आवश्यक है।

​

Unit Name

string

केवल Custom Unit क्रेडिट्स के लिए। ग्राहक इस क्रेडिट के लिए जो लेबल देखते हैं (उदा., “AI Tokens”, “API Calls”)। चेकआउट और ग्राहक पोर्टल में दिखाया जाता है।

​

Precision

number

केवल Custom Unit क्रेडिट्स के लिए। अनुमत दशमलव स्थान की संख्या:

• 0 - पूर्णांक (API कॉल जैसी गिनी जाने वाली वस्तुओं के लिए सर्वोत्तम)
• 1 - एक दशमलव (0.0)
• 2 - दो दशमलव (0.00) - डिफ़ॉल्ट
• 3 - तीन दशमलव (0.000)

एक बार क्रेडिट बनने के बाद प्रिसीजन बदली नहीं जा सकती।

​

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 महीना)
• Max Rollover Count - अधिकतम लगातार रोल-ओवर की संख्या जिसके बाद क्रेडिट जब्त हो जाते हैं

जब क्रेडिट खत्म हो जाएं या सब्सक्रिप्शन समाप्त हो जाए:

​

Allow Overage

boolean

जब उनका क्रेडिट बैलेंस शून्य हो जाए तब भी ग्राहकों को आपकी सेवा का उपयोग जारी रखने दें। सक्षम होने पर, कॉन्फ़िगर करें:

• 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 पर क्लिक करके वहीं एक नया परिभाषित कर सकते हैं।

आप प्रत्येक उत्पाद पर अधिकतम 3 क्रेडिट संलग्न कर सकते हैं। हर क्रेडिट की अपनी कॉन्फ़िगरेशन हो सकती है।

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 सेक्शन खोलें और क्रेडिट जोड़ें। खरीद के समय जारी किए जाने वाले क्रेडिट की संख्या (कुल एक-समय अनुदान) को कॉन्फ़िगर करें।

​

उपयोग-आधारित बिलिंग उत्पाद

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 सेट किया गया है, तो 1,000 API कॉल्स 1 क्रेडिट का उपभोग करते हैं।

4

Configure Credit Issuance

जारी किए गए क्रेडिट की संख्या सेट करें और इच्छानुसार इस उत्पाद के लिए क्रेडिट सेटिंग्स अनुकूलित करें।

5

Verify Attachment

एक बार कॉन्फ़िगर होने पर, मीटर संलग्न क्रेडिट का नाम, यूनिट कीमत, और मुफ्त थ्रेशोल्ड दिखाता है।

​

क्रेडिट सेटिंग्स

​

रोलओवर

​

ओवरएज

​

एक्सपायरी

​

क्रेडिट के साथ उपयोग बिलिंग

​

मीटर-आधारित क्रेडिट कटौती कैसे काम करती है

1. आपका एप्लिकेशन उपयोग घटनाएं भेजता है - प्रत्येक घटना में ग्राहक आईडी, घटना नाम, और मेटाडेटा शामिल होता है
2. मीटर घटनाओं को समेकित करते हैं - Count, Sum, Max, Last, या Unique Count संक्षेप का उपयोग करते हुए
3. क्रेडिट स्वचालित रूप से घटाए जाते हैं - एक बैकग्राउंड वर्कर हर मिनट घटनाओं को प्रोसेस करता है, मीटर यूनिट्स को आपकी कॉन्फ़िगर दर से क्रेडिट में परिवर्तित करता है, और FIFO क्रम (सबसे पुराने अनुदान पहले) का उपयोग करते हुए ग्राहक के बैलेंस से घटाता है
4. ओवरएज ट्रैक किया जाता है - यदि क्रेडिट बैलेंस शून्य तक पहुँचता है और ओवरएज सक्षम है, तो सिस्टम साइकिल के अंत में बिलिंग के लिए ओवरएज उपयोग को ट्रैक करता है

​

मीटर पैनल

​

ग्राहक अनुभव

​

चेकआउट

​

ग्राहक पोर्टल

• Available Balance - वर्तमान क्रेडिट बैलेंस प्रमुख रूप से प्रदर्शित
• Credit Tabs - विभिन्न क्रेडिट प्रकारों (उदा., “OpenAI Credits”, “Usage Tokens”) के बीच स्विच करें
• Recent Transactions - दिनांक, लेन-देन आईडी, प्रकार, राशि, और रनिंग बैलेंस सहित पूर्ण इतिहास

​

सब्सक्रिप्शन विवरण

• प्रत्येक बिलिंग चक्र के लिए क्रेडिट आवंटन (उदा., “प्रत्येक चक्र में 1000 क्रेडिट”)
• शेष बैलेंस (उदा., “7500 क्रेडिट शेष”)
• अगले क्रेडिट निर्गमन के लिए नवीनीकरण तिथि
• मीटर-स्तर ब्रेकडाउन के साथ उपयोग इतिहास टैब जिसमें उपयोग किए गए यूनिट, थ्रेशोल्ड, यूनिट कीमतें, और कुल लागत दिखती हैं

​

लेन-देन विवरण

​

क्रेडिट प्रबंधन

​

डैशबोर्ड दृश्य

​

क्रेडिट अधिकार सूची

​

ग्राहक क्रेडिट विवरण

• Credit Selector - विभिन्न क्रेडिट अधिकारों के बीच स्विच करें
• Available Balance - बड़े, प्रमुख प्रदर्शन में वर्तमान बैलेंस
• Apply Credit/Debit - ग्राहक के बैलेंस को मैन्युअली समायोजित करने के लिए बटन
• Recent Transactions - दिनांक, लेन-देन आईडी, प्रकार, राशि, और रनिंग बैलेंस के साथ पूर्ण लेज़र

​

मैन्युअल समायोजन

​

क्रेडिट लेज़र

​

वेबहुक

​

API प्रबंधन

​

एकीकरण उदाहरण

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 fetch('https://api.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `gen_${Date.now()}`,
      customer_id: 'cus_abc123',
      event_name: 'ai.generation',
      timestamp: new Date().toISOString(),
      metadata: { model: 'gpt-4', tokens: 1500 }
    }]
  })
});

​

वास्तविक दुनिया के उदाहरण

​

सर्वोत्तम अभ्यास

• सरल से शुरू करें: एक ही क्रेडिट प्रकार और कोई रोलओवर न रखें। ग्राहक प्रतिक्रिया और उपयोग पैटर्न के आधार पर जटिलता जोड़ें।
• स्पष्ट अपेक्षाएं सेट करें: अपने उत्पाद पृष्ठों और ग्राहक पोर्टल में क्रेडिट आवंटन, शेष बैलेंस, और ओवरएज मूल्य निर्धारण स्पष्ट रूप से दिखाएं।
• अर्थपूर्ण यूनिट का उपयोग करें: क्रेडिट्स का नाम उनके प्रतिनिधित्व के अनुसार रखें (उदा., “API Calls”, “AI Tokens”) बजाय सामान्य शब्दों के। इससे ग्राहक मूल्य समझते हैं।
• एक्सपायरी को विचारपूर्वक कॉन्फ़िगर करें: छोटी एक्सपायरी विंडो (7 दिन) तात्कालिकता पैदा करती हैं लेकिन ग्राहक को निराश कर सकती हैं। अधिकांश SaaS उत्पादों के लिए लंबी विंडो (30–90 दिन) अधिक ग्राहक-मित्रता प्रदान करती हैं।
• निम्न बैलेंस की निगरानी रखें: ओवरएज शुल्क के आश्चर्य को कम करने के लिए ग्राहकों को खत्म होने से पहले अलर्ट करने के लिए निम्न बैलेंस थ्रेशोल्ड सेट करें।
• टेस्ट मोड में परीक्षण करें: क्रेडिट बनाएं, उन्हें परीक्षण उत्पादों से संलग्न करें, और लाइव होने से पहले पूर्ण खरीद → उपयोग → कटौती → एक्सपायरी चक्र का अनुकरण करें।

await fetch('https://api.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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

​

Best Practices

• Start simple: Begin with a single credit type and no rollover. Add complexity based on customer feedback and usage patterns.
• Set clear expectations: Display credit allocations, remaining balances, and overage pricing prominently in your product pages and customer portal.
• Use meaningful units: Name credits after what they represent (e.g., “API Calls”, “AI Tokens”) rather than generic terms. This helps customers understand value.
• Configure expiry thoughtfully: Short expiry windows (7 days) drive urgency but may frustrate customers. Longer windows (30–90 days) are more customer-friendly for most SaaS products.
• Monitor low balances: Set low balance thresholds to alert customers before they run out, reducing surprise overage charges.
• Test in test mode: Create credits, attach them to test products, and simulate the full purchase → usage → deduction → expiration cycle before going live.