API

इंटीग्रेशन के लिए दस्तावेज़ीकृत API

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

Back office: website section — storefront with dish photos from the till menu

इंटीग्रेशन क्या कर सकता है

📋

मेन्यू और उपलब्धता

स्टोरफ़्रंट को श्रेणियाँ, व्यंजन, कीमतें, मॉडिफ़ायर और फ़ोटो मिलते हैं — बिक्री से हटाए गए आइटम के बिना और «प्रतिष्ठान अभी ऑर्डर नहीं ले रहा» संकेत के साथ।

🧾

ऑर्डर लेना

ऑर्डर एक अनुरोध से बनता है और उसे नंबर मिलता है। वही अनुरोध दोहराने से दूसरा ऑर्डर नहीं बनता।

✏️

बदलाव और रद्दीकरण

जब तक प्रतिष्ठान ने ऑर्डर स्वीकार नहीं किया, स्रोत उसकी सामग्री बदल सकता है या उसे रद्द कर सकता है।

🎟

प्रोमो कोड जाँच

कूपन POSitive की ओर जाँचा जाता है, इसलिए स्टोरफ़्रंट और कैश रजिस्टर पर छूट अलग नहीं होती।

💳

भुगतान की सूचना

स्टोरफ़्रंट की ओर लिया गया भुगतान प्रतिष्ठान के भुगतान तरीक़े से जुड़ता है — पैसा सही खाते में जाता है।

↩️

स्थितियाँ वापस

स्वीकार, पक रहा है, कूरियर को सौंपा, पूरा — सूचनाएँ स्रोत को जाती हैं और साझा सीक्रेट से हस्ताक्षरित होती हैं।

विनिर्देश प्रकाशित नहीं किया जाता। मेथड के पते, फ़ील्ड, त्रुटि कोड और अनुरोधों के उदाहरण कुंजी के साथ दिए जाते हैं — प्रतिष्ठान को, उसके डेवलपर को या साझेदार को। कारण सीधा है: स्टोरफ़्रंट पर खुला रखा अनुबंध इंटीग्रेटर से ज़्यादा उसकी मदद करता है जो दूसरों के इंटीग्रेशन खोजता है। विवरण एक अनुरोध पर मिल सकता है, और हम उसी दिन जवाब देते हैं।

अनुबंध क्या गारंटी देता है

🔁

आइडेम्पोटेंसी

उसी ऑपरेशन कुंजी से दोबारा भेजने पर दूसरा ऑर्डर नहीं बनता। दोहरे क्लिक और कनेक्शन टूटने से बचाता है।

🔐

हस्ताक्षर और कुंजियाँ

कुंजी एक प्रतिष्ठान के लिए मान्य है और तुरंत रद्द होती है। सीक्रेट हैश के रूप में रखा जाता है और हम भी उसे वापस नहीं निकाल सकते। कुंजी साझेदार के सर्वर पर रहती है, मेहमान के ब्राउज़र में नहीं।

🧾

स्पष्ट त्रुटियाँ

जवाब बताता है कि ठीक कौन-सा आइटम नहीं गया और क्यों — सामान्य «400 Bad Request» के बजाय।

🛑

अद्यतन स्टॉप-लिस्ट

मेन्यू बिक्री से हटाए गए आइटम के बिना भेजा जाता है: कैश रजिस्टर पर हटाया गया आइटम तुरंत वेबसाइट से गायब हो जाता है।

↩️

वापसी चैनल

ऑर्डर की स्थिति स्रोत को लौटती है: स्वीकार, पक रहा है, कूरियर को सौंपा, पूरा।

🧪

सैंडबॉक्स

अलग कुंजी वाला टेस्ट प्रतिष्ठान: असली डेटा छुए बिना इंटीग्रेशन बनाया और जाँचा जा सकता है।

कुंजी या अनुबंध चाहिए?

फ़ील्ड और उदाहरणों के साथ विवरण भेजेंगे, सैंडबॉक्स खोलेंगे और इंटीग्रेशन के सवालों के जवाब देंगे।