लाइव डेमो

ट्रैवल सॉफ़्टवेयर के लिए पेमेंट

Paddle API इंटीग्रेशन: ट्रैवल बिज़नेस के लिए मर्चेंट ऑफ रिकॉर्ड कब सही बैठता है

Paddle मर्चेंट ऑफ रिकॉर्ड के तौर पर आपकी ओर से सॉफ़्टवेयर, SaaS और डिजिटल प्रोडक्ट बेचता है। अपनी सब्सक्रिप्शन का बिल बनाने वाली ट्रैवल टेक्नोलॉजी कंपनी के लिए यह मज़बूत विकल्प है, लेकिन फ़्लाइट, होटल और टूर का पैसा लेने के लिए आमतौर पर गलत औज़ार है। यह पेज अंतर समझाता है, बताता है कि Paddle इंटीग्रेशन कैसे काम करता है, और आपका उपयोग मेल खाए तो इसे PHPTRAVELS से कैसे जोड़ें।

  • मर्चेंट ऑफ रिकॉर्ड, गेटवे नहीं
  • सॉफ़्टवेयर और सब्सक्रिप्शन के लिए बना
  • साइन किए हुए वेबहुक
  • कस्टम इंटीग्रेशन के रूप में जुड़ा

दो अलग मॉडल

मर्चेंट ऑफ रिकॉर्ड बनाम पेमेंट गेटवे

पेमेंट गेटवे आपके लिए पैसा आगे बढ़ाता है: विक्रेता आप हैं, पेमेंट कंपनी कार्ड प्रोसेस करती है, और टैक्स, इनवॉइस, रिफ़ंड और विवाद आपकी ही ज़िम्मेदारी रहते हैं। मर्चेंट ऑफ रिकॉर्ड एक कदम और आगे जाकर ग्राहक और टैक्स अधिकारियों की नज़र में खुद विक्रेता बन जाता है। जब कोई Paddle से खरीदता है तो Paddle उसे बेचता है, सेल्स टैक्स या VAT वसूलकर जमा करता है, इनवॉइस जारी करता है, चार्जबैक संभालता है और फिर आपका हिस्सा आपको चुकाता है।

यह मॉडल सॉफ़्टवेयर कंपनी का बहुत सारा टैक्स और कंप्लायंस का काम बचाता है, लेकिन इसका मतलब यह भी है कि Paddle खुद तय करता है कि वह क्या दोबारा बेचने को तैयार है। इसका प्लेटफ़ॉर्म सॉफ़्टवेयर, SaaS और डिजिटल प्रोडक्ट के लिए बना है, एयरलाइन, होटल और टूर ऑपरेटर की दी जाने वाली यात्रा सेवाओं के लिए नहीं। कार्ड पेमेंट की सामान्य कार्यप्रणाली पेमेंट गेटवे API पेज पर है।

पेमेंट फ़्लो का डायग्राम जिसमें ग्राहक ऑनलाइन भुगतान कर रहा है और पेमेंट, टैक्स व भुगतान की ज़िम्मेदारियाँ विक्रेता और पेमेंट प्रदाता के बीच जा रही हैं
सवालPaddle (मर्चेंट ऑफ रिकॉर्ड)पेमेंट गेटवे
विक्रेता कौन है?Paddle रिकॉर्ड पर विक्रेता है। ग्राहक की रसीद और कार्ड स्टेटमेंट Paddle की ओर से आते हैं।विक्रेता आप हैं। गेटवे सिर्फ़ आपके मर्चेंट अकाउंट पर पेमेंट प्रोसेस करता है।
सेल्स टैक्स और VAT कौन संभालता है?Paddle जिन जगहों पर बेचता है वहाँ सेल्स टैक्स और VAT की गणना, वसूली और जमा खुद करता है।आप, अपने टैक्स रजिस्ट्रेशन, अकाउंटेंट और इनवॉइसिंग के ज़रिए।
इनवॉइस कौन जारी करता है?Paddle खरीदार को इनवॉइस या रसीद जारी करता है।आपका अपना सिस्टम, जैसे एडमिन में बुकिंग इनवॉइस।
चार्जबैक कौन संभालता है?Paddle विक्रेता के रूप में विवाद और चार्जबैक संभालता है।आप गेटवे के डैशबोर्ड या API से सबूत के साथ विवादों का जवाब देते हैं।
आप क्या बेच सकते हैं?सॉफ़्टवेयर, SaaS, सब्सक्रिप्शन और डिजिटल प्रोडक्ट, Paddle के स्वीकार्य उपयोग नियमों के भीतर।वह बिक्री जिसे गेटवे मंज़ूर करता है, कई ट्रैवल मर्चेंट के लिए ट्रैवल बुकिंग समेत।
आपको भुगतान कैसे मिलता है?Paddle अपनी फ़ीस काटकर अपने भुगतान शेड्यूल के अनुसार आपकी कमाई चुकाता है।कैप्चर किए गए पेमेंट गेटवे की फ़ीस घटाकर आपके मर्चेंट या बैंक अकाउंट में सेटल होते हैं।

