API और इंटीग्रेशन

सेटिंग्स → API और इंटीग्रेशन में तीन टैब हैं: API कीज़, वेबहुक और इंटीग्रेशन।
API और API कुंजियाँ हर योजना में मुफ़्त हैं, Free Forever सहित; कोई API ऐड-ऑन नहीं है। API के माध्यम से दिए गए स्टैम्प किसी भी अन्य की तरह Card Operations हैं, इसलिए वे योजना की Card Operations समाप्त होने पर रुक जाते हैं। वेबहुक भुगतान वाला हिस्सा है, नीचे देखें।
क्या API की कीमत अलग से है?
नहीं। API और API कुंजियाँ हर योजना पर मुफ्त हैं, Free Forever शामिल है। इसके माध्यम से दिए गए टिकट किसी अन्य की तरह Card Operations हैं।
क्या मैं API को Free Forever पर इस्तेमाल कर सकता हूँ?
हाँ। जब योजना का Card Operations खत्म हो जाता है, तो API के माध्यम से स्टैम्प किसी और की तरह रुक जाते हैं।
API सेटिंग्स कहाँ हैं?
सेटिंग्स → API और इंटिग्रेशन में, तीन टैब के साथ — API कुंजियाँ, वेबहुक्स और इंटिग्रेशन।
API कुंजियाँ

