API आणि इंटिग्रेशन्स

सेटिंग्ज → API & इंटिग्रेशन्समध्ये तीन टॅब्स आहेत: API कीज, वेबहुक्स आणि इंटिग्रेशन्स.
प्रत्येक योजनेवर API आणि API की मोफत आहेत, Free Forever समाविष्ट आहे; API हे अॅड-ऑन नाही. स्टॅम्प जे API मधून दिले जातात ते इतर कोणत्याही Card Operations सारखे असतात, त्यामुळे जेव्हा योजनेच्या Card Operations संपतात तेव्हा ते थांबतात. वेबहुक्स हे पेमेंट केलेले भाग आहेत, खाली पहा.
API चे अतिरिक्त खर्च आहे का?
नाही. API आणि API की प्रत्येक योजनेवर फुकट आहेत, Free Forever समाविष्ट आहे. त्याद्वारे दिलेल्या स्टॅम्प ही Card Operations प्रमाणे कोणत्याही इतरांसारखी आहेत.
मी Free Forever वर API वापरू शकतो का?
हो. जेव्हा प्लॅनचा Card Operations संपतो, स्टॅम्प API द्वारे इतर कोणत्याही प्रमाणे थांबतो.
API ची सेटिंग्ज कुठे आहेत?
सेटिंग्ज → API & इंटिग्रेशन्समध्ये, तीन टॅब्ससह — API कीज, वेबहुक्स आणि इंटिग्रेशन्स.
API कीज

