अपने Dodo Payments संसाधनों का प्रबंधन करें, चेकआउट सत्र बनाएं, और सीधे टर्मिनल से वेबहुक का परीक्षण करें। यह उन डेवलपर्स के लिए बनाया गया है जो कमांड लाइन को प्राथमिकता देते हैं।
इंस्टॉलेशन
npm install -g dodopayments-cli
मैनुअल इंस्टॉलेशन
- अपने सिस्टम के लिए GitHub Releases से नवीनतम रिलीज़ डाउनलोड करें
- बाइनरी को निकालें और उसका नाम
dodo में बदलें
- PATH में किसी डायरेक्टरी में स्थानांतरित करें:
sudo mv ./dodo /usr/local/bin/
प्रमाणीकरण
CLI का उपयोग करने से पहले, अपने API कुंजी के साथ प्रमाणित करें:
इससे:
- आपके ब्राउज़र को Dodo Payments API Keys पेज पर खोलता है
- आपसे आपकी API Key दर्ज करने के लिए कहता है
- आपसे वातावरण चुनने के लिए कहता है (Test Mode या Live Mode)
- आपके क्रेडेंशियल्स को स्थानिक रूप से
~/.dodopayments/api-key पर संग्रहीत करता है
CLI प्रत्येक वातावरण के लिए एक API कुंजी संग्रहीत करने का समर्थन करता है। यदि टेस्ट और लाइव मोड दोनों कुंजियाँ कॉन्फ़िगर की गई हैं, तो वर्तमान सत्र के लिए कौन सा वातावरण उपयोग करना है, यह चुनने के लिए आपसे पूछा जाएगा।
उपयोग
सामान्य सिंटैक्स है:
dodo ‹category› ‹sub-command›
dodo चलाने पर सभी उपलब्ध श्रेणियाँ प्रदर्शित होती हैं। किसी श्रेणी के लिए dodo <category> को उपकमान्ड के बिना चलाने पर उस श्रेणी के लिए उपलब्ध उपकमान्ड दिखते हैं।
उत्पाद
अपने उत्पाद कैटलॉग का प्रबंधन करें।
| Command | Description |
|---|
dodo products list | सभी उत्पादों की सूची बनाएं (पेजिनेटेड) |
dodo products create | एक उत्पाद बनाने के लिए डैशबोर्ड खोलें |
dodo products info | किसी विशिष्ट उत्पाद का विवरण देखें |
भुगतान
भुगतान लेनदेन देखें।
| Command | Description |
|---|
dodo payments list | सभी भुगतान सूचीबद्ध करें (पेजिनेटेड) |
dodo payments info | किसी विशिष्ट भुगतान के बारे में जानकारी प्राप्त करें |
ग्राहक
अपने ग्राहक आधार का प्रबंधन करें।
| Command | Description |
|---|
dodo customers list | सभी ग्राहकों की सूची बनाएं (पेजिनेटेड) |
dodo customers create | एक नया ग्राहक प्रोफ़ाइल बनाएं |
dodo customers update | मौजूदा ग्राहक का विवरण अपडेट करें |
छूट
कूपन और छूट का प्रबंधन करें।
| Command | Description |
|---|
dodo discounts list | सभी छूटें सूचीबद्ध करें (पेजिनेटेड) |
dodo discounts create | एक नया प्रतिशत-आधारित डिस्काउंट बनाएं |
dodo discounts delete | आईडी द्वारा डिस्काउंट हटाएं |
लाइसेंस
सॉफ्टवेयर लाइसेंस का प्रबंधन करें।
| Command | Description |
|---|
dodo licences list | सभी लाइसेंस कुंजियों की सूची बनाएं (पेजिनेटेड) |
ऐडऑन
उत्पाद ऐडऑन का प्रबंधन करें।
| Command | Description |
|---|
dodo addons list | सभी ऐडऑन सूचीबद्ध करें (पेजिनेटेड) |
dodo addons create | एक ऐडऑन बनाने के लिए डैशबोर्ड खोलें |
dodo addons info | किसी विशिष्ट ऐडऑन का विवरण देखें |
धनवापसी
धनवापसी जानकारी देखें।
| Command | Description |
|---|
dodo refund list | सभी धनवापसियों की सूची बनाएं (पेजिनेटेड) |
dodo refund info | किसी विशिष्ट धनवापसी का विवरण देखें |
चेकआउट
चेकआउट सत्र बनाएं।
| Command | Description |
|---|
dodo checkout new | एक नया चेकआउट सत्र बनाएं और चेकआउट URL प्राप्त करें |
वेबहुक परीक्षण
CLI में विकास के दौरान वेबहुक का परीक्षण करने के लिए दो शक्तिशाली उपकरण शामिल हैं: एक लिसनर जो लाइव टेस्ट वेबहुक को आपके स्थानीय सर्वर तक अग्रेषित करता है, और एक ट्रिगर जो किसी भी एंडपॉइंट को नकली वेबहुक पेलोड भेजता है।
वेबहुक सुनें
Dodo Payments से वेबहुक को सीधे अपने स्थानीय विकास सर्वर पर रीयल-टाइम में अग्रेषित करें।
Enter your local endpoint URL
वह स्थानीय URL प्रदान करें जहाँ आप वेबहुक प्राप्त करना चाहते हैं (उदाहरण के लिए, http://localhost:3000/webhook)।
Automatic setup
CLI स्वचालित रूप से आपके Dodo Payments खाते पर एक वेबहुक एंडपॉइंट बनाता है यदि पहले से मौजूद नहीं है, फिर रीयल-टाइम में ईवेंट प्राप्त करने के लिए एक WebSocket कनेक्शन खोलता है।
Receive and forward
जब कोई वेबहुक ईवेंट फायर होता है (जैसे टेस्ट भुगतान, सदस्यता परिवर्तन, आदि), CLI उसे प्राप्त करता है, ईवेंट प्रकार को लॉग करता है, और पूरी रिक्वेस्ट हेडर और शरीर के साथ आपके स्थानीय एंडपॉइंट को अग्रेषित करता है। आपके एंडपॉइंट से प्रतिक्रिया लॉग की जाती है और वापस भेजी जाती है।
वेबहुक लिसनर केवल टेस्ट मोड API कुंजी के साथ काम करता है। dodo wh listen का उपयोग करने से पहले सुनिश्चित करें कि आप टेस्ट मोड कुंजी के साथ लॉग इन हैं।
जब उसे आपके स्थानीय एंडपॉइंट पर अग्रेषित किया जाता है, लिसनर मूल वेबहुक हेडर को संरक्षित करता है (webhook-id, webhook-signature, webhook-timestamp), ताकि आप अपनी सिग्नेचर सत्यापन तर्क का परीक्षण कर सकें।
टेस्ट वेबहुक ट्रिगर करें
किसी भी एंडपॉइंट पर तेज़ परीक्षण के लिए नकली वेबहुक पेलोड भेजें बिना वास्तविक लेनदेन बनाने की आवश्यकता के।
यह आपको मार्गदर्शित करता है:
- एक गंतव्य एंडपॉइंट URL सेट करना
- वैकल्पिक रूप से Business ID, Product ID, और Metadata कॉन्फ़िगर करना
- किसी इंटरैक्टिव मेनू से ट्रिगर करने के लिए एक विशिष्ट ईवेंट चुनना
- नकली पेलोड भेजना और प्रतिक्रिया देखना
प्रत्येक ईवेंट के बाद, आप एक और ईवेंट चुन सकते हैं या बाहर निकल सकते हैं — जिससे एक ही सत्र में कई ईवेंट हैंडलर का परीक्षण करना आसान हो जाता है।
ट्रिगर टूल वेबहुक सिग्नेचर के बिना नकली पेलोड भेजता है। परीक्षण के दौरान unwrap() के बजाय unsafe_unwrap() का उपयोग करके वेबहुक सिग्नेचर सत्यापन अक्षम करें।
समर्थित वेबहुक ईवेंट
| Category | Events |
|---|
| Subscription | subscription.active, subscription.updated, subscription.on_hold, subscription.renewed, subscription.plan_changed, subscription.cancelled, subscription.failed, subscription.expired |
| Payment | payment.success, payment.failed, payment.processing, payment.cancelled |
| Refund | refund.success, refund.failed |
| Dispute | dispute.opened, dispute.expired, dispute.accepted, dispute.cancelled, dispute.challenged, dispute.won, dispute.lost |
| License | licence.created |
एनवायरनमेंट वेरिएबल्स
| Variable | Description |
|---|
DODO_WH_TEST_SERVER_URL | dodo wh listen द्वारा उपयोग किए जाने वाले डिफ़ॉल्ट वेबहुक रिले सर्वर URL को ओवरराइड करें |
संसाधन
सहायता