API कुंजी के अंतर्गत एक API कुंजी बनाई जाती है → एक स्टाफ लॉगिन के लिए API कुंजी जोड़ें। एक स्टाफ लॉगिन में अधिकतम एक API कुंजी होती है, और एक स्विच-ऑफ स्टाफ लॉगिन नहीं चुना जा सकता है। चुनने के लिए कोई स्टाफ लॉगिन नहीं होने से, API कुंजी विंडो जेनरेट करें, वहीं एक लॉगिन बनाने की पेशकश करता है; नए स्टाफ लॉगिन के लिए निःशुल्क Staff Seat की आवश्यकता होती है, और पूर्ण योजना पर विंडो एक सीट जोड़ने या इसके बजाय एक योजना चुनने की पेशकश करती है।
API कुंजी के साथ की गई प्रत्येक कॉल उसके स्टाफ लॉगिन के रूप में कार्य करती है: यह केवल उस स्टाफ लॉगिन के व्यवसाय तक पहुँचती है, स्वचालित स्टैम्पिंग के तहत इसके लिए चुने गए स्टाम्प कार्ड पर मुहर लगाती है, और इसके स्टैम्प को उस स्टाफ लॉगिन के Card Operations के रूप में गिना जाता है।
कुंजी को किसी भी समय API कुंजी सूची से दोबारा देखा और कॉपी किया जा सकता है। इसे टर्मिनल में स्कैन करने के लिए QR कोड के रूप में भी दिखाया जा सकता है, और स्टाफ लॉगिन के नाम के साथ मुद्रित किया जा सकता है।
मैं API कुंजी कैसे बनाऊँ?
सेटिंग्स → API और इंटीग्रेशन्स → API कीज़ में, ‘Add API key’ चुनें और एक स्टाफ लॉगिन चुनें। प्रत्येक स्टाफ लॉगिन के पास अधिकतम एक API key हो सकता है।
मैं अपनी API चाबी खो बैठा। क्या मुझे नई चाहिए?
नहीं। कुंजी को किसी भी समय API कुंजी सूची से देखा और कॉपी किया जा सकता है, या इसे QR कोड के रूप में दिखाया जा सकता है।
API किस स्टाम्प कार्ड को स्टाम्प कहते हैं?
स्वचालित स्टांपिंग के तहत कुंजी के स्टाफ लॉगिन के लिए चुना गया। इसके स्टैम्प उस स्टाफ लॉगिन के Card Operations के रूप में गिने जाते हैं।
मैं नए कुंजी के लिए स्टाफ लॉगिन क्यों नहीं चुन सकता?
एक बंद स्टाफ लॉगिन को चुना नहीं जा सकता, और एक स्टाफ लॉगिन जिसके पास पहले से कुंजी है, वह दूसरी कुंजी नहीं पा सकता। जब चुनने के लिए कोई नहीं होता, तो विंडो एक स्टाफ लॉगिन बनाने का विकल्प देती है।
जब API कुंजी काम करना बंद कर देती है
API कुंजी समाप्त नहीं होती है. यह तभी काम करना बंद करता है जब इसे पुनर्जीवित किया जाता है या हटा दिया जाता है, या जब इसका स्टाफ लॉगिन बंद कर दिया जाता है या हटा दिया जाता है। स्टाफ लॉगिन के लिए नया पासवर्ड या लॉगिन इसे प्रभावित नहीं करता है।
- पुनर्जीवित स्टाफ लॉगिन को एक नई API कुंजी देता है; पुराना तुरंत काम करना बंद कर देता है।
- हटाएं कुंजी को तुरंत रोक देता है। स्टाफ लॉगिन स्वयं 7Stamp Scanner में काम करता रहता है और बाद में नई कुंजी प्राप्त कर सकता है।
- स्टाफ लॉगिन को बंद करने से इसकी कुंजी बनी रहती है: जब स्टाफ लॉगिन को वापस चालू किया जाता है, तो वही कुंजी फिर से काम करती है।
क्या API कुंजी की समाप्ति होती है?
नहीं। यह केवल तभी काम करना बंद करता है जब इसे पुनर्निर्मित या हटाया जाता है, या जब इसका स्टाफ लॉगिन बंद या हटाया जाता है।
मैंने स्टाफ लॉगिन का पासवर्ड बदल दिया। क्या मुझे नया API कुंजी चाहिए?
नहीं। नया पासवर्ड या लॉगिन API कुंजी को प्रभावित नहीं करता।
मैंने स्टाफ लॉगिन को फिर से चालू कर दिया। क्या इसकी पुरानी API कुंजी काम करती है?
हाँ। किसी स्टाफ लॉगिन को बंद करने से उसकी कुंजी बनी रहती है, और वही कुंजी फिर से काम करती है जब इसे वापस चालू किया जाता है।
क्या API करता है
विवरण: Through the API a system can:
- एक लिंक के रूप में एक स्टाम्प कार्ड सौंपें या QR;
- विवरण: add stamps;
- एक कार्ड को उसके टिकटों, लक्ष्यों और वाउचरों के साथ पढ़ें;
- विवरण: issue a Voucher straight to a card;
- वाउचर को उसके वाउचर कोड द्वारा भुनाएं;
- विवरण: message a Customer.
API व्यवसाय के स्वयं के पहचानकर्ता, जैसे CRM ID, फोन या ईमेल, द्वारा external_id के रूप में भेजे गए ग्राहक का कार्ड ढूंढता है। पहचानकर्ता कार्ड पर संग्रहीत होता है और इसके बारे में प्रत्येक वेबहुक में वापस आता है। API में कोई कॉल नहीं है जो किसी व्यवसाय के ग्राहकों को सूचीबद्ध करती है: संपूर्ण ग्राहक आधार केवल व्यवस्थापक निर्यात के माध्यम से निकाला जाता है।
API कुंजी के बजाय, एक ऐप स्टाफ लॉगिन के लॉगिन और पासवर्ड के साथ साइन इन कर सकता है - जिस डिवाइस पर कैशियर साइन इन करता है। एक API कुंजी ऐसे उपकरण के लिए उपयुक्त होती है जो बिना निगरानी के चलता है। वेबहुक केवल व्यवस्थापक में जोड़े जाते हैं; API के पास ईवेंट की सदस्यता लेने या उन्हें सूचीबद्ध करने के लिए कोई कॉल नहीं है।
API कोई अनुरोध दर सीमा निर्धारित नहीं करता है: कॉल को संख्या या आवृत्ति द्वारा थ्रॉटल नहीं किया जाता है, और उसी कार्ड को तुरंत फिर से स्कैन किया जा सकता है। इसके माध्यम से स्टांप लगाने की सीमा योजना की Card Operations है।
क्या हम अपने स्वयं के CRM या POS से स्टाम्प जोड़ सकते हैं?
हाँ, API के माध्यम से। यह स्टाम्प कार्ड देता है, स्टाम्प जोड़ता है, कार्ड पढ़ता है और वाउचर रिडीम करता है। अपने सिस्टम को इवेंट्स के बारे में बताने के लिए, एक वेबहुक जोड़ें — इसके लिए Webhooks & Events ऐड-ऑन की आवश्यकता होती है।
क्या हम डेटा निर्यात कर सकते हैं?
आप API के माध्यम से अपने स्वयं के पहचानकर्ता द्वारा कार्ड पढ़ते हैं, और वेबहुक जैसी ही घटनाएँ होती हैं उन्हें भेजते हैं। API के पास सभी ग्राहकों की कोई सूची नहीं है — पूरी ग्राहक आधार को व्यवस्थापक निर्यात के माध्यम से निकाला जाता है।
ग्राहक का कार्ड API कैसे ढूंढता है?
अपने स्वयं के पहचानकर्ता — एक CRM ID, फोन या ईमेल — को external_id के रूप में भेजा गया। यह कार्ड पर संग्रहीत होता है और इसके बारे में हर Webhook में वापस आता है।
क्या मैं API के माध्यम से वेबहुक्स को सब्सक्राइब कर सकता हूँ?
नहीं। वेबहुक केवल एडमिन में जोड़े जाते हैं।
क्या API की कोई दर सीमा है?
नहीं। कॉल की संख्या या आवृत्ति से सीमित नहीं होती है, और उसी कार्ड को तुरंत फिर से स्कैन किया जा सकता है। स्टैम्पिंग केवल योजना की Card Operations द्वारा सीमित है।
API संदर्भ
API संदर्भ सार्वजनिक है और साइन-इन की आवश्यकता नहीं है: Swagger https://api.7loc.com/cards-api/docs, और OpenAPI फ़ाइल https://api.7loc.com/cards-api/openapi.json. पर उपलब्ध है। कॉल https://api.7loc.com/cards-api पर जाती हैं और उनके लिए API कुंजी या स्टाफ लॉगिन आवश्यक है।
एक White Label व्यवसाय को व्यवस्थापक में API संदर्भ का कोई लिंक नहीं दिखता है। इसकी API कुंजियाँ और वेबहुक समान रूप से कार्य करते हैं।
API दस्तावेज़ कहाँ है?
Swagger पर https://api.7loc.com/cards-api/docs, सार्वजनिक रूप से, बिना साइन-इन की आवश्यकता के। OpenAPI फ़ाइल https://api.7loc.com/cards-api/openapi.json. पर है
API कॉल्स के लिए बेस पता क्या है?
https://api.7loc.com/cards-api. कॉल के लिए API कुंजी या स्टाफ लॉगिन की आवश्यकता होती है।
हमारे White Label प्रशासन के पास कोई API डॉक लिंक नहीं है। क्या API हमारे लिए काम करेगा?
हाँ। एक White Label व्यवसाय संदर्भ से कोई लिंक नहीं देखता है, लेकिन इसके API कुंजियाँ और वेबहुक्स समान रूप से काम करते हैं।
वेबहुक्स