API keys → Add API key अंतर्गत एका कर्मचारी लॉगिनसाठी API key तयार केली जाते. कर्मचारी लॉगिनकडे जास्तीत जास्त एक API key असते आणि बंद केलेला कर्मचारी लॉगिन निवडता येत नाही. निवडण्यासाठी कर्मचारी लॉगिन नसेल, तर Generate API key विंडो तिथेच एक तयार करण्याचा पर्याय देते; नवीन कर्मचारी लॉगिनसाठी मोकळा Staff Seat आवश्यक असतो आणि प्लॅन पूर्ण असल्यास विंडो सीट वाढवण्याचा किंवा त्याऐवजी प्लॅन निवडण्याचा पर्याय देते.
API कीने केलेल्या प्रत्येक कॉलचा परिणाम त्याच्या कर्मचारी लॉगिन प्रमाणे होतो: तो फक्त त्या कर्मचारी लॉगिन च्या व्यवसाय पर्यंत पोहोचतो, स्टॅम्प कार्ड निवडलेल्या स्टॅम्प देणे अंतर्गत आणि त्याचा स्टॅम्प मोजणी त्या कर्मचारी लॉगिन च्या Card Operations प्रमाणे असते.
कुंजी कधीही API कुंजी यादीतून पाहिली आणि कॉपी केली जाऊ शकते. ती QR कोड म्हणून देखील दाखविली जाऊ शकते, ज्यामुळे ती टर्मिनलमध्ये स्कॅन केली जाऊ शकते, आणि कर्मचारी लॉगिन च्या नावासह मुद्रित केली जाऊ शकते.
मी API की कशी तयार करावी?
सेटिंग्ज → API & इंटिग्रेशन्स → API कीज मध्ये, Add API की निवडा आणि एक कर्मचारी लॉगिन निवडा. प्रत्येक कर्मचारी लॉगिन कडे कमाल एक API की असते.
मी माझी API की गमावली आहे. मला नवीन की हवी आहे का?
नाही. की API की सूचीतून कोणत्याही वेळी पाहिली आणि कॉपी केली जाऊ शकते, किंवा QR कोड म्हणून दर्शविली जाऊ शकते.
API कोणत्या स्टॅम्प कार्ड ला स्टॅम्प कॉल करते?
की कर्मचारी लॉगिन च्या खाली Automatic स्टॅम्प देणे साठी निवडलेला. त्याचा स्टॅम्प मोजणी त्या कर्मचारी लॉगिन च्या Card Operations प्रमाणे आहे.
मी नवीन कीसाठी कर्मचारी लॉगिन का निवडू शकत नाही?
एक बंद कर्मचारी लॉगिन उघडला जाऊ शकत नाही, आणि ज्याच्याकडे आधीच की आहे असा कर्मचारी लॉगिन दुसरी की मिळवू शकत नाही. उघडण्यासाठी काहीही नसल्याने, विंडो कर्मचारी लॉगिन तयार करण्याची ऑफर देते.
जेव्हा API की कार्य करणे थांबवते
API की कधीही संपत नाही. ती फक्त ते पुन्हा तयार केल्यावर किंवा हटविल्यावर, किंवा त्याचा कर्मचारी लॉगिन बंद किंवा हटविल्यावर कार्य करणे थांबते. कर्मचारी लॉगिन साठी नवीन पासवर्ड किंवा लॉगिन याचा त्यावर प्रभाव पडत नाही.
- Regenerate कर्मचारी लॉगिन ला नवीन API की देते; जुनी लगेच काम करणे थांबवते.
- Delete की लगेच थांबवते. कर्मचारी लॉगिन स्वतः 7Stamp Scanner मध्ये काम करत राहते आणि नंतर नवीन की मिळवू शकते.
- कर्मचारी लॉगिन बंद केल्यावर त्याची की कायम राहते: जेव्हा कर्मचारी लॉगिन पुन्हा चालू केले जाते, तेव्हा तीच की पुन्हा कार्य करते.
API कीची कालमर्यादा संपते का?
नाही. ते फक्त ते पुनर्निर्मित किंवा हटवले जाते, किंवा जेव्हा त्याचे कर्मचारी लॉगिन बंद केले जाते किंवा हटवले जाते तेव्हा ते थांबते.
मी कर्मचारी लॉगिन ची पासवर्ड बदलली. मला नवीन API की हवी आहे का?
नाही. नवीन पासवर्ड किंवा लॉगिन API कीवर परिणाम करत नाही.
मी कर्मचारी लॉगिन पुन्हा चालू केले. त्याची जुनी API कळ काम करते का?
हो. कर्मचारी लॉगिन ला बंद केल्याने त्याची की टिकून राहते, आणि तीच की पुन्हा चालू केल्यावर परत कार्य करते.
API काय करते
API च्या माध्यमातून एक प्रणाली करू शकते:
- स्टॅम्प कार्ड ला लिंक म्हणून किंवा QR म्हणून वितरित करा;
- स्टॅम्प जोडा;
- त्याचे स्टॅम्प, ध्येय आणि व्हाउचर सह कार्ड वाचा;
- व्हाउचर थेट कार्डकडे जारी करा;
- त्याच्या व्हाउचर कोडने व्हाउचर रिडीम करा;
- ग्राहक ला संदेश पाठवा.
API व्यवसाय च्या स्वतःच्या ओळखणाऱ्याद्वारे, जसे की CRM ID, फोन किंवा ईमेल, external_id म्हणून पाठवलेल्या ग्राहक ची कार्ड शोधतो. ओळखणी कार्डवर साठवली जाते आणि त्याबद्दल प्रत्येक Webhook मध्ये परत येते. API कडे कोणताही कॉल नाही जो व्यवसाय ची ग्राहक सूचीबद्ध करतो: संपूर्ण ग्राहक बेस फक्त अॅडमिन एक्सपोर्टद्वारे बाहेर काढला जातो.
API की च्या ऐवजी, एखादी अॅप कर्मचारी लॉगिन च्या लॉगिन आणि पासवर्डने साइन इन करू शकते — ज्या डिव्हाइसवर कॅशियर साइन इन करतो. API की अशा डिव्हाइससाठी योग्य आहे जे स्वयंपूर्ण चालते. वेबहुक्स फक्त प्रशासकात जोडले जातात; API ला इव्हेंटस सदस्यत्व घेण्याचा किंवा त्यांची यादी करण्याचा कॉल नाही.
API कोणतीही विनंती दर मर्यादा सेट करत नाही: कॉलची संख्या किंवा वारंवारिता यावर कोणतीही सीमा नाही, आणि त्याच कार्डला लगेच पुन्हा स्कॅन केले जाऊ शकते. स्टॅम्प देणे द्वारे त्यावर मर्यादा घालणारे म्हणजे योजनेचे Card Operations आहे.
आपण आमच्या स्वतःच्या CRM किंवा POS मधून स्टॅम्प जोडू शकतो का?
हो, API द्वारे. हे स्टॅम्प कार्ड वितरित करते, स्टॅम्प जोडते, कार्ड वाचते आणि व्हाउचर रिडीम करते. तुमच्या प्रणालीला घटनांबद्दल सांगण्यासाठी, एक Webhook जोडा — त्यासाठी Webhooks & Events अॅड-ऑन आवश्यक आहे.
आपण डेटा निर्यात करू शकतो का?
API द्वारे आपण आपला स्वतःचा ओळखकर्ता वापरून कार्ड वाचता, आणि वेबहूक इव्हेंट्स जसे घडतात तसे पाठवतात. API कडे सर्व ग्राहक ची यादी नाही — संपूर्ण ग्राहक बेस अॅडमिन एक्सपोर्टद्वारे घेतला जातो.
API ग्राहक चे कार्ड कसे शोधते?
तुमच्या स्वतःच्या ओळखपत्राद्वारे — CRM ID, फोन किंवा ईमेल — external_id म्हणून पाठवले जाते. हे कार्डवर संग्रहित केले जाते आणि त्याबद्दल प्रत्येक वेबहुकमध्ये परत येते.
मी API द्वारे वेबहुक्ससाठी सदस्यता घेऊ शकतो का?
नाही. वेबहुक फक्त अॅडमिनमध्ये जोडले जातात.
API ला दर मर्यादा आहे का?
नाही. कॉल्सची संख्या किंवा वारंवारतेने मर्यादा नाही, आणि त्याच कार्डला लगेच पुन्हा स्कॅन केले जाऊ शकते. स्टॅम्प देणे फक्त योजनेच्या Card Operations ने मर्यादित आहे.
API संदर्भ
API संदर्भ सार्वजनिक आहे आणि साइन-इनची गरज नाही: https://api.7loc.com/cards-api/docs, येथे Swagger आहे आणि https://api.7loc.com/cards-api/openapi.json. येथे OpenAPI फाइल आहे. calls https://api.7loc.com/cards-api वर जातात आणि API key किंवा कर्मचारी लॉगिन आवश्यक असतो.
A 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 महिन्याचा, फक्त सशुल्क योजना असलेल्या वापरकर्त्यांसाठी उपलब्ध आहे. पहिला वेबहुक जोडताना ते खरेदी करण्याचा पर्याय उपलब्ध होतो; त्याशिवाय वेबहुक तयार केला जाऊ शकत नाही किंवा पुन्हा सुरू केला जाऊ शकत नाही. एका ऍड-ऑनमुळे एकच वेबहुक सुरू ठेवला जातो: अधिक जोडले जाऊ शकतात, परंतु सदस्यतेच्या प्रत्येक बिलिंग अद्यतनाने सर्व जुने वेबहुक बंद होतात.
वेबहुक जोडल्या गेल्यापासून जेव्हा ते घडतात तेव्हा वेबहुक इव्हेंट पाठवतात. आधीचे इव्हेंट पाठवले जात नाहीत.
वेबहुक्स मोफत आहेत का?
नाही. त्यांना 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 ने नाही; फिरवल्याची वाट पाहणारे चाक अद्याप काही पाठवत नाही.
ग्राहक पुनरावलोकने स्टॅम्प कार्ड events नाहीत. प्रत्येक नवीन पुनरावलोकन review ही entity आणि created ही action असलेला event, Webhook पृष्ठावर ज्यांच्या objects मध्ये Reviews निवडले आहेत त्या Webhooks कडे पाठवते. येथे जोडलेला Webhook फक्त स्टॅम्प कार्ड events साठी सेट असतो, त्यामुळे Reviews निवडल्यानंतरच त्याला पुनरावलोकने मिळतात.
जेव्हा स्कॅनमध्ये स्टॅम्प जोडला जात नाही तेव्हा वेबहुक पाठविला जातो का?
हो. असा स्कॅन जो स्टॅम्प वाढवत नाही, जसे की स्टॅम्प किमतीच्या खाली खरेदी, तरीही SCAN शून्य स्टॅम्प जोडल्याशिवाय पाठवतो.
कौनता कार्यक्रम मला सांगतो की ग्राहक विजेते झाले आहे?
LOTTERY_WIN, एकदाच पाठवले जाते जेव्हा चाक फिरवले जाते. फिरण्यासाठी थांबलेले चाक अद्याप काहीही पाठवत नाही.
मी सांगू शकतो का जेव्हा ग्राहक त्यांच्या वॉलेटमधून कार्ड काढतो?
हो. वॉलेटमध्ये पास जोडल्यावर आणि काढल्यावर CARD_ADDED_TO_WALLET आणि CARD_REMOVED_FROM_WALLET पाठवले जातात, वॉलेट, ऍपल किंवा गुगलसह.
मी नवीन ग्राहक पुनरावलोकने वेबहुकद्वारे कसे मिळवू?
Webhook च्या पृष्ठावर जा आणि त्याच्या ऑब्जेक्ट्समध्ये पुनरावलोकने निवडा. त्यानंतर प्रत्येक नवीन पुनरावलोकन पुनरावलोकन एंटिटी आणि created क्रियेसह येतो; API अंतर्गत जोडलेला Webhook आणि इंटीग्रेशन्सपर्यंत फक्त स्टॅम्प कार्ड इव्हेंट्स प्राप्त होतात.
जेव्हा प्रत्येक घटना पाठवली जाते
| घटना | जेव्हा पाठवले |
|---|---|
SCAN | कर्मचारी लॉगिन कार्ड स्कॅन करते: 7Stamp Scanner मध्ये, API मधून किंवा POS सारख्या Toast कडून. 7Stamp Scanner मध्ये काढलेले स्टॅम्प हे नकारात्मक stamps_added सह SCAN आहेत. |
DELIVERY_INSERT | A ग्राहक एक स्टॅम्प कोड उघडतो जो स्टॅम्प देतो — एक QR, एक लिंक, कोड स्वतः किंवा API द्वारे केलेले आमंत्रण |
RECEIPT_SCAN | ग्राहक व्यवसाय च्या चॅटबॉट मध्ये आर्थिक पावती स्कॅन करतो आणि त्यावर टपाल लावले जाते; amount हा पावतीचा एकूण आहे |
CARD_JOINED | A ग्राहक नवीन स्टॅम्प कार्ड मिळवतो, कोणत्याही प्रकारे, तुमच्यामार्फत दिलेल्या external_id सह |
REWARD_EARNED | एक स्कॅन Award ध्येयाला पोहोचतो |
VOUCHER_ISSUED | एक स्कॅन व्हाउचर ध्येयाला पोहोचतो |
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 मध्ये SCAN म्हणून negative stamps_added सह आले.
VOUCHER_ISSUED आणि ADMIN_VOUCHER_ISSUE यामध्ये काय फरक आहे?
VOUCHER_ISSUED हेव्हा एक स्कॅन व्हाउचर उद्दिष्ट गाठते तेव्हा येते. ADMIN_VOUCHER_ISSUE हेव्हा व्हाउचर थेट कार्डवर दिले जाते, प्रशासनात हाताने किंवा API द्वारे.
स्टॅम्प कोडसह जोडणारा ग्राहक एक इव्हेंट पाठवतो की अनेक?
अनेक. CARD_JOINED प्रथम येतो, नंतर VOUCHER_PACK जर स्टॅम्प कार्ड कडे व्हाउचर पॅक असेल, नंतर 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 उत्तर न मिळाल्यास वितरणाची पुनर्प्रयत्न केली जाते, जास्तीत जास्त दहा वेळा, प्रत्येक प्रतीक्षा मागीलपेक्षा चार सेकंद जास्त, म्हणून पुनर्प्रयत्न सुमारे चार मिनिटांत संपतात. Retry-After सह 429 उत्तर त्या वेळेनंतर पुनर्प्रयत्न केली जाते. एखाद्या घटनाचा पहिला अपयश प्रशासनात सूचना ठेवतो.
सतत शंभर अपयशी डिलिव्हरी झाल्यानंतर वेबहूक सिस्टमद्वारे ब्लॉक केला जातो आणि त्याला आणखी कोणतीही इव्हेंट मिळत नाही. त्याच्या पृष्ठावर यापूर्वीच चेतावणी दिली जाते आणि एक अनब्लॉक बटण आहे; एक यशस्वी डिलिव्हरी मोजणी रीसेट करते.
प्रत्येक वेबहूकच्या पृष्ठावर त्याच्या वितरणांचा जर्नल असतो, ज्यामध्ये पाठवलेली विनंती आणि प्राप्त झालेली उत्तर असते. ‘पुन्हा पाठवा’ फक्त या वेबहूकसाठी त्याच इव्हेंटला पुन्हा पाठवते.
माझा सर्व्हर डाउन होता. कार्यक्रम हरवले आहेत का?
प्रत्येक वितरणाचा अंदाजे चार मिनिटांच्या आत दहा वेळा प्रयत्न केला जातो. त्यानंतर, वेबहुकची जर्नल उघडा आणि तुम्हाला पाहिजे असलेल्या घटनांसाठी रीसेंड वापरा.
माझा वेबहूक इव्हेंट्स प्राप्त करणं का थांबवला?
एकमेकामुळे शंभर अयशस्वी डिलिव्हरींनंतर सिस्टमने ते ब्लॉक केले आहे. एंडपॉइंट दुरुस्त करा आणि वेबहूकच्या पृष्ठावर अनब्लॉक दाबा.
मी माझ्या वेबहूककडे काय पाठवले गेले ते पाहू शकतो का?
हो. प्रत्येक वेबहुकच्या पृष्ठावर वितरणाचा जर्नल असतो ज्यात पाठवलेली विनंती आणि प्राप्त झालेले उत्तर असते.
इंटिग्रेशन्स टॅब

