नई सुविधाएँ
1. क्रेडिट-आधारित बिलिंग
Dodo Payments अब क्रेडिट-आधारित बिलिंग को सपोर्ट करता है, जो एक लचीला सिस्टम है जिससे आप सब्सक्रिप्शन्स, एकबारगी उत्पादों और उपयोग-आधारित बिलिंग में क्रेडिट अधिकार जारी, प्रबंधित और ट्रैक कर सकते हैं। प्रति उपयोग शुल्क लेने या फीचर फ्लैग के जरिए पहुंच सीमित करने के बजाय, आप एक क्रेडिट पूल आवंटित करते हैं जिससे ग्राहक सेवाओं का उपयोग करते समय खींचते हैं।
आप क्या कर सकते हैं
| क्षमता | विवरण |
|---|
| कस्टम यूनिट या फिएट क्रेडिट | अपने स्वयं के यूनिट (API कॉल, टोकन, कंप्यूट घंटे) में या वास्तविक मुद्रा मूल्य (USD, EUR) के रूप में क्रेडिट परिभाषित करें |
| सब्सक्रिप्शन क्रेडिट | हर बिलिंग चक्र में क्रेडिट जारी करें और नवीनीकरण पर स्वचालित रूप से फिर से जारी होने दें |
| वन-टाइम क्रेडिट | खरीद पर स्थिर क्रेडिट बैलेंस दें, जो टॉप-अप पैक या प्रचारात्मक बंडलों के लिए आदर्श है |
| उपयोग-आधारित कटौती | रियल-टाइम उपयोग घटनाओं के आधार पर स्वचालित कटौती के लिए क्रेडिट को मीटर से लिंक करें |
| रोलओवर | अनुपयोग किए गए क्रेडिट को आगे ले जाने की अनुमति दें, जिसमें कॉन्फ़िगर योग्य अधिकतम प्रतिशत, समयसीमा, और रोलओवर गणना हो |
| ओवरएज नियंत्रण | ग्राहकों को उनके बैलेंस से परे आपकी सेवा का उपयोग जारी रखने दें, और घाटा माफ करने, बिल भेजने, या वहन करने के विकल्प दें |
| समाप्ति | 7 दिनों से कभी नहीं तक क्रेडिट की वैधता सेट करें, कस्टम दिन गणना के साथ |
क्रेडिट जीवनचक्र
- क्रेडिट जारी किए जाते हैं - जब ग्राहक किसी उत्पाद के साथ जुड़ी क्रेडिट अधिकारिता खरीदता है तब दिए जाते हैं। सब्सक्रिप्शन्स के लिए, हर बिलिंग चक्र में क्रेडिट पुन: जारी होते हैं।
- क्रेडिट उपभोग किए जाते हैं - जैसे-जैसे ग्राहक आपकी सेवा का उपयोग करते हैं, कटौती होती है। मीटर रियल-टाइम घटनाओं के आधार पर स्वतः क्रेडिट घटाते हैं, या आप डैशबोर्ड या एपीआई के माध्यम से मैन्युअल रूप से घटा सकते हैं।
- क्रेडिट समाप्त होते हैं या रोलओवर होते हैं - बिलिंग चक्र (या कॉन्फ़िगर किए गए समाप्ति अवधि) के अंत में, अप्रयुक्त क्रेडिट या तो आपकी सेटिंग्स के अनुसार समाप्त हो जाते हैं या रोलओवर होते हैं।
- ओवरएज हैंडलिंग - यदि चक्र के बीच में क्रेडिट समाप्त हो जाते हैं, तो आप उपयोग जारी रखने की अनुमति दे सकते हैं और चक्र के अंत में ओवरएज कैसे संभालना है, चुन सकते हैं।
उत्पादों पर क्रेडिट जोड़ना
क्रेडिट उत्पाद निर्माण फ़्लो में अधिकार के रूप में जोड़े जाते हैं। आप प्रति उत्पाद अधिकतम 3 क्रेडिट जोड़ सकते हैं, और क्रेडिट सभी तीन मूल्य निर्धारण प्रकारों के साथ काम करते हैं: सब्सक्रिप्शन्स, एकबारगी भुगतान, और उपयोग-आधारित बिलिंग।
// Create a checkout session for a product with attached credits
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'
});
उपयोग-आधारित कटौती
जब क्रेडिट मीटर से जुड़े होते हैं, तो सिस्टम इनजेस्ट किए गए उपयोग घटनाओं के आधार पर स्वचालित रूप से क्रेडिट घटाता है। रूपांतरण को नियंत्रित करने के लिए प्रति क्रेडिट मीटर यूनिट दर कॉन्फ़िगर करें (जैसे, 1,000 API कॉल = 1 क्रेडिट)।
// Send usage events that deduct credits automatically
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: `gen_${Date.now()}`,
customer_id: 'cus_abc123',
event_name: 'ai.generation',
timestamp: new Date().toISOString(),
metadata: { model: 'gpt-4', tokens: 1500 }
}]
})
});
ग्राहक अनुभव
ग्राहक क्रेडिट सेक्शन में अपने उपलब्ध बैलेंस, लेन-देन इतिहास, और उपयोग ब्रेकडाउन के साथ कस्टमर पोर्टल में अपने क्रेडिट बैलेंस देख और प्रबंधित कर सकते हैं। क्रेडिट चेकआउट, सब्सक्रिप्शन विवरण, और भुगतान लेन-देन पृष्ठों पर भी दिखाई देते हैं।
Webhooks
क्रेडिट-आधारित बिलिंग हर क्रेडिट जीवनचक्र परिवर्तन के लिए वेबहुक इवेंट फायर करता है:
| इवेंट | विवरण |
|---|
credit.added | ग्राहक को क्रेडिट प्रदान किए गए |
credit.deducted | उपयोग या मैन्युअल डेबिट के माध्यम से क्रेडिट उपभोग किए गए |
credit.expired | अनुपयोग किए गए क्रेडिट की समाप्ति हुई |
credit.rolled_over | क्रेडिट को नए ग्रांट में आगे ले जाया गया |
credit.rollover_forfeited | अधिकतम रोलओवर गणना पर क्रेडिट निष्कासित किए गए |
credit.overage_charged | ओवरएज शुल्क लागू हुए |
credit.manual_adjustment | मैन्युअल क्रेडिट/डेबिट समायोजन किया गया |
credit.balance_low | बैलेंस कॉन्फ़िगर की गई सीमा से नीचे गिर गया |
सरल सेटिंग्स से शुरू करें, कोई रोलओवर नहीं, कोई ओवरएज नहीं, और जैसे-जैसे आप समझते हैं कि ग्राहक क्रेडिट का उपयोग कैसे करते हैं, जटिलता जोड़ें। अधिकांश सेटिंग्स को किसी भी समय अपडेट किया जा सकता है बिना मौजूदा ग्रांट्स को प्रभावित किए।
और जानें: Credit-Based Billing | Credit Webhook Payloads | Credit Entitlements API
2. डिज़ाइन और थीम अनुकूलन
नया डिज़ाइन पेज पेश कर रहे हैं, जो एक एकीकृत हब है जहां आप चेकआउट, स्टोरफ़्रंट, और कस्टमर पोर्टल की रूप-रेखा को एक ही स्थान से अनुकूलित कर सकते हैं। पूर्व-निर्मित थीम चुनें, टाइपोग्राफी और रंग कॉन्फ़िगर करें, तथा प्रत्येक सेक्शन के लिए ओवरराइड लागू करें, और सभी परिवर्तनों का लाइव प्रीव्यू सहेजने से पहले देखें।
मुख्य हाइलाइट्स
| विशेषता | विवरण |
|---|
| एकीकृत डिज़ाइन हब | एक ही पेज से चेकआउट, स्टोरफ़्रंट, और कस्टमर पोर्टल की उपस्थिति कॉन्फ़िगर करें |
| पूर्व-निर्मित थीम | एक परिसंपन्न थीम (Dodo Pulses, Terminal, Bumblebee, या Bubblegum) से शुरुआत करें और वहां से अनुकूलन करें |
| लाइट और डार्क मोड | प्रत्येक मोड के लिए अलग रंग पैलेट परिभाषित करें |
| लाइव प्रीव्यू | सहेजने से पहले देखें कि आपके परिवर्तन चेकआउट, कस्टमर पोर्टल, और स्टोरफ़्रंट में कैसे दिखते हैं |
| प्रति-सेक्शन ओवरराइड | अन्य सेक्शनों को प्रभावित किए बिना व्यक्तिगत सेक्शनों को परिष्कृत करें |
| प्रोग्रामेटिक नियंत्रण | एपीआई या चेकआउट SDK के माध्यम से चेकआउट समय पर थीम को ओवरराइड करें |
शुरू करना
अपने मर्चेंट डैशबोर्ड के मुख्य साइडबार में Design पर जाएं। इस पेज में चार टैब हैं:
| टैब | उद्देश्य |
|---|
| General | व्यापार का नाम, लोगो, थीम चयन, और वैश्विक उन्नत सेटिंग्स |
| Checkout | चेकआउट पेज के लिए थीम सेटिंग्स को विशेष रूप से ओवरराइड करें |
| Storefront | थीम सेटिंग्स को ओवरराइड करें और स्टोरफ़्रंट लेआउट कॉन्फ़िगर करें |
| Customer Portal | कस्टमर पोर्टल के लिए थीम सेटिंग्स ओवरराइड करें |
उन्नत सेटिंग्स
General टैब पर उन्नत सेटिंग्स को विस्तार से खोलें ताकि आप टाइपोग्राफी (प्राथमिक/माध्यमिक Google फ़ॉन्ट, फ़ॉन्ट आकार, फ़ॉन्ट वजन), रंग कॉन्फ़िगरेशन (लाइट और डार्क मोड के लिए अलग-अलग पैलेट्स जो बैकग्राउंड, टेक्स्ट, बटन, और बॉर्डर को कवर करते हैं), और यूआई एलिमेंट्स की गोलाई नियंत्रित करने के लिए बॉर्डर रेडियस पर सूक्ष्म नियंत्रण प्राप्त कर सकें।
पूर्व-निर्मित थीम
बॉक्स से बाहर चार संरचित थीम भेजी जाती हैं:
- Dodo Pulses - डिफ़ॉल्ट थीम जिसमें नीबू हरे एसेंस्ट और साफ़-सुथरी सैन्स-सेरिफ़ टाइपोग्राफी है
- Terminal - डेवलपर-केंद्रित, मोनोस्पेस्ड टाइपोग्राफी और रॉयल ब्लू एसेंस्ट के साथ
- Bumblebee - गर्म एम्बर और सोने के एसेंस्ट के साथ बोल्ड, प्रीमियम स्टाइलिंग
- Bubblegum - पूरी तरह गोल कोनों के साथ खिलंदड़ गुलाबी और मैजेंटा एसेंस्ट
एक पूर्व-निर्मित थीम चुनने के बाद, आप उन्नत सेटिंग्स में व्यक्तिगत गुणों को और अनुकूलित कर सकते हैं। किसी भी निर्दिष्ट न की गई प्रॉपर्टी थीम डिफ़ॉल्ट पर वापस चली जाती है।
और जानें: Design & Theme Customization | Checkout Features | Storefront
3. लिस्ट पेमेंट्स एपीआई में रिफंड स्थिति और विवाद स्थिति
GET /payments लिस्ट एंडपॉइंट अब प्रत्येक भुगतान आइटम में refund_status और dispute_status फील्ड शामिल करता है, जिससे आप व्यक्तिगत भुगतान विवरण प्राप्त किए बिना ही एक नज़र में रिफंड और विवाद स्थिति देख सकते हैं।
| फ़ील्ड | प्रकार | विवरण |
|---|
refund_status | partial | full | null | इस भुगतान के लिए रिफंड स्थिति का सारांश। null यदि कोई सफल रिफंड मौजूद नहीं है |
dispute_status | string | null | इस भुगतान के लिए सबसे हाल की विवाद स्थिति। null यदि कोई विवाद मौजूद नहीं है |
dispute_status मान: dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost
इन फ़ील्ड्स का उपयोग विवाद और रिफंड डैशबोर्ड बनाने के लिए, विवाद की स्थिति में बदलाव पर अलर्ट ट्रिगर करने के लिए, या उन पेमेंट्स को उजागर करने के लिए किया जा सकता है जिन्हें ध्यान देने की ज़रूरत है।
अधिक जानें: List Payments API
4. कस्टमर पोर्टल में रिफंड्स टेबल
कस्टमर पोर्टल में अब एक समर्पित रिफंड्स सेक्शन शामिल है जहाँ ग्राहक अपने पेमेंट्स से संबंधित सभी रिफंड्स देख सकते हैं। प्रत्येक रिफंड एंट्री में रिफंड की राशि, स्थिति, तारीख, और वह मूल भुगतान दिखाया गया है जिसके विरुद्ध इसे जारी किया गया था, जिससे ग्राहकों को उनके रिफंड इतिहास में पूर्ण पारदर्शिता मिलती है बिना समर्थन से संपर्क किए।
रिफंड्स टेबल स्वचालित रूप से सभी व्यवसायों के लिए कस्टमर पोर्टल में उपलब्ध है। कोई कॉन्फ़िगरेशन आवश्यक नहीं है।
अधिक जानें: कस्टमर पोर्टल
5. मीटर के लिए लाइव मोड में कॉपी करें
अब आप सीधे डैशबोर्ड से टेस्ट मोड से लाइव मोड में मीटर कॉपी कर सकते हैं। जब आप टेस्ट मोड में मीटर कॉन्फ़िगरेशन का परीक्षण कर लेते हैं, तो कॉपी एक्शन का उपयोग करके इसे लाइव मोड में समान सेटिंग्स के साथ दोहराएं: एग्रीगेशन प्रकार, इवेंट नाम, फ़िल्टर और क्रेडिट एसोसिएशन। यह विकास से उत्पादन तक जाते समय मीटर को मैन्युअल रूप से पुनः बनाने की आवश्यकता को समाप्त करता है।
पहले टेस्ट मोड में अपने मीटर कॉन्फ़िगरेशन का निर्माण और परीक्षण करें, फिर जब आप उत्पादन के लिए तैयार हों, तो उन्हें लाइव मोड में कॉपी करें। यह सुनिश्चित करता है कि आपका बिलिंग सेटअप वास्तविक ग्राहक उपयोग से पहले परीक्षण किया गया है।
अधिक जानें: उपयोग-आधारित बिलिंग | मीटर