फ़ीस, समर्थित देश और अनुमत प्रोडक्ट की सटीक सूची Paddle तय करता है और समय के साथ बदलती रहती है। इस पर योजना बनाने से पहले Paddle की अपनी शर्तें देख लें।

निर्णय में मदद

क्या Paddle आपकी बिक्री के लिए सही है?

इससे शुरू करें कि ग्राहक किस चीज़ का भुगतान कर रहा है। जो स्थिति आपके बिज़नेस के सबसे करीब हो उसे चुनें।

01

यात्री फ़्लाइट, होटल और टूर का भुगतान करते हैं

ग्राहक ऐसी यात्रा खरीद रहा है जिसे एयरलाइन, होटल या टूर ऑपरेटर पूरा करता है। ऐसे पेमेंट में अक्सर अभी ऑथराइज़ और बाद में कैप्चर, रद्द करने की फ़ीस के बाद आंशिक रिफ़ंड और कई मुद्राओं में चेकआउट चाहिए होता है।

हमारी राय

पेमेंट गेटवे इस्तेमाल करें

ट्रैवल बुकिंग के लिए Paddle इस्तेमाल करने से पहले उसके स्वीकार्य उपयोग नियम देख लें। ज़्यादातर ट्रैवल बिज़नेस बुकिंग के पेमेंट Stripe, PayPal, Adyen या किसी क्षेत्रीय गेटवे जैसे पेमेंट गेटवे से लेते हैं।

02

आप अपना ट्रैवल सॉफ़्टवेयर या SaaS बेचते हैं

आप ट्रैवल टेक्नोलॉजी विक्रेता हैं और एजेंसियाँ आपके बुकिंग टूल, API एक्सेस, प्लगइन या व्हाइट-लेबल पोर्टल के लिए मासिक या वार्षिक सब्सक्रिप्शन देती हैं।

हमारी राय

Paddle सही बैठ सकता है

मर्चेंट ऑफ रिकॉर्ड ठीक ऐसी ही बिक्री के लिए बना है: Paddle सब्सक्रिप्शन का बिल बनाता है, हर देश में टैक्स संभालता है और आपको भुगतान करता है, इसलिए जहाँ-जहाँ आपके ग्राहक हैं वहाँ VAT के लिए रजिस्टर नहीं करना पड़ता।

03

आप बुकिंग और सॉफ़्टवेयर दोनों बेचते हैं

आपकी एजेंसी यात्रियों के लिए बुकिंग साइट चलाती है और साथ ही अपना प्लेटफ़ॉर्म या टूल दूसरी एजेंसियों को लाइसेंस करती है।

हमारी राय

दोनों इस्तेमाल करें, अलग रखकर

बुकिंग फ़्लो में तैयार गेटवे से बुकिंग के पेमेंट लें और सॉफ़्टवेयर सब्सक्रिप्शन का बिल Paddle से बनाएँ। दो फ़्लो, दो रिकॉर्ड, हर एक पर सही टैक्स व्यवहार।

यह कैसे काम करता है

Paddle इंटीग्रेशन शुरू से अंत तक कैसे काम करता है

Paddle Billing उन प्रोडक्ट और कीमतों पर चलता है जो आप Paddle में बनाते हैं, Paddle.js से खुलने वाले चेकआउट पर, और उन वेबहुक पर जो आपके सर्वर को बताते हैं कि क्या हुआ।

  1. 01

    प्रोडक्ट और कीमतें

    आप हर प्लान Paddle में एक बार बनाते हैं, जैसे मासिक और वार्षिक कीमत, और कीमतों की ID अपने सिस्टम में रखते हैं।

    pri_…
  2. 02

    Paddle.js चेकआउट

    आपका पेज Paddle.js लोड करता है और कीमत की ID तथा आपके अपने ग्राहक संदर्भ के साथ चेकआउट को ओवरले या इनलाइन फ़्रेम के रूप में खोलता है।

    Paddle.Checkout.open()
  3. 03

    ट्रांज़ैक्शन पूरा

    खरीदार भुगतान करता है, Paddle कार्ड या वॉलेट से पैसा काटता है, टैक्स लगाता है और ट्रांज़ैक्शन बनाता है, और कीमत दोहराई जाने वाली हो तो सब्सक्रिप्शन भी।

    txn_…
  4. 04

    साइन किया हुआ वेबहुक

    Paddle आपके एंडपॉइंट पर transaction.completed जैसा इवेंट भेजता है, जो Paddle-Signature हेडर में साइन होता है।

    transaction.completed
  5. 05

    आपका सिस्टम कार्रवाई करता है

    आपका सर्वर सिग्नेचर जाँचता है, फिर अकाउंट चालू करता है, प्लान रिन्यू करता है या पेमेंट दर्ज करता है।

    200 OK

