Skip to main content

परिचय

Dodo Payments for WooCommerce प्लगइन आपके स्टोर के checkout में Dodo Payments को भुगतान विधि के रूप में जोड़ता है। ग्राहक Dodo Payments checkout page पर भुगतान करते हैं, जहाँ उनके स्थान, मुद्रा और डिवाइस के लिए उपलब्ध भुगतान विधियाँ, जैसे cards, digital wallets और UPI, दिखाई जाती हैं। इसके बाद Dodo Payments के webhooks WooCommerce में ऑर्डर की स्थिति अपडेट करते हैं।
इस प्लगइन के लिए WordPress 6.1 या बाद का संस्करण, PHP 7.4 या बाद का संस्करण और WooCommerce 7.9 या बाद का संस्करण आवश्यक है। Subscriptions बेचने के लिए आपको WooCommerce Subscriptions extension की भी आवश्यकता होगी।
यह प्लगइन classic WooCommerce checkout के साथ काम करता है। यह block-based checkout या physical product shipping का समर्थन नहीं करता और प्रति ऑर्डर केवल एक percentage discount code स्वीकार करता है।

चरण-दर-चरण इंस्टॉलेशन गाइड

  1. GitHub पर नवीनतम release से dodo-payments-for-woocommerce.zip डाउनलोड करें।

    Download Plugin

    WooCommerce के लिए Dodo Payments प्लगइन का नवीनतम संस्करण प्राप्त करें
    आप WordPress plugin directory से भी प्लगइन इंस्टॉल कर सकते हैं। Add Plugins पेज पर Dodo Payments for WooCommerce खोजें, Install Now पर क्लिक करें, फिर Activate पर क्लिक करें और configuration guide के साथ आगे बढ़ें।

    WordPress Plugin Directory

    WordPress.org से Dodo Payments for WooCommerce इंस्टॉल करें
  2. Administrator के रूप में अपनी WordPress साइट में लॉग इन करें। WooCommerce इंस्टॉल और active होना चाहिए।
  3. Plugins → Add New Plugin पर जाएँ।
    Plugins मेनू खुला हुआ WordPress admin sidebar
  4. Upload Plugin पर क्लिक करें। एक upload form दिखाई देगा।
    Upload Plugin बटन वाला Add Plugins पेज
    Browse बटन और Install Now बटन वाला प्लगइन upload form
  5. Browse… पर क्लिक करें और डाउनलोड की गई zip file चुनें।
  6. Install Now पर क्लिक करें।
    चयनित प्लगइन zip file और Install Now बटन वाला प्लगइन upload form
  7. इंस्टॉलेशन पूरा होने पर Activate Plugin पर क्लिक करें। आप बाद में Plugins → Installed Plugins से भी प्लगइन activate कर सकते हैं।
    Activate Plugin बटन वाला प्लगइन सफलतापूर्वक इंस्टॉल होने का संदेश
  8. प्लगइन इंस्टॉल हो गया है, लेकिन अभी configure नहीं किया गया है। नीचे दिए गए configuration guide के साथ आगे बढ़ें।

Configuration Guide

API Keys और Webhooks सेट अप करना