API और एकीकरण के अंतर्गत एक वेबहुक जोड़ा जाता है → वेबहुक → वेबहुक जोड़ें, URL के साथ जो ईवेंट प्राप्त करता है। 7Stamp में स्टैम्प कार्ड इवेंट के लिए एक वेबहुक बनाया जाता है। एक व्यवसाय कई वेबहुक जोड़ सकता है, प्रत्येक का अपना URL होता है।
वेबहुक को Webhooks & Events ऐड-ऑन, $19 प्रति माह की आवश्यकता है, जो केवल भुगतान योजनाओं पर पेश किया जाता है। इसे खरीदने के लिए पहला वेबहुक ऑफर जोड़ना; इसके बिना वेबहुक नहीं बनाया जा सकता या वापस चालू नहीं किया जा सकता। एक ऐड-ऑन एक वेबहुक को चालू रखता है: और अधिक जोड़े जा सकते हैं, लेकिन सदस्यता का प्रत्येक बिलिंग अपडेट सबसे पुराने को छोड़कर सभी को बंद कर देता है।
वेबहुक जैसे ही जोड़ा जाता है, घटनाओं को जैसे ही वे होती हैं, भेजता है। पिछली घटनाओं को नहीं भेजा जाता।
विवरण: Are Webhooks free?
नहीं, उन्हें Webhooks & Events ऐड-ऑन, $19 प्रति माह की आवश्यकता है, जो केवल भुगतान योजनाओं पर दिया जाता है। API स्वयं मुफ़्त है।
मैंने दूसरा वेबहुक जोड़ा और यह बंद हो गया। क्यों?
एक Webhooks & Events ऐड-ऑन एक वेबहुक को चालू रखता है। सदस्यता का प्रत्येक बिलिंग अद्यतन सबसे पुराने को छोड़कर सभी को बंद कर देता है।
क्या नया वेबहुक पिछली घटनाएँ भेजेगा?
नहीं, वेबहुक जोड़े जाने के क्षण से ही इवेंट भेजे जाते हैं।
वेबहुक घटनाएँ
एक वेबहुक को पंद्रह स्टैम्प कार्ड इवेंट मिलते हैं, जिनके नाम event_type में हैं: SCAN, DELIVERY_INSERT, RECEIPT_SCAN, CARD_JOINED, REWARD_EARNED, VOUCHER_ISSUED, VOUCHER_PACK, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED, LOTTERY_WIN, CARD_CAMPAIGN, BIRTHDAY_GREETING, AUTO_MESSAGE_VOUCHER, CARD_ADDED_TO_WALLET और CARD_REMOVED_FROM_WALLET। आखिरी दो तब आते हैं जब पास को वॉलेट में जोड़ा या हटाया जाता है, जिसमें वॉलेट, एप्पल या गूगल शामिल हैं।
एक स्कैन जिसमें कोई स्टाम्प नहीं जोड़ा जाता है, जैसे कि स्टाम्प मूल्य से कम कीमत पर खरीदारी, फिर भी शून्य स्टाम्प जोड़कर SCAN भेजता है। पहिये पर जीते गए पुरस्कार की घोषणा LOTTERY_WIN द्वारा की जाती है, जब पहिये को घुमाया जाता है, REWARD_EARNED या VOUCHER_ISSUED द्वारा नहीं; घूमने की प्रतीक्षा कर रहा एक पहिया अभी तक कुछ नहीं भेजता है।
ग्राहक समीक्षाएँ स्टाम्प कार्ड ईवेंट नहीं हैं। प्रत्येक नई समीक्षा इकाई review और क्रिया created के साथ वेबहुक को एक ईवेंट भेजती है, जिसमें वेबहुक के पृष्ठ पर उनके ऑब्जेक्ट के बीच समीक्षाएँ टिकी होती हैं। यहां जोड़ा गया एक वेबहुक केवल स्टैम्प कार्ड इवेंट के लिए सेट किया गया है, इसलिए समीक्षाओं पर टिक करने के बाद इसे समीक्षाएं मिलती हैं।
क्या वेबहुक तब भेजा जाता है जब स्कैन में कोई स्टैम्प नहीं जोड़ा जाता है?
हाँ। एक स्कैन जो कोई स्टांप नहीं जोड़ता है, जैसे कि स्टांप मूल्य से कम कीमत पर खरीदारी, फिर भी शून्य स्टांप जोड़कर SCAN भेजता है।
कौन सी घटना मुझे बताती है कि एक ग्राहक ने पहिये पर जीत हासिल की?
LOTTERY_WIN, पहिया घूमने पर एक बार भेजा जाता है। घूमने की प्रतीक्षा कर रहा एक पहिया अभी तक कुछ नहीं भेजता है।
क्या मैं बता सकता हूँ कि ग्राहक ने अपना कार्ड अपने वॉलेट से निकाला है?
हाँ। पास को वॉलेट में जोड़ने और इसे हटाने पर वॉलेट, एप्पल या गूगल के साथ CARD_ADDED_TO_WALLET और CARD_REMOVED_FROM_WALLET भेजता है।
मैं वेबहुक के माध्यम से नए ग्राहक समीक्षाएँ कैसे प्राप्त कर सकता हूँ?
वेबहुक का पेज खोलें और इसके ऑब्जेक्ट्स में समीक्षा (Reviews) को टिक करें। इसके बाद हर नई समीक्षा entity review और action created के साथ आती है; API और इंटीग्रेशन्स के तहत जो वेबहुक जोड़ा गया है वह तब तक केवल Stamp कार्ड इवेंट्स प्राप्त करता है।
जब प्रत्येक घटना भेजी जाती है
| विवरण: Event | विवरण: Sent when |
|---|---|
SCAN | एक स्टाफ लॉगिन कार्ड को स्कैन करता है: 7Stamp Scanner में, API के माध्यम से या POS जैसे Toast से। 7Stamp Scanner में हटाए गए स्टैम्प SCAN हैं और नकारात्मक stamps_added हैं |
DELIVERY_INSERT | एक ग्राहक एक स्टाम्प कोड खोलता है जो स्टाम्प देता है - एक QR, एक लिंक, स्वयं कोड या API के माध्यम से किया गया आमंत्रण |
RECEIPT_SCAN | एक ग्राहक व्यवसाय के चैटबॉट में वित्तीय रसीद को स्कैन करता है और उस पर मुहर लगाई जाती है; amount कुल प्राप्ति है |
CARD_JOINED | एक ग्राहक को एक नया स्टाम्प कार्ड मिलता है, चाहे जो भी हो, आपके द्वारा पारित external_id के साथ |
REWARD_EARNED | विवरण: A scan reaches an Award goal |
VOUCHER_ISSUED | विवरण: A scan reaches a Voucher goal |
LOTTERY_WIN | एक Lottery पहिया घुमाया जाता है और पुरस्कार दिया जाता है |
VOUCHER_PACK | एक नए कार्ड को स्टाम्प कार्ड का वाउचर पैक, उसके सभी वाउचर एक ही बार में मिल जाते हैं |
ADMIN_VOUCHER_ISSUE | वाउचर सीधे कार्ड पर, एडमिन में या API के माध्यम से जारी किया जाता है |
VOUCHER_REDEEMED | कार्ड पर वाउचर भुनाया जाता है: 7Stamp Scanner में, API के माध्यम से, Toast POS पर या ग्राहक द्वारा |
CARD_CAMPAIGN | एक अभियान कार्ड तक पहुंचता है, प्रति कार्ड एक बार, अभियान के वाउचर के साथ, यदि उसके पास एक है |
BIRTHDAY_GREETING | जन्मदिन की बधाई कार्ड के लिए दी जाती है, यदि कोई जारी किया गया हो तो जन्मदिन वाउचर के साथ |
AUTO_MESSAGE_VOUCHER | एक ऑटो-मैसेज ट्रिगर कार्ड पर एक वाउचर डालता है, चाहे कोई चैनल ग्राहक तक पहुंचे या नहीं |
CARD_ADDED_TO_WALLET | पास को Apple Wallet या Google Wallet में जोड़ा जाता है |
CARD_REMOVED_FROM_WALLET | पास को बटुए से निकाल दिया जाता है |
प्रत्येक स्कैन जिस लक्ष्य तक पहुंचता है वह स्कैन के एक के बाद अपना स्वयं का ईवेंट भेजता है, और कार्ड के दो राउंड में एक स्कैन द्वारा दो बार पहुंचा गया लक्ष्य दो भेजता है। एक नया दौर शुरू करने वाला पूर्ण कार्ड एक ही कार्ड है और कोई CARD_JOINED नहीं भेजता है; किसी व्यवस्थापक द्वारा पुराना कार्ड हटा दिए जाने के बाद उसे दोबारा जारी किया जाता है। जब कोई सदस्य वाउचर पैक और स्टाम्प लाता है, तो पहले CARD_JOINED, फिर VOUCHER_PACK, फिर DELIVERY_INSERT आता है।
बिना स्टांप वाला स्टाम्प कोड कोई DELIVERY_INSERT नहीं भेजता है, बिना कार्ड के एडमिन में जेनरेट किया गया वाउचर कोई ADMIN_VOUCHER_ISSUE नहीं भेजता है, और पहले से ही भुनाए गए वाउचर के लिए बार-बार API कॉल करने पर कोई दूसरा VOUCHER_REDEEMED नहीं भेजता है।
कौन सा इवेंट मुझे बताता है कि एक ग्राहक ने लक्ष्य हासिल कर लिया?
एक Award लक्ष्य के लिए REWARD_EARNED, एक वाउचर लक्ष्य के लिए VOUCHER_ISSUED और एक Lottery के लिए LOTTERY_WIN, प्रत्येक स्कैन की अपनी घटना के बाद भेजा गया।
क्या स्टैम्प हटाए जाने पर वेबहुक भेजा जाता है?
हाँ। 7Stamp Scanner में हटाए गए स्टैम्प्स नेगेटिव stamps_added के साथ SCAN के रूप में आते हैं।
VOUCHER_ISSUED और ADMIN_VOUCHER_ISSUE के बीच क्या अंतर है?
VOUCHER_ISSUED तब आता है जब कोई स्कैन वाउचर लक्ष्य तक पहुँचता है। ADMIN_VOUCHER_ISSUE तब आता है जब कोई वाउचर सीधे कार्ड पर जारी किया जाता है, हाथ से एडमिन में या API के माध्यम से।
क्या एक ग्राहक जो स्टैम्प कोड के साथ जुड़ता है, एक इवेंट भेजता है या कई?
कई। CARD_JOINED पहले आता है, फिर VOUCHER_PACK अगर Stamp कार्ड में Voucher पैक है, फिर DELIVERY_INSERT स्टैम्प के साथ।
क्या मुझे हर अभियान संदेश के लिए एक इवेंट मिलेगा?
CARD_CAMPAIGN हर उस कार्ड के लिए एक बार भेजी जाती है जिसे अभियान पहुँचता है, और जब इसमें वाउचर शामिल होता है तो अभियान का वाउचर भी भेजा जाता है।
एक वेबहुक क्या प्राप्त करता है
प्रत्येक ईवेंट का JSON निकाय समान होता है: ईवेंट ID, व्यवसाय, और ईवेंट अपने प्रकार के साथ, स्टाम्प कार्ड, पहले और बाद में स्टाम्प, खरीद राशि, ऑर्डर ID और external_id भेजा गया एकीकरण, कर्मचारी लॉगिन जिसने इसे सेवा प्रदान की, वाउचर और इसके द्वारा दिए गए पुरस्कार, और ग्राहक का नाम, ईमेल, Telegram, WhatsApp फोन और जन्म तिथि।
amount मामूली इकाइयों (सेंट) में खरीद राशि है: स्कैन के साथ भेजी गई 12.50 की राशि 1250 के रूप में आती है। यह तब खाली होता है जब इवेंट में कोई राशि नहीं होती है।
इवेंट ID मुख्य भाग में और X-Webhook-Event-Id हेडर में है। उसी ईवेंट का पुनः प्रयास ID रखता है, इसलिए एक रिसीवर दोहराव को छोड़ सकता है। Make या Zapier URL के लिए ईवेंट data के बजाय card_event कुंजी के अंतर्गत बैठता है।
वेबहुक ग्राहक के बारे में कौन सा डेटा ले जाता है?
नाम, ईमेल, Telegram, WhatsApp फोन और जन्म तिथि, साथ ही स्टाम्प कार्ड, पहले और बाद के स्टाम्प, और दिए गए वाउचर और पुरस्कार।
राशि किस इकाई में है?
छोटे इकाइयों (सेंट) में। स्कैन के साथ भेजी गई 12.50 राशि 1250 के रूप में पहुँचती है; यह खाली होती है जब इवेंट में कोई राशि नहीं होती।
मैं एक ही घटना को दो बार संसाधित करने से कैसे बच सकता हूँ?
इवेंट ID का उपयोग करें, बॉडी और X-Webhook-Event-Id हेडर में। एक पुनः प्रयास वही ID रखता है।
Make में card_event के तहत यह इवेंट क्यों है?
किसी Make या Zapier URL के लिए, घटना data के बजाय card_event कुंजी के तहत आती है, ताकि उनके ऐप इसे अलग पहचान सकें।
हस्ताक्षर
प्रत्येक डिलीवरी पर हस्ताक्षर किए जाते हैं। X-Webhook-Signature हेडर में एक टाइमस्टैम्प और उस टाइमस्टैम्प का एक HMAC-SHA256 और वेबहुक की गुप्त कुंजी के साथ कुंजीबद्ध कच्चा शरीर होता है। गुप्त कुंजी वेबहुक के पृष्ठ पर दिखाई और पुनर्जीवित होती है। एक बेसिक ऑथ लॉगिन और पासवर्ड भी जोड़ा जा सकता है।
मैं कैसे जाँच सकता हूँ कि कोई वेबहुक वास्तव में 7Stamp से आया है?
टाइमस्टैम्प और रॉ बॉडी का HMAC-SHA256 वेबहुक की सीक्रेट कुंजी के साथ गणना करें और इसे X-Webhook-Signature हेडर के साथ तुलना करें।
मुझे वेबहुक की गुप्त कुंजी कहाँ मिलती है?
वेबहुक के पृष्ठ पर, जहाँ इसे फिर से बनाया भी जा सकता है।
क्या मैं अपने एंडपॉइंट को पासवर्ड से सुरक्षित कर सकता हूँ?
हाँ। वेबहुक में सिग्नेचर के ऊपर बेसिक ऑथ लॉगिन और पासवर्ड जोड़ा जा सकता है।
विफल डिलीवरी
एक डिलीवरी जिसे तीस सेकंड के भीतर कोई 2xx उत्तर नहीं मिलता है, उसे दस बार तक पुनः प्रयास किया जाता है, प्रत्येक प्रतीक्षा पिछले से चार सेकंड अधिक होती है, इसलिए पुनर्प्रयास लगभग चार मिनट के भीतर समाप्त हो जाता है। रिट्री-आफ्टर के साथ 429 उत्तर का उस समय के बाद पुनः प्रयास किया जाता है। किसी ईवेंट की पहली विफलता व्यवस्थापक में एक अधिसूचना डालती है।
लगातार सौ असफल डिलीवरी के बाद वेबहुक को सिस्टम द्वारा ब्लॉक कर दिया जाता है और कोई और इवेंट नहीं मिलता है। इसका पेज उससे पहले चेतावनी देता है और एक अनब्लॉक बटन है; एक सफल डिलीवरी से गिनती रीसेट हो जाती है।
प्रत्येक वेबहुक के पृष्ठ पर उसकी डिलीवरी का एक जर्नल होता है, जिसमें भेजे गए अनुरोध और प्राप्त उत्तर का विवरण होता है। रीसेंड उसी इवेंट को दोबारा केवल इस वेबहुक पर भेजता है।
मेरा सर्वर बंद था। क्या इवेंट्स खो गए हैं?
प्रत्येक डिलीवरी को लगभग चार मिनट के भीतर दस बार तक पुनः प्रयास किया जाता है। उसके बाद, वेबहुक की जर्नल खोलें और जिन घटनाओं के लिए आपको आवश्यकता है उन पर पुनः भेजें का उपयोग करें।
मेरा वेबहुक ईवेंट क्यों प्राप्त करना बंद कर दिया?
लगातार सौ असफल डिलीवरी के बाद इसे सिस्टम द्वारा ब्लॉक कर दिया गया है। एंडपॉइंट को ठीक करें और वेबहुक के पृष्ठ पर अनब्लॉक दबाएं।
क्या मैं देख सकता हूँ कि मेरी वेबहुक पर क्या भेजा गया था?
हाँ। प्रत्येक वेबहुक के पृष्ठ पर डिलीवरी की एक पत्रिका होती है, जिसमें भेजी गई अनुरोध और प्राप्त उत्तर होता है।
एकीकरण टैब