इंटिग्रेशन्स टॅबमध्ये गटानुसार तयार केलेल्या मार्गांची यादी दिली आहे:
- स्टॅम्प आपल्या चेकआउटवर — Poster, Toast, आपला स्वतःचा POS किंवा CRM आणि आपला POS दिसत नाही का?
- आर्थिक पावत्या — SmartKasa;
- ऑटोमेशन — Make, Zapier आणि Public Swagger.
प्रत्येक कार्ड सांगते की त्याला API की पाहिजे का. टॅब प्रत्येक देशात समान कार्डे ऑफर करते; फक्त आर्थिक पावत्या देशाने मर्यादित असतात.

White Label व्यवसाय ला Make, Zapier किंवा Public Swagger कार्ड दिसत नाही आणि Poster किंवा 7stamp.com वरील सेटअप मार्गदर्शक ऑफर केले जात नाहीत.
कोणती POS प्रणाली कनेक्ट करण्यास तयार आहेत?
Poster आणि Toast जेव्हा प्लॅटफॉर्मसाठी चालू केले जाते — तोपर्यंत ते ‘Coming soon’ दर्शविते. इतर प्रणाली API द्वारे जोडतात, आपल्या स्वतःच्या POS किंवा CRM सह.
इंटिग्रेशन्स देशानुसार मर्यादित आहेत का?
नाही. टॅब प्रत्येक देशात त्याच कार्ड्सची ऑफर देते. फक्त आर्थिक पावत्या देशानुसार मर्यादित असतात.
मला Make आणि Zapier का दिसत नाहीत?
त्यांना White Label व्यवसाय ला दाखवले जात नाही. त्याचे API कीज आणि वेबहुक्स तसेच काम करतात.
Poster
Poster हा आमचा Poster मार्केटप्लेसमधील अॅप आहे. Poster मध्ये स्थापित केल्यावर त्याची लिस्टिंग उघडते, आणि अॅप कर्मचारी लॉगिन च्या API कीसह सेट केलेले आहे. त्याची स्टॅम्प मोजणी त्या कर्मचारी लॉगिन च्या Card Operations प्रमाणे आहे.
मी Poster कसा कनेक्ट करु?
इंटिग्रेशन्स उघडा → Poster आणि Poster मध्ये इन्स्टॉल निवडा. अॅप कर्मचारी लॉगिन च्या API कीसह सेट अप केले आहे.
Poster स्टॅम्प कोणाचा Card Operations वापर करतात?
जे कर्मचारी लॉगिन चे आहेत ज्यांची API की अॅप वापरते.
मला Poster साठी API की लागेल का?
हो, कर्मचारी लॉगिन च्या API की.
Toast
Toast प्रत्येक व्यवसाय साठी ‘लवकरच येत आहे’ दर्शवितो जेव्हा पर्यंत Toast प्रवेश प्लॅटफॉर्मवर सेट केला जात नाही. हा संपूर्ण प्लॅटफॉर्मसाठी एकच स्विच आहे, व्यवसाय ची सेटिंग नाही; एकदा तो सुरू झाला की, Toast कार्ड स्वतः सेटअप धरते.
प्रत्येक Toast स्थान त्याच्या GUID ने एका कर्मचारी लॉगिनशी जोडलेले असते; API key लागत नाही. त्या कर्मचारी लॉगिनचा व्यवसाय, स्टॅम्प कार्ड आणि प्लॅन त्या स्थानावरून येणाऱ्या प्रत्येक Toast विनंतीला लागू होतो. एक स्थान फक्त एका कर्मचारी लॉगिनशी जोडता येते आणि कर्मचारी लॉगिनकडे एकच स्थान असते. स्थान डिस्कनेक्ट केल्यावर किंवा त्याचा कर्मचारी लॉगिन बंद किंवा हटवलेला असताना त्या स्थानावरील विनंत्या नाकारल्या जातात.
प्रत्येक Voucher ला Toast मेनू उत्पादन दिले जाऊ शकते: Toast POS मध्ये ते त्या उत्पादनावरील सवलत बनते. उत्पादन नसलेला Voucher बिलावर शून्य सवलत म्हणून लागू होतो आणि कॅशियर भेट हाताने देतो. Toast POS मध्ये Vouchers रिडीम केले जातात आणि सशुल्क बिलाने मिळालेले चाक लगेच फिरवले जाते. Toast व्यवहार रद्द केल्यास त्याचे स्टॅम्प परत घेतले जातात किंवा रिडीम केलेले Vouchers पुनर्संचयित केले जातात.
अतिथी Toast किओस्क किंवा अतिथी-सामना करणाऱ्या स्क्रीनवर फोन नंबर किंवा ईमेल वापरून सामील होऊ शकतो. स्टॅम्प कार्ड ताबडतोब जारी केला जातो; अतिथी 7Stamp कडून काहीही मिळवू शकत नाही जोपर्यंत ते त्याच फोन किंवा ईमेलसह ते उघडत नाहीत.
Toast का ‘Coming soon’ म्हणते?
Toast प्रवेश हा संपूर्ण प्लॅटफॉर्मसाठी एक स्विच आहे, तुमच्या व्यवसाय चे सेटिंग नाही. तो सुरू होईपर्यंत, कनेक्ट करण्यास काहीही नाही.
Toast स्थळ कसे जोडले गेले आहे?
त्याच्या GUID द्वारे एका कर्मचारी लॉगिन कडे, कोणतीही API की वापरली नाही. त्या कर्मचारी लॉगिन ची स्टॅम्प कार्ड आणि योजना त्या ठिकाणाहून येणार्या प्रत्येक विनंतीस लागू होतात.
जेव्हा Toast चेक रद्द करतो तेव्हा स्टॅम्प ला काय होते?
जेव्हा Toast एखादी व्यवहार रद्द करतो, तेव्हा त्याचे स्टॅम्प परत घेतले जातात किंवा त्याचे भडकलेले व्हाउचर पुनर्संचयित केले जातात.
SmartKasa