API कुंजी सिर्फ़ अपने सर्वर पर रखें। ब्राउज़र अलग क्लाइंट-साइड टोकन इस्तेमाल करता है, और sandbox व लाइव वातावरण की अपनी-अपनी कुंजियाँ, कीमतें और वेबहुक सीक्रेट होते हैं।

वेबहुक सुरक्षा

Paddle-Signature हेडर की जाँच

आपके एंडपॉइंट का URL जानने वाला कोई भी वेबहुक नकली भेज सकता है। हर इवेंट पर सिग्नेचर जाँचना ही वेबहुक के आधार पर अकाउंट चालू करना सुरक्षित बनाता है।

paddle-webhook.php
 1$raw    = file_get_contents("php://input"); 2$header = $_SERVER["HTTP_PADDLE_SIGNATURE"] ?? "";  // ts=…;h1=… 3parse_str(str_replace(";", "&", $header), $sig); 4 5$expected = hash_hmac("sha256", $sig["ts"] . ":" . $raw, $endpointSecret); 6if (!hash_equals($expected, $sig["h1"] ?? "")) { 7    http_response_code(400); exit;            // not from Paddle 8} 9if (time() - (int) $sig["ts"] > $tolerance) exit; // too old1011$event = json_decode($raw, true);12if (alreadyHandled($event["event_id"])) exit;      // repeat delivery13if ($event["event_type"] === "transaction.completed") {14    activatePlan($event["data"]["custom_data"]["account_id"]);15}16http_response_code(200);

सादे PHP में उदाहरण मात्र। सटीक फ़ॉर्मैट के लिए Paddle के मौजूदा दस्तावेज़ या उसका आधिकारिक SDK देखें।

  1. 01

    रॉ बॉडी इस्तेमाल करें

    सिग्नेचर रिक्वेस्ट बॉडी पर ठीक वैसे ही निकाला जाता है जैसी वह आई है, इसलिए JSON पार्सिंग उसे बदले इससे पहले उसे पढ़ लें।

  2. 02

    टाइमस्टैंप के साथ हैश

    हेडर में एक टाइमस्टैंप और आपके एंडपॉइंट की गुप्त कुंजी से बना HMAC-SHA256 हैश होता है। उसे दोबारा बनाकर स्थिर समय में तुलना करें।

  3. 03

    पुराने और दोहराए इवेंट ठुकराएँ

    जिन इवेंट का टाइमस्टैंप बहुत पुराना हो उन्हें अस्वीकार करें और हर इवेंट ID सहेजें, ताकि दोबारा डिलीवरी दो बार प्रोसेस न हो।

  4. 04

    पहले sandbox

    टेस्ट कार्ड के साथ Paddle के sandbox में बनाएँ और जाँचें, फिर कुंजियाँ, कीमतें और सीक्रेट लाइव पर बदलें।

PHPTRAVELS और Paddle

Paddle को PHPTRAVELS से जोड़ना

पहले एक सीधा जवाब, फिर विकल्प।

Paddle तैयार कनेक्टर नहीं है