प्लगइन को प्रत्येक Dodo Payments mode से दो values की आवश्यकता होती है: checkouts बनाने के लिए एक API key और आपके orders को अपडेट करने वाले webhooks को verify करने के लिए एक webhook signing key। इन चरणों से live mode सेट अप होता है।
  1. WooCommerce → Settings → Payments पर जाएँ, या sidebar में WooCommerce के अंतर्गत Payments पर क्लिक करें।
    Dodo Payments सक्रिय होने और Manage बटन के साथ WooCommerce payment settings
    Payments हाइलाइट किए गए विकल्प वाला WooCommerce sidebar menu
  2. अगर Dodo Payments सक्रिय नहीं है, तो उसे चालू करें, फिर Manage पर क्लिक करें।
  3. Plugin settings खुलेंगी और हर option के नीचे एक description होगा। जाँचें कि Enable Dodo Payments चुना गया है, फिर Live API Key से शुरू करें।
    Enable/Disable, Title, Description, Instructions, Test Mode और Live API Key fields वाली Dodo Payments plugin settings
  4. Dodo Payments dashboard में sidebar का Live Mode switch चालू करें। Developer → API Keys पर जाएँ, या इस direct link का उपयोग करें और Add API key पर क्लिक करें।
    बिना किसी key और Add API key बटन वाला Dodo Payments API Keys page
  5. Key के लिए कोई नाम दर्ज करें, जैसे WooCommerce Plugin, और Create पर क्लिक करें।
    WooCommerce Plugin नाम और Create बटन वाला Create New API dialog
  6. Copy API Key पर क्लिक करें। Dashboard key को केवल एक बार दिखाता है। इसे plugin settings में Live API Key में paste करें।
    Copy API Key और Close बटन वाला New API key dialog
    Plugin settings में Live API Key field
  7. अब webhook signing key सेट करें। Dodo Payments webhook के माध्यम से आपके store को payment updates भेजता है, और plugin इस key का उपयोग यह verify करने के लिए करता है कि प्रत्येक webhook Dodo Payments से आया है।
  8. Plugin settings के सबसे नीचे, Webhook Endpoint के अंतर्गत, URL copy करें। इसका format https://your-store.com/?wc-api=dodo_payments है।
    Plugin settings के सबसे नीचे Save changes बटन के ऊपर Webhook Endpoint URL
  9. Dodo Payments dashboard में, अभी भी live mode में, Developer → Webhooks पर जाएँ और Add endpoint पर क्लिक करें।
    बिना endpoints और Add endpoint बटन वाला live mode में Webhooks page
  10. Step 8 का URL Endpoint URL में paste करें। प्रत्येक event प्राप्त करने के लिए Subscribed events को खाली छोड़ें, या केवल payment, refund और subscription events चुनें, जिन्हें plugin handle करता है। फिर Create endpoint पर क्लिक करें।
    Endpoint URL में WooCommerce webhook URL वाला Add endpoint dialog
  11. Endpoint का Overview tab खुलता है। Signing secret के अंतर्गत secret दिखाने के लिए eye icon पर क्लिक करें, फिर copy icon पर क्लिक करें।
    छिपे हुए signing secret, reveal और copy icons तथा Rotate secret वाला Endpoint Overview tab
  12. Secret को plugin settings में Live Webhook Signing Key में paste करें, फिर Save changes पर क्लिक करें।
    Plugin settings में Live Webhook Signing Key field
  13. Global Tax Category और All Prices are Tax Inclusive की समीक्षा करें। जब plugin Dodo Payments में कोई product बनाता है, तब इन्हें लागू करता है। यह पहली बार होता है जब कोई customer उस product से checkout करता है। इसके बाद product में Dodo Payments dashboard की tax settings बनी रहती हैं, जहाँ आप उन्हें प्रत्येक product के लिए बदल सकते हैं। Test API Key और Test Webhook Signing Key केवल Test Mode के लिए आवश्यक हैं।
    Test API Key, Test Webhook Signing Key, Global Tax Category और All Prices are Tax Inclusive settings
Checkout Feature Flags के अंतर्गत, आप Dodo Payments checkout page के options को भी नियंत्रित कर सकते हैं, जैसे Allow Currency Selection और Allow Discount Codes। Default पर छोड़ा गया flag भेजा नहीं जाता, इसलिए Dodo Payments अपना default लागू करता है।
Test payments लेने के लिए plugin settings में Test Mode चालू करें। इसके बाद plugin Test API Key और Test Webhook Signing Key का उपयोग करता है और Dodo Payments test environment से connect होता है। Test mode में अलग API keys और webhook endpoints होते हैं। इन्हें प्राप्त करने के लिए dashboard में Live Mode switch बंद करें, test mode में steps 4 से 12 का पालन करें और values को test fields में paste करें। Live होने से पहले Test Mode बंद कर दें।

अब आप तैयार हैं!

Customers अब checkout पर Dodo Payments चुन सकते हैं।
Billing form और Place order बटन वाला WooCommerce checkout page
जब कोई customer order देता है, तो plugin payment के लिए उसे Dodo Payments checkout page पर भेजता है। Payment के बाद Dodo Payments webhook भेजता है और plugin order status अपडेट करता है।
Card, UPI QR code और UPI ID payment options वाला Dodo Payments checkout page