SmartKasa साठी API key आवश्यक नाही. तो पावती स्कॅनिंगमधील पावतीचा स्रोत आहे; प्रत्येक दुकानासाठी SmartKasa दुकानाच्या ID ने किंवा कंपनी कोडने जोडला जातो. ग्राहक व्यवसायाच्या Chatbot मध्ये SmartKasa पावती स्कॅन करतात आणि स्टॅम्प त्या पावतीच्या स्रोताच्या कर्मचारी लॉगिनकडे जातात.
SmartKasa हा युक्रेनियन आहे, आणि वित्तीय पावत्या फक्त युक्रेन, स्लोव्हाकिया, कझाकस्तान आणि उझबेकिस्तानमध्येच वापरल्या जातात.
मला SmartKasa साठी API की लागेल का?
नाही. SmartKasa हा पावती स्कॅनिंगमधील पावतीचा स्रोत आहे; तो दुकानाच्या ID ने किंवा कंपनी कोडने जोडला जातो.
ग्राहक हा SmartKasa रसीद कुठे स्कॅन करतो?
तुमच्या व्यवसाय च्या चॅटबॉट मध्ये. स्टॅम्प त्या पावतीच्या स्त्रोताच्या कर्मचारी लॉगिन कडे जातात.
कोणत्या देशांमध्ये आर्थिक प्राप्ती कार्य करतात?
युक्रेन, स्लोव्हाकिया, कझाकस्तान आणि उझबेकिस्तानमध्ये.
Make आणि Zapier