Paddle PHPTRAVELS की पेमेंट गेटवे सूची में नहीं है और इसकी कोई प्रकाशित सेटअप गाइड नहीं है। नीचे दिखाए गए तैयार गेटवे वही हैं जो बुकिंग के पेमेंट लेने के लिए बने हैं।

  • बुकिंग पेमेंट के लिए: तैयार गेटवे

    अपने मर्चेंट अकाउंट के साथ एडमिन में Stripe भुगतान या PayPal भुगतान जैसा तैयार गेटवे चालू करें। चेकआउट, रिफ़ंड और बुकिंग संदर्भ पहले से बुकिंग फ़्लो में जुड़े हैं, जैसा पेमेंट गेटवे इंटीग्रेशन पेज बताता है।

  • सॉफ़्टवेयर बिक्री के लिए: कस्टम इंटीग्रेशन के रूप में Paddle

    जब आपका उपयोग Paddle के नियमों से मेल खाए तो हमारे डेवलपर इसे कस्टम API इंटीग्रेशन के रूप में जोड़ सकते हैं: आपके पेज पर Paddle.js चेकआउट, जाँचा हुआ वेबहुक एंडपॉइंट, और आपके ग्राहकों के नाम दर्ज होने वाले पेमेंट। काम शुरू होने से पहले उसका कोट दिया जाता है।

  • या सोर्स कोड पर खुद बनाएँ

    PHPTRAVELS सेल्फ़-होस्टेड है और पूरे सोर्स कोड के साथ आता है, इसलिए आपके अपने डेवलपर बुकिंग इंजन के साथ सब्सक्रिप्शन के लिए Paddle जोड़ सकते हैं। हर लाइसेंस में क्या शामिल है यह कीमतें पेज पर है।

बुकिंग पेमेंट के लिए तैयार

पेमेंट गेटवे जो पहले से PHPTRAVELS से जुड़े हैं

यात्रियों और एजेंटों के पेमेंट के लिए ये गेटवे तैयार हैं: प्रदाता के साथ अकाउंट खोलें, एडमिन में अपनी कुंजियाँ डालें, टेस्ट करें और लाइव हो जाएँ। यह सूची हमारी इंटीग्रेशन डायरेक्टरी की लाइव सूची है।

सब-एजेंट B2B एजेंट वॉलेट के ज़रिए प्रीपेड बैलेंस या क्रेडिट लिमिट से भी भुगतान कर सकते हैं, जिसके लिए किसी गेटवे की ज़रूरत नहीं।

अक्सर पूछे जाने वाले सवाल

Paddle API इंटीग्रेशन: आम सवाल

सेल्स से बात करें

तैयार कनेक्टर के रूप में नहीं। Paddle PHPTRAVELS की पेमेंट गेटवे सूची में नहीं है। अगर आपका उपयोग Paddle के नियमों से मेल खाता है, जैसे अपने सॉफ़्टवेयर की सब्सक्रिप्शन बेचना, तो इसे कस्टम इंटीग्रेशन के रूप में जोड़ा जा सकता है या आपके डेवलपर शामिल सोर्स कोड पर बना सकते हैं।

Paddle सॉफ़्टवेयर, SaaS और डिजिटल प्रोडक्ट के लिए बना मर्चेंट ऑफ रिकॉर्ड है, इसलिए आमतौर पर फ़्लाइट, होटल या टूर के लिए सही औज़ार नहीं। ट्रैवल बुकिंग के लिए इस्तेमाल से पहले Paddle के स्वीकार्य उपयोग नियम देखें; ज़्यादातर ट्रैवल बिज़नेस बुकिंग के पेमेंट Stripe, PayPal, Adyen या किसी क्षेत्रीय गेटवे जैसे पेमेंट गेटवे से लेते हैं।

वह कंपनी जो कानूनी तौर पर ग्राहक को बेचती है। सेल्स टैक्स या VAT की वसूली और जमा, इनवॉइस जारी करना, रिफ़ंड और चार्जबैक संभालना उसकी ज़िम्मेदारी है, और ग्राहक के स्टेटमेंट पर वही दिखती है। Paddle के साथ यह भूमिका Paddle खुद निभाता है और आपको भुगतान करता है।

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

जब आप यात्राएँ नहीं, अपना सॉफ़्टवेयर बेचते हैं: बुकिंग टूल, API, प्लगइन या व्हाइट-लेबल पोर्टल जिसकी सब्सक्रिप्शन एजेंसियाँ देती हैं। तब Paddle उनका बिल बना सकता है और हर देश में टैक्स संभाल सकता है।

Paddle पूरा हुआ ट्रांज़ैक्शन या रिन्यू हुई सब्सक्रिप्शन जैसे इवेंट आपके रजिस्टर किए URL पर भेजता है। हर रिक्वेस्ट में टाइमस्टैंप और हैश वाला Paddle-Signature हेडर होता है, जिसे आपका सर्वर कार्रवाई से पहले एंडपॉइंट की गुप्त कुंजी से जाँचता है।

हाँ। Paddle का अलग sandbox वातावरण है जिसमें अपना अकाउंट, API कुंजियाँ, कीमतें और टेस्ट कार्ड हैं। वहाँ बनाएँ और टेस्ट करें, फिर कॉन्फ़िगरेशन लाइव वातावरण में ले जाएँ।

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