Paddle जोड़ें

Paddle उस सॉफ़्टवेयर का merchant of record है जिसे आप ऐप स्टोर के बाहर बेचते हैं: डेस्कटॉप ऐप, वेब ऐप, SaaS प्लान और लाइसेंस। यह OAuth के बजाय एक ही केवल-पढ़ने वाली API key से जुड़ता है। आप Paddle डैशबोर्ड में key बनाते हैं, उसे Revenue Sensor में पेस्ट करते हैं और चुनते हैं कि कौन-से Paddle प्रोडक्ट सिंक करने हैं। key एन्क्रिप्ट करके रखी जाती है और कभी हमारे सर्वर से बाहर नहीं जाती; आपका Paddle लॉगिन कभी इस्तेमाल नहीं होता।

शुरू करने से पहले

• जिस सेलर अकाउंट की बिक्री ट्रैक करनी है, उसके Paddle डैशबोर्ड का एक्सेस, और Developer tools में API key बनाने की अनुमति।
• यह तय हो कि आपको live अकाउंट चाहिए या sandbox। Paddle दोनों के लिए अलग-अलग key जारी करता है, और key ही तय करती है कि हम कौन-सा पढ़ेंगे; इसके अलावा कुछ और चुनना नहीं है।

केवल-पढ़ने वाली API key बनाएँ

1. 1

   Developer tools खोलें

   Paddle डैशबोर्ड में Developer tools → Authentication पर जाएँ और एक नई API key बनाएँ। उसे ऐसा नाम दें जिसे आप बाद में पहचान सकें, जैसे "Revenue Sensor"।

2. 2

   सिर्फ़ पढ़ने की अनुमति दें

   Transactions, Adjustments, Products और Addresses के लिए read एक्सेस पर टिक करें। Addresses, Customers के नीचे दिखता है और हमें खरीदार का देश बताता है, इसलिए भले ही यह असंबंधित लगे, इसे रहने दें। write अनुमति की ज़रूरत नहीं है।

3. 3

   key एक ही बार कॉपी करें

   Paddle key को बनाते समय सिर्फ़ एक बार दिखाता है। उसे तुरंत कॉपी कर लें; अगर खो जाए तो उसे रद्द करके नई बनाएँ।

खाता जोड़ें

1. 1

   key पेस्ट करें

   Revenue Sensor कंसोल में Integrations → Paddle → Connect पर जाएँ और API key पेस्ट करें। Revenue Sensor key का प्रीफ़िक्स पढ़कर live और sandbox key में फ़र्क़ करता है और आगे बढ़ने से पहले बताता है कि कौन-सा इस्तेमाल होगा।

2. 2

   अपने प्रोडक्ट चुनें

   जो यूनिट आप सिंक करते हैं वे Paddle प्रोडक्ट हैं, स्टोर ऐप नहीं। जिन प्रोडक्ट को लेजर में चाहिए उन्हें चुनें; हर एक रेवेन्यू में अपनी अलग लाइन के रूप में दिखता है और अगर किसी ऐप का हिस्सा है तो उससे मैप किया जा सकता है। सिर्फ़ वही लाया जाता है जो आप चुनते हैं, और सिर्फ़ वही आपके प्लान में गिना जाता है।

3. 3

   पहला सिंक पूरा होने दें

   Paddle आपका पूरा इतिहास रखता है, इसलिए पहला सिंक एक साल तक की भुगतान की गई ट्रांज़ैक्शन और रिफ़ंड भर देता है। इसमें आमतौर पर कुछ मिनट लगते हैं और चलते समय आप पेज छोड़ सकते हैं।

क्या इंपोर्ट होता है

रीयल-टाइम अपडेट (वैकल्पिक)

Revenue Sensor हर 30 मिनट में Paddle सिंक करता है। अगर आप नई बिक्री या रिफ़ंड को एक-दो मिनट में देखना चाहते हैं, तो Paddle का एक notification destination हमारी ओर पॉइंट करें। आँकड़े फिर भी Paddle के API से ही आते हैं; webhook सिर्फ़ हमें जल्दी सिंक करने को कहता है।

1. 1

   webhook URL कॉपी करें

   Revenue Sensor कंसोल में Paddle कनेक्शन खोलें। "Real-time updates" पैनल एक URL दिखाता है जो सिर्फ़ इसी कनेक्शन के लिए है; उसे कॉपी करें।

2. 2

   notification destination बनाएँ

   Paddle में Developer tools → Notifications → New destination पर जाएँ। URL पेस्ट करें, टाइप में Webhook चुनें, और transaction, adjustment और subscription इवेंट सब्सक्राइब करें।

3. 3

   secret सेव करें

   destination बनने पर Paddle एक signing secret दिखाता है। उसे "Real-time updates" पैनल में पेस्ट करके सेव करें। हम इससे हर डिलीवरी की जाँच करते हैं और बिना हस्ताक्षर वाली हर चीज़ हटा देते हैं; यह एन्क्रिप्ट करके रखा जाता है और दोबारा कभी नहीं दिखाया जाता।

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

• key अस्वीकार हो रही है: जाँचें कि उसके पास Transactions, Adjustments, Products और Addresses — चारों का read एक्सेस है। Addresses के बिना key बुनियादी जाँच पास कर लेती है लेकिन सिंक में फ़ेल हो जाती है।
• कोई प्रोडक्ट नहीं दिख रहा: key किसी दूसरे अकाउंट की है, या आप live की उम्मीद कर रहे थे और यह sandbox की है (या इसका उल्टा)। key का प्रीफ़िक्स बताता है कि कौन-सी है।
• कोई बिक्री गायब है: सिर्फ़ भुगतान की गई, पूरी हो चुकी ट्रांज़ैक्शन इंपोर्ट होती हैं। ड्राफ़्ट, बिना भुगतान वाले इनवॉइस और रद्द की गई ट्रांज़ैक्शन अभी रेवेन्यू नहीं हैं।
• रेवेन्यू आपके पेआउट से ज़्यादा दिख रहा है: यह अपेक्षित है। टैक्स अलग रखा जाता है और Paddle की फ़ीस नहीं घटाई जाती, इसलिए यह आँकड़ा Paddle के हिस्से से पहले का ग्रॉस रेवेन्यू है।
• रिफ़ंड बिक्री से अलग दिन पर दिख रहा है: रिफ़ंड जिस दिन मंज़ूर होते हैं उसी दिन दर्ज होते हैं, मूल खरीद की तारीख पर पीछे नहीं ले जाए जाते।