Make साठीचे 7Stamp अॅप Make च्या सार्वजनिक अॅप लायब्ररीत आहे: कोणत्याही Make सिनारिओमध्ये 7Stamp शोधा, किंवा इंटिग्रेशन टॅबवर Make मध्ये उघडा वापरा. आमचे Zapier अॅप Zapier च्या सार्वजनिक निर्देशिकेत नाही: Zapier मध्ये उघडा हे एक आमंत्रण आहे जे अॅप व्यवसायाच्या स्वतःच्या Zapier खात्यात जोडते. दोन्ही अॅप्स कर्मचारी लॉगिनच्या API कीसह कार्य करतात.
Make शक्यतांचा आणि Zaps ची सुरूवात 7Stamp Webhooks द्वारा केली जाते, त्यामुळे ट्रिगरना Webhooks & Events अॅड-ऑनची आवश्यकता असते. स्टॅम्प जोडणे किंवा व्हाउचर जारी करणे यासारख्या कृतींना फक्त API कीची आवश्यकता असते. Make आणि Zapier White Label व्यवसाय ला ऑफर केले जात नाहीत.
Make आणि Zapier मध्ये 7Stamp अॅप कुठे मिळेल?
Make मध्ये कोणत्याही सिनारिओमध्ये 7Stamp शोधा — अॅप Make च्या सार्वजनिक अॅप लायब्ररीत आहे. Zapier मध्ये ते अद्याप सार्वजनिक नाही, म्हणून इंटिग्रेशन टॅबवर Zapier मध्ये उघडा वापरा — आमंत्रणामुळे अॅप तुमच्या स्वतःच्या खात्यात जोडले जाते.
Make आणि Zapier यांना Webhooks & Events अॅड-ऑनची गरज आहे का?
ट्रिगर्स करतात, कारण परिस्थिती आणि झॅप्स 7Stamp वेबहुक्सद्वारे सुरू होतात. स्टॅम्प जोडणे किंवा व्हाउचर जारी करणे यांसारख्या कृतींसाठी फक्त API कीची आवश्यकता असते.
मला Make किंवा Zapier साठी API की आवश्यक आहे का?
हो. ऍप्स कर्मचारी लॉगिन च्या API कीसह काम करतात.