मुख्य सुविधाएँ

  • Hosted Checkout: Customers Dodo Payments checkout page पर payment करते हैं, फिर आपके store के order confirmation page पर लौटते हैं।
  • Multiple Payment Methods: Checkout प्रत्येक customer के location, currency और device के लिए उपलब्ध payment methods दिखाता है।
  • Order Status Sync: Payment status बदलने पर webhooks order को Completed, Processing, Failed या Cancelled पर सेट करते हैं। Failed और cancelled payments items को stock में वापस कर देते हैं।
  • Refunds: Dodo Payments dashboard से refunds जारी करें। Refund सफल होने पर plugin order को Refunded पर सेट करता है।
  • Subscriptions: WooCommerce Subscriptions के साथ status changes दोनों दिशाओं में sync होते हैं, जिसमें subscription के cancelled, suspended या reactivated होने पर होने वाले changes भी शामिल हैं। WooCommerce में subscription dates के changes sync नहीं होते।
  • Order Notes: Plugin प्रत्येक checkout session, status change और error के लिए order notes जोड़ता है, ताकि आप order page से प्रत्येक payment को track कर सकें।
  • Multi-currency Support: Products आपके WooCommerce store currency में Dodo Payments से sync होते हैं। Allow Currency Selection flag यह नियंत्रित करता है कि customers checkout पर currency बदल सकते हैं या नहीं।

समस्या निवारण

सामान्य समस्याएँ

  1. Payment Processing Failures
    • जाँचें कि API key plugin mode से match करती है। Test Mode बंद होने पर plugin Live API Key का उपयोग करता है, जो live mode में dashboard से प्राप्त की गई होनी चाहिए। Test Mode चालू होने पर यह Test API Key का उपयोग करता है।
    • Order notes देखें। जब plugin checkout create नहीं कर पाता, तो यह error वाली note जोड़ता है, जैसे जो Dodo Payments Error: से शुरू होती है।
    • यदि checkout पर Dodo Payments दिखाई नहीं देता, तो जाँचें कि आपका checkout page classic checkout का उपयोग करता है, Checkout block का नहीं।
    • यदि order में discount code है, तो जाँचें कि वह single percentage code है।
    • आपके account के Account Verification पास करने के बाद live payments शुरू होते हैं।
  2. Webhook Synchronization Problems
    • जाँचें कि Endpoint URL, plugin settings में Webhook Endpoint के अंतर्गत दिए गए exact URL से match करता है।
    • जाँचें कि plugin में signing key endpoint के Signing secret से match करती है और दोनों एक ही mode से हैं।
    • अपने PHP error log में उन lines को देखें जो Dodo Payments: से शुरू होती हैं, जैसे Dodo Payments: Could not verify webhook event। Live mode में verification विफल होने पर भी plugin 200 लौटाता है, इसलिए Dodo Payments logs delivery को successful दिखाते हैं। Test Mode में यह 401 लौटाता है।
    • जाँचें कि आपकी site पर valid SSL certificate है। Endpoint URL केवल HTTPS URLs स्वीकार करता है।
    • जाँचें कि आपका server, firewall और security plugins Dodo Payments IP addresses से webhook URL पर आने वाले POST requests स्वीकार करते हैं।
    • प्रत्येक delivery और आपकी site की response देखने के लिए Developer → Webhooks में Logs tab खोलें।

सहायता संसाधन

अधिक सहायता के लिए:

Maintenance Best Practices

  1. Security fixes और नई सुविधाएँ पाने के लिए नया version जारी होने पर plugin update करें।
  2. Live payments लेने से पहले Test Mode में सभी payment flows का परीक्षण करें।
  3. WordPress और WooCommerce को up to date रखें।
  4. अपनी site का नियमित backup लें।
  5. असामान्य activity के लिए अपने orders और Dodo Payments dashboard पर नज़र रखें।
  6. API keys को सुरक्षित रूप से store करें और उन्हें कभी भी सार्वजनिक रूप से share न करें।
अंतिम संशोधन 26 सितंबर 2026