इंटीग्रेशन टैब समूह के अनुसार तैयार तरीकों की सूची देता है:
- अपने चेकआउट पर स्टैम्प करें — Poster, Toast, आपका अपना POS या CRM और क्या आप अपना POS नहीं देख रहे हैं?;
- राजकोषीय प्राप्तियाँ — SmartKasa;
- आटोमेशन — Make, Zapier और Public Swagger.
प्रत्येक कार्ड बताता है कि क्या उसे API कुंजी की आवश्यकता है। टैब हर देश में वही कार्ड पेश करता है; केवल वित्तीय रसीदें देश द्वारा सीमित हैं।

एक White Label व्यवसाय कोई Make, Zapier या Public Swagger कार्ड नहीं देखता और उसे Poster या 7stamp.com पर सेटअप गाइड्स की पेशकश नहीं की जाती।
कौन से POS सिस्टम कनेक्ट करने के लिए तैयार हैं?
Poster, और Toast जब यह प्लेटफ़ॉर्म के लिए चालू हो जाएगा — तब तक यह ‘जल्द आ रहा है’ दिखाता है। अन्य सिस्टम API के माध्यम से जुड़ते हैं, अपने स्वयं के POS या CRM के साथ।
क्या एकीकरण देश द्वारा सीमित हैं?
नहीं। टैब हर देश में एक ही कार्ड प्रदान करता है। केवल वित्तीय रसीदें ही देश द्वारा सीमित होती हैं।
मैं Make और Zapier क्यों नहीं देख रहा हूँ?
उन्हें White Label व्यवसाय को नहीं दिखाया गया है। इसके API कुंजी और वेबहुक्स वैसे ही काम करते हैं।
Poster
Poster हमारा ऐप Poster मार्केटप्लेस में है। Poster में इंस्टॉल करने से इसका लिस्टिंग खुलती है, और ऐप को स्टाफ लॉगिन की API कुंजी के साथ सेट किया गया है। इसके स्टैम्प उस स्टाफ लॉगिन के Card Operations के रूप में गिने जाते हैं।
मैं Poster को कैसे कनेक्ट करूँ?
इंटीग्रेशन खोलें → Poster और Poster में इंस्टॉल चुनें। ऐप को स्टाफ लॉगिन की API कुंजी के साथ सेट किया गया है।
किसके Card Operations का Poster स्टाम्प इस्तेमाल करते हैं?
कर्मचारी लॉगिन में उन लोगों का जिनकी API कुंजी ऐप उपयोग करता है।
क्या मुझे Poster के लिए API कुंजी की आवश्यकता है?
हाँ, यह एक स्टाफ लॉगिन की API कुंजी है।
Toast
Toast हर Business के लिए “जल्द आ रहा है” दिखाता है जब तक कि Toast एक्सेस प्लेटफ़ॉर्म पर सेट नहीं किया जाता। यह पूरे प्लेटफ़ॉर्म के लिए एक स्विच है, Business की सेटिंग नहीं; जब यह चालू होता है, तो Toast कार्ड सेटअप स्वयं रखता है।
प्रत्येक Toast स्थान अपने GUID के माध्यम से एक स्टाफ लॉगिन से जुड़ा होता है, बिना किसी API कुंजी के: उस स्टाफ लॉगिन का व्यवसाय, स्टाम्प कार्ड और योजना स्थान से आने वाले प्रत्येक Toast अनुरोध पर लागू होते हैं। एक स्थान केवल एक स्टाफ लॉगिन से जुड़ा हो सकता है, और एक स्टाफ लॉगिन केवल एक स्थान रखता है। एक स्थान से आने वाले अनुरोधों को अस्वीकार कर दिया जाता है जब वह डिस्कनेक्ट हो जाता है, या जब इसका स्टाफ लॉगिन बंद या हटाया गया होता है।
प्रत्येक वाउचर को Toast मेनू उत्पाद दिया जा सकता है: Toast POS पर यह उस उत्पाद पर छूट बन जाता है। बिना वाउचर को चेक पर शून्य छूट के रूप में लागू किया जाता है, और कैशियर उपहार को हाथ से सौंप देता है। वाउचर Toast POS पर भुनाए जाते हैं, और भुगतान किए गए चेक द्वारा पहुंचा गया पहिया एक ही बार में घूम जाता है। जब Toast किसी लेन-देन को पूर्ववत करता है, तो उसके स्टाम्प वापस ले लिए जाते हैं या उसके भुनाए गए वाउचर बहाल कर दिए जाते हैं।
एक अतिथि Toast कियोस्क या अतिथि-सामना वाली स्क्रीन पर फ़ोन नंबर या ईमेल के साथ शामिल हो सकता है। स्टाम्प कार्ड तुरंत जारी किया जाता है; अतिथि को 7Stamp से तब तक कुछ नहीं मिलता जब तक वे इसे उसी फ़ोन या ईमेल से नहीं खोलते।
क्यों Toast कहता है कि जल्दी आ रहा है?
Toast एक्सेस पूरे प्लेटफ़ॉर्म के लिए एक ही स्विच है, आपके बिज़नेस की सेटिंग नहीं। जब तक यह चालू नहीं होता, जोड़ने के लिए कुछ भी नहीं है।
एक Toast स्थान कैसे जुड़ा हुआ है?
इसके GUID के द्वारा एक स्टाफ लॉगिन के लिए, बिना किसी API कुंजी के। उस स्टाफ लॉगिन का स्टांप कार्ड और योजना स्थान से आने वाली हर अनुरोध पर लागू होती है।
जब Toast किसी चेक को शून्य कर देता है तो स्टैम्प्स का क्या होता है?
जब Toast एक लेनदेन को रद्द करता है, तो उसके स्टाम्प वापस ले लिए जाते हैं या उसके रिडीम किए गए वाउचर वापस कर दिए जाते हैं।
SmartKasa

