Webhook Payloads
क्रेडिट-आधारित बिलिंग Webhooks
क्रेडिट-आधारित बिलिंग इवेंट होने पर आपके webhook endpoint पर भेजा जाने वाला payload — वर्चुअल क्रेडिट दिए गए, उपयोग किए गए, समाप्त हुए, अगले चक्र में स्थानांतरित हुए या बैलेंस अलर्ट।
क्रेडिट-आधारित बिलिंग वेबहुक इवेंट्स
निम्नलिखित वेबहुक इवेंट्स क्रेडिट-आधारित बिलिंग जीवनचक्र परिवर्तन को ट्रैक करने के लिए उपलब्ध हैं। ये इवेंट्स वर्चुअल क्रेडिट अधिकारों (API कॉल, टोकन, कंप्यूट घंटे) पर लागू होते हैं, Customer Wallets (मॉनिटरी बैलेंस) पर नहीं।लेज़र इवेंट्स
सभी लेज़र इवेंट्स (credit.added से credit.manual_adjustment तक) नीचे दिए गए स्कीमा में दस्तावेजीकृत समान CreditLedgerEntryResponse पेलोड साझा करते हैं।
लोड में वो फ़ील्ड शामिल है जिसे क्रेडिट ग्रांट के स्रोत से हल किया गया है — चेकआउट के समय बनाई गई सदस्यता या भुगतान। यह आपको अपनी चेकआउट टेक्नोलॉजी से वॉलेट क्रेडिट्स को की करने की अनुमति देता है metadata (उदाहरण के लिए, एक orgId) बजाय Dodo-मुद्रित customer_id के: सदस्यता-स्रोत ग्रांट्स सदस्यता का metadata पेश करते हैं और भुगतान-स्रोत ग्रांट्स भुगतान का metadata पेश करते हैं। जब ग्रांट का कोई हल करने योग्य स्रोत नहीं होता है (उदाहरण के लिए, सीधे API के माध्यम से प्रदान किए गए क्रेडिट्स), तो फ़ील्ड खाली होता है।
बैलेंस लो इवेंट (credit.balance_low)
credit.balance_low इवेंट एक अलग पेलोड का उपयोग करता है (CreditBalanceLowPayload) जो थ्रेशोल्ड अलर्टिंग पर केंद्रित होता है:
Proactive Alerts के लिए credit.balance_low का उपयोग करना
ग्राहकों को क्रेडिट समाप्त होने से पहले सूचित करने के लिए credit.balance_low webhook का उपयोग करें:
Get Customer Balance
API के माध्यम से ग्राहक का वर्तमान बैलेंस देखें।
Create Ledger Entry
ग्राहक के बैलेंस में मैन्युअल रूप से क्रेडिट या डेबिट करें।
Webhook Payload Schema
Response for a ledger entry
अंतिम संशोधन 26 सितंबर 2026