SmartKasa को किसी API कुंजी की आवश्यकता नहीं है। यह रसीद स्कैनिंग में एक रसीद स्रोत है, जिसे SmartKasa दुकान ID या कंपनी कोड द्वारा प्रत्येक दुकान को कवर करने के लिए जोड़ा जाता है। ग्राहक व्यवसाय के चैटबॉट में SmartKasa रसीद को स्कैन करते हैं, और टिकट उस रसीद स्रोत के स्टाफ लॉगिन पर जाते हैं।
SmartKasa यूक्रेनी है, और राजकोषीय प्राप्तियां केवल यूक्रेन, स्लोवाकिया, कजाकिस्तान और उज़्बेकिस्तान में काम करती हैं।
क्या मुझे SmartKasa के लिए API कुंजी की आवश्यकता है?
नहीं। SmartKasa रसीद स्कैनिंग में एक रसीद स्रोत है, जिसे एक दुकान ID या कंपनी कोड द्वारा जोड़ा गया है।
ग्राहक SmartKasa रसीद कहाँ स्कैन करते हैं?
आपके व्यवसाय के चैटबोट में। स्टांप उस रसीद स्रोत के कर्मचारी लॉगिन पर जाते हैं।
किस देशों में वित्तीय रसीदें काम करती हैं?
यूक्रेन, स्लोवाकिया, कज़ाख़स्तान और उज्बेकिस्तान में।
Make और Zapier

Make के लिए 7Stamp ऐप Make की सार्वजनिक ऐप लाइब्रेरी में है: किसी भी Make परिदृश्य में 7Stamp खोजें, या इंटीग्रेशन टैब पर Make में खोलें का उपयोग करें। हमारा Zapier ऐप Zapier की सार्वजनिक निर्देशिका में नहीं है: Zapier में खोलें एक आमंत्रण है जो ऐप को व्यवसाय के अपने Zapier खाते में जोड़ता है। दोनों ऐप्स स्टाफ लॉगिन की API कुंजी के साथ काम करते हैं।
Make परिदृश्य और जैप्स 7Stamp वेबहुक द्वारा शुरू किए जाते हैं, इसलिए ट्रिगर्स को Webhooks & Events ऐड-ऑन की आवश्यकता होती है। स्टाम्प जोड़ने या वाउचर जारी करने जैसी कार्रवाइयों के लिए केवल API कुंजी की आवश्यकता होती है। White Label व्यवसाय को Make और Zapier की पेशकश नहीं की जाती है।
Make और Zapier में 7Stamp ऐप कहाँ मिलेगा?
Make में किसी भी परिदृश्य में 7Stamp खोजें — ऐप Make की सार्वजनिक ऐप लाइब्रेरी में है। Zapier में यह अभी सार्वजनिक नहीं है, इसलिए इंटीग्रेशन टैब पर Zapier में खोलें का उपयोग करें — निमंत्रण आपके अपने खाते में ऐप जोड़ता है।
क्या Make और Zapier को Webhooks & Events ऐड-ऑन की आवश्यकता है?
ट्रिगर्स ऐसे करते हैं, क्योंकि परिदृश्य और Zaps 7Stamp वेबहुक्स द्वारा शुरू किए जाते हैं। स्टैम्प जोड़ने या वाउचर जारी करने जैसी कार्रवाइयों के लिए केवल API कुंजी की आवश्यकता होती है।
क्या मुझे Make या Zapier के लिए API कुंजी की आवश्यकता है?
हाँ। ये ऐप्स स्टाफ लॉगिन की API कुंजी के साथ काम करती हैं।