API & ஒருங்கிணைப்புகள்

அமைப்புகள் → API & ஒருங்கிணைப்புகள் மூன்று தாவல்களைக் கொண்டுள்ளதுஃ API விசைகள், Webhooks மற்றும் ஒருங்கிணைப்புகள்.
API மற்றும் API விசைகள் Free Forever உட்பட ஒவ்வொரு திட்டத்திலும் இலவசம்; API துணை நிரல் இல்லை. API வழியாக வழங்கப்படும் முத்திரைகள் Card Operation போன்றவை, எனவே அவை திட்டத்தின் Card Operations காலாவதியாகும்போது நிறுத்தப்படுகின்றன.
API கூடுதலாக செலவாகுமா?
எண். API மற்றும் API விசைகள் Free Forever உட்பட அனைத்து திட்டங்களிலும் இலவசம். இதன் மூலம் வழங்கப்படும் முத்திரைகள் வேறு எந்த Card Operation போன்றவை.
நான் API Free Forever பயன்படுத்த முடியுமா?
ஆம். திட்டத்தின் Card Operations முடிந்ததும், API வழியாக முத்திரைகள் நிறுத்தப்படுகின்றன.
API அமைப்புகள் எங்கே?
அமைப்புகள் → API & ஒருங்கிணைப்புகள், மூன்று தாவல்களுடன் — API விசைகள், Webhooks மற்றும் ஒருங்கிணைப்புகள்.
API விசைகள்

API விசைகளின் கீழ் API விசை உருவாக்கப்படுகிறது → ஒரு பணியாளர் உள்நுழைவுக்கான API விசை சேர்க்கவும். ஒரு பணியாளர் உள்நுழைவில் அதிகபட்சம் ஒரு API விசை உள்ளது, மற்றும் ஒரு முடக்கப்பட்ட பணியாளர் உள்நுழைவைத் தேர்ந்தெடுக்க முடியாது. தேர்ந்தெடுக்க பணியாளர் உள்நுழைவு இல்லாததால், ஜெனரேட் API விசை சாளரம் அதை உருவாக்க வழங்குகிறது; ஒரு புதிய பணியாளர் உள்நுழைவுக்கு இலவச Staff Seat தேவைப்படுகிறது, முழு திட்டத்தில் சாளரம் ஒரு இருக்கை சேர்க்க அல்லது அதற்கு பதிலாக ஒரு திட்டத்தைத் தேர்வு செய்ய வழங்குகிறது.
API விசை மூலம் செய்யப்படும் ஒவ்வொரு அழைப்பும் அதன் பணியாளர் உள்நுழைவாக செயல்படுகிறதுஃ அது அந்த பணியாளர் உள்நுழைவு வணிகத்தை மட்டுமே அடைகிறது, தானியங்கி முத்திரை அச்சின் கீழ் அதற்குத் தேர்ந்தெடுக்கப்பட்ட முத்திரை அட்டையை முத்திரையிடும், அதன் முத்திரைகள் அந்த பணியாளர் உள்நுழைவின் Card Operations எனக் கணக்கிடப்படும்.
விசை API விசை பட்டியலில் இருந்து எந்த நேரத்திலும் மீண்டும் பார்க்கப்பட்டு நகலெடுக்கப்படலாம். இது QR குறியீடாகக் காட்டப்படலாம், அதை ஒரு முனையத்தில் ஸ்கேன் செய்து, பணியாளர் உள்நுழைவின் பெயருடன் அச்சிடலாம்.
API விசை ஒன்றை எவ்வாறு உருவாக்குவது?
அமைப்புகள் → API & ஒருங்கிணைப்புகள் → API விசைகளில், API விசைகளைச் சேர்க்கவும் என்பதைத் தேர்ந்தெடுத்து பணியாளர் உள்நுழைவைத் தேர்ந்தெடுக்கவும். ஒவ்வொரு பணியாளர் உள்நுழைவிலும் அதிகபட்சம் ஒரு API விசை உள்ளது.
நான் என் API விசை இழந்தேன். நான் ஒரு புதிய வேண்டும்?
எண். விசை API விசை பட்டியலில் இருந்து எந்த நேரத்திலும் மீண்டும் பார்க்கப்பட்டு நகலெடுக்கப்படலாம் அல்லது QR குறியீடாக காட்டப்படலாம்.
எந்த முத்திரை அட்டை API முத்திரை அழைக்கிறது?
தானியங்கு முத்திரையின் கீழ் விசையின் பணியாளர் உள்நுழைவுக்காகத் தேர்ந்தெடுக்கப்பட்ட ஒன்று. அதன் முத்திரைகள் அந்த பணியாளர் உள்நுழைவின் Card Operations ஆக கணக்கிடப்படும்.
ஏன் நான் ஒரு புதிய திறவுகோல் ஒரு பணியாளர் உள்நுழைவு தேர்வு செய்ய முடியாது?
முடக்கப்பட்ட பணியாளர் உள்நுழைவைத் தேர்ந்தெடுக்க முடியாது, ஏற்கனவே ஒரு திறவுகோலைக் கொண்ட பணியாளர் உள்நுழைவை இரண்டாவது பெற முடியாது. தேர்ந்தெடுக்க யாரும் இல்லாததால், ஜன்னல் ஒரு பணியாளர் உள்நுழைவை உருவாக்க வழங்குகிறது.
ஒரு API விசை வேலை செய்வதை நிறுத்தும்போது
ஒரு API விசை காலாவதியாகாது. அது மறுசீரமைக்கப்படும்போது அல்லது நீக்கப்படும்போது, அல்லது அதன் பணியாளர் உள்நுழைவு அணைக்கப்படும்போது அல்லது நீக்கப்படும்போது மட்டுமே வேலை செய்வதை நிறுத்துகிறது. பணியாளர் உள்நுழைவுக்கான புதிய கடவுச்சொல் அல்லது உள்நுழைவு அதை பாதிக்காது.
- Regenerate Staff Login க்கு API புதிய விசை கொடுக்கிறது; பழைய விசை உடனடியாக வேலை செய்வதை நிறுத்துகிறது.
- Delete திறவுகோலை உடனடியாக நிறுத்துகிறது. ஊழியர் உள்நுழைவு 7Stamp Scanner இல் தொடர்ந்து செயல்படுகிறது மற்றும் பின்னர் ஒரு புதிய திறனைப் பெற முடியும்.
- ஒரு பணியாளர் உள்நுழைவை முடக்குவது அதன் திறனை வைத்திருக்கும்ஃ பணியாளர் உள்நுழைவை மீண்டும் இயக்கும்போது, அதே திறன் மீண்டும் செயல்படுகிறது.
ஒரு API விசை காலாவதியாகிறதா?
இல்லை. அது மறுசீரமைக்கப்படும் அல்லது நீக்கப்படும் போது அல்லது அதன் பணியாளர் உள்நுழைவு அணைக்கப்படும் அல்லது நீக்கப்படும் போது மட்டுமே வேலை செய்வதை நிறுத்துகிறது.
நான் பணியாளர் உள்நுழைவு கடவுச்சொல்லை மாற்றினேன். நான் ஒரு புதிய API விசை வேண்டும்?
இல்லை. புதிய கடவுச்சொல் அல்லது உள்நுழைவு API விசையை பாதிக்காது.
ஒரு Staff Login-ஐ மீண்டும் இயக்கினேன். அதன் பழைய API key இன்னும் வேலை செய்யுமா?
ஆம். ஒரு பணியாளர் உள்நுழைவை அணைப்பது அதன் திறனை வைத்திருக்கும், அது மீண்டும் இயங்கும் போது அதே திறவுகோல் மீண்டும் வேலை செய்யும்.
API என்ன செய்கிறது
API வழியாக ஒரு அமைப்புஃ
- ஒரு முத்திரை அட்டை ஒரு இணைப்பு அல்லது QR வழங்க;
- முத்திரைகளை சேர்க்கவும்;
- அதன் முத்திரைகள், இலக்குகள் மற்றும் கூப்பன்கள் உள்ள ஒரு அட்டையைப் படிக்கவும்;
- ஒரு அட்டையை நேரடியாக அட்டையில் வெளியிடவும்;
- ஒரு கூப்பனை அதன் கூப்பன் குறியீடு மூலம் மீட்டெடுக்கவும்;
- ஒரு வாடிக்கையாளர் செய்தி.
API external_id என அனுப்பப்படும் CRM ஐடி, தொலைபேசி அல்லது email போன்ற வணிகத்தின் சொந்த அடையாளங்காட்டி மூலம் ஒரு வாடிக்கையாளரின் அட்டையைக் கண்டறிகிறது. அடையாளங்காட்டி அட்டையில் சேமிக்கப்பட்டு அதைப் பற்றி ஒவ்வொரு வெப்ஹூக்கில் மீண்டும் வருகிறது. API ஒரு வணிகத்தின் வாடிக்கையாளர்களை பட்டியலிடும் அழைப்பு இல்லைஃ முழு வாடிக்கையாளர் தளமும் நிர்வாக ஏற்றுமதி மூலம் மட்டுமே எடுக்கப்படுகிறது.
ஒரு API விசைக்கு பதிலாக, ஒரு பயன்பாடு ஒரு பணியாளரின் உள்நுழைவு உள்நுழைவு மற்றும் கடவுச்சொல் — உடன் உள்நுழையலாம். ஒரு காசியர் ஒரு சாதனத்திற்கு உள்நுழைகிறார். ஒரு API விசை கண்காணிக்கப்படாமல் இயங்கும் சாதனத்திற்கு ஏற்றது. வலை ஹூக்குகள் நிர்வாகியில் மட்டுமே சேர்க்கப்படுகின்றன; API நிகழ்வுகளுக்கு குழுசேர அல்லது அவற்றை பட்டியலிட அழைப்பு இல்லை.
API-க்கு கோரிக்கை வீத வரம்பு இல்லை: அழைப்புகளின் எண்ணிக்கையையோ அடிக்கடியையோ கட்டுப்படுத்தாது; அதே கார்டை உடனே மீண்டும் ஸ்கேன் செய்யலாம். அதன் மூலம் ஸ்டாம்பிடுவதைக் கட்டுப்படுத்துவது திட்டத்தின் Card Operations வரம்புதான்.
நாம் எங்களின் CRM அல்லது POS இலிருந்து முத்திரைகள் ஐ சேர்க்க முடியுமா?
ஆம், API வழியாக. இது முத்திரை அட்டைகளை விநியோகிக்கிறது, முத்திரைகளை சேர்க்கிறது, அட்டைகளைப் படிக்கிறது மற்றும் கூப்பன்களை மீட்டெடுக்கிறது. நிகழ்வுகளைப் பற்றி உங்கள் அமைப்புக்குத் தெரிவிக்க, Webhooks & Events கூடுதல் தேவைப்படும் ஒரு Webhook — ஐச் சேர்க்கவும்.
நாம் தரவுகளை ஏற்றுமதி செய்ய முடியுமா?
API வழியாக நீங்கள் உங்கள் சொந்த அடையாளங்காட்டி மூலம் அட்டைகளை படிக்கிறீர்கள், மற்றும் Webhooks நிகழ்வுகள் அவை நடக்கும் போது அனுப்பும். API அனைத்து வாடிக்கையாளர்களின் பட்டியலைக் கொண்டிருக்கவில்லை — முழு வாடிக்கையாளர் தளமும் நிர்வாகி ஏற்றுமதி மூலம் எடுக்கப்படுகிறது.
ஒரு வாடிக்கையாளரின் அட்டையை API எவ்வாறு கண்டுபிடிக்கிறது?
உங்கள் சொந்த அடையாளங்காட்டி மூலம் — ஒரு CRM ஐடி, தொலைபேசி அல்லது email — external_id என அனுப்பப்படுகிறது. இது அட்டையில் சேமிக்கப்படுகிறது மற்றும் அதை பற்றி ஒவ்வொரு Webhook இல் மீண்டும் வருகிறது.
API வழியாக Webhooks-ஐ நான் பதிவு செய்யலாமா?
இல்லை. Webhooks நிர்வாகத்தில் மட்டுமே சேர்க்கப்படுகின்றன.
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 key அல்லது Staff Login தேவை.
ஒரு White Label வணிகம் நிர்வாகத்தில் API குறிப்புக்கான இணைப்பைக் காணவில்லை. அதன் API விசைகள் மற்றும் Webhooks அதே வேலை.
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 விசைகள் மற்றும் Webhooks அதே வேலை.
வலைப்பதிவுகள்

API & integrations → Webhooks → Add webhook கீழ் ஒரு Webhook சேர்க்கப்படுகிறது, இது நிகழ்வுகளை பெறும் URL உடன். 7Stamp இல் ஒரு Webhook Stamp card நிகழ்வுகளுக்காக உருவாக்கப்படுகிறது. ஒரு வணிகம் பல Webhooks ஐ சேர்க்கலாம், ஒவ்வொன்றும் அதன் சொந்த URL உடன்.
வெப்ஹூக்குகளுக்கு மாதத்திற்கு Webhooks & Events துணை நிரல், $19 தேவை, இது கட்டண திட்டங்களில் மட்டுமே வழங்கப்படுகிறது. அதை வாங்க முதல் வெப்ஹூக் சலுகைகளைச் சேர்ப்பது; அது இல்லாமல் ஒரு வெப்ஹூக்கை உருவாக்கவோ அல்லது மீண்டும் இயக்கவோ முடியாது. ஒரு துணை நிரல் ஒரு வெப்ஹூக்கை இயக்கமாக வைத்திருக்கிறதுஃ மேலும் சேர்க்கப்படலாம், ஆனால் சந்தாவின் ஒவ்வொரு கட்டண புதுப்பிப்பும் பழையதைத் தவிர அனைத்தையும் அணைக்கிறது.
வெப்ஹூக் சேர்க்கப்பட்ட தருணத்திலிருந்து நிகழ்வுகள் நிகழ்ந்தவாறு அனுப்பப்படுகின்றன. முந்தைய நிகழ்வுகள் அனுப்பப்படுவதில்லை.
Webhooks இலவசம்?
இல்லை. அவர்களுக்கு Webhooks & Events கூடுதல் தேவை, $19 ஒரு மாதத்திற்கு, கட்டண திட்டங்களில் மட்டுமே வழங்கப்படுகிறது. API தானே இலவசம்.
நான் இரண்டாவது Webhook சேர்க்கப்பட்டது அது அணைக்கப்பட்டது. ஏன்?
ஒரு Webhooks & Events கூடுதல் ஒரு Webhook இயக்கப்படுகிறது. சந்தாவின் ஒவ்வொரு கட்டண புதுப்பிப்பு பழையதைத் தவிர அனைத்தையும் அணைக்கிறது.
ஒரு புதிய Webhook கடந்த நிகழ்வுகள் அனுப்பும்?
இல்லை. Webhook சேர்க்கப்படும் தருணத்திலிருந்து நிகழ்வுகள் அனுப்பப்படுகின்றன.
Webhook நிகழ்வுகள்
ஒரு Webhook, event_type எனப் பெயரிடப்பட்ட பதினைந்து Stamp card நிகழ்வுகளைப் பெறும்: 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. கடைசி இரண்டு நிகழ்வுகள், pass ஒரு wallet-இல் சேர்க்கப்படும்போதும் அதிலிருந்து அகற்றப்படும்போதும், Apple அல்லது Google wallet-க்காக வரும்.
எந்த முத்திரையும் சேர்க்காத ஸ்கேன், முத்திரை விலைக்குக் குறைவான கொள்முதல் போன்றது, SCAN ஐ பூஜ்ஜிய முத்திரைகளுடன் சேர்க்கிறது. ஒரு சக்கரத்தில் வென்ற பரிசு சக்கரத்தை சுழற்றும்போது ஒரு LOTTERY_WIN ஆல் அறிவிக்கப்படுகிறது, REWARD_EARNED அல்லது VOUCHER_ISSUED ஆல் அல்ல; சுழற்றப்பட காத்திருக்கும் சக்கரம் இன்னும் எதையும் அனுப்பாது.
வாடிக்கையாளர் விமர்சனங்கள் முத்திரை அட்டை நிகழ்வுகள் அல்ல. ஒவ்வொரு புதிய விமர்சனமும் நிறுவனம் review மற்றும் நடவடிக்கை created உடன் ஒரு நிகழ்வை Webhooks க்கு அனுப்புகிறது, அவை Webhook இன் பக்கத்தில் உள்ள அவற்றின் பொருள்களுக்கு இடையில் விமர்சனங்களை குறிக்கின்றன. இங்கே சேர்க்கப்பட்ட ஒரு Webhook முத்திரை அட்டை நிகழ்வுகளுக்கு மட்டுமே அமைக்கப்படுகிறது, எனவே விமர்சனங்கள் குறிக்கப்பட்டவுடன் இது விமர்சனங்களைப் பெறுகிறது.
எந்த முத்திரையையும் சேர்க்காதபோது ஒரு வெப்ஹூக் அனுப்பப்படுகிறதா?
ஆம். எந்த முத்திரையும் சேர்க்காத ஒரு ஸ்கேன், முத்திரை விலைக்குக் குறைவான கொள்முதல் போன்றது, முத்திரை சேர்க்கப்பட்ட பூஜ்ஜிய முத்திரைகளுடன் SCAN ஐ அனுப்புகிறது.
எந்த நிகழ்வு எனக்கு ஒரு வாடிக்கையாளர் சக்கரத்தில் வெற்றி என்று கூறுகிறது?
LOTTERY_WIN, ஒரு முறை சக்கரத்தை சுழற்றும் போது அனுப்பப்படுகிறது.
ஒரு வாடிக்கையாளர் தனது பணப்பையில் இருந்து அட்டை எடுக்கும் போது நான் சொல்ல முடியுமா?
ஆம். ஒரு பணப்பைக்கு பாஸ் சேர்த்து அதை அகற்றுவது CARD_ADDED_TO_WALLET மற்றும் CARD_REMOVED_FROM_WALLET, பணப்பை, ஆப்பிள் அல்லது கூகிள் மூலம் அனுப்பும்.
எப்படி நான் ஒரு Webhook மூலம் புதிய வாடிக்கையாளர் விமர்சனங்களை பெற?
Webhook இன் பக்கத்தைத் திறந்து அதன் பொருள்களில் மதிப்புரைகளை குறிக்கவும். ஒவ்வொரு புதிய மதிப்பீடும் பின்னர் நிறுவன மதிப்பாய்வு மற்றும் செயல் உருவாக்கத்துடன் வருகிறது; API & ஒருங்கிணைப்புகளின் கீழ் சேர்க்கப்பட்ட Webhook அது வரை Stamp அட்டை நிகழ்வுகளை மட்டுமே பெறுகிறது.
ஒவ்வொரு நிகழ்வு அனுப்பப்படும் போது
| நிகழ்வு | அனுப்பப்படும் போது |
|---|---|
SCAN | ஒரு பணியாளர் உள்நுழைவு 7Stamp Scanner இல், API வழியாக அல்லது POS போன்ற Toast இலிருந்து அட்டையை ஸ்கேன் செய்கிறது. 7Stamp Scanner இல் அகற்றப்பட்ட முத்திரைகள் எதிர்மறையான stamps_added உடன் SCAN ஆகும் |
DELIVERY_INSERT | ஒரு வாடிக்கையாளர் ஒரு முத்திரை குறியீட்டைத் திறக்கிறார், அதில் முத்திரைகள் — ஒரு QR, ஒரு இணைப்பு, குறியீடு அல்லது API வழியாக வழங்கப்பட்ட அழைப்பு |
RECEIPT_SCAN | ஒரு வாடிக்கையாளர் வணிகத்தின் சாட்போட்டில் ஒரு வரி ரசீதுவை ஸ்கேன் செய்கிறார், அது முத்திரையிடப்படுகிறது; amount என்பது ரசீது மொத்தமாகும் |
CARD_JOINED | ஒரு வாடிக்கையாளர் ஒரு புதிய முத்திரை அட்டை பெறுகிறார், எந்த வழியில், நீங்கள் கடந்து external_id |
REWARD_EARNED | ஒரு ஸ்கேன் Award இலக்கை அடைகிறது |
VOUCHER_ISSUED | ஒரு ஸ்கேனிங் Voucher இலக்கை அடைகிறது |
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_WIN க்கான Lottery, ஒவ்வொன்றும் ஸ்கேன் நிகழ்வின் பின்னர் அனுப்பப்பட்டன.
முத்திரைகள் அகற்றப்படும்போது ஒரு வெப்ஹூக் அனுப்பப்படுகிறதா?
ஆம். 7Stamp Scanner இல் அகற்றப்பட்ட முத்திரைகள் எதிர்மறையான stamps_added உடன் SCAN ஆக வருகின்றன.
VOUCHER_ISSUED மற்றும் ADMIN_VOUCHER_ISSUE இடையே உள்ள வேறுபாடு என்ன?
VOUCHER_ISSUED என்பது ஒரு வவுச்சர் இலக்கை அடையும் போது நிகழ்கிறது. ADMIN_VOUCHER_ISSUE என்பது ஒரு வவுச்சர் நேரடியாக ஒரு அட்டையில், நிர்வாகியில் கைமுறையாக அல்லது API வழியாக வழங்கப்படும் போது நிகழ்கிறது.
ஒரு முத்திரை குறியீட்டைக் கொண்டு சேரும் வாடிக்கையாளர் ஒரு நிகழ்வு அல்லது பல நிகழ்வுகளை அனுப்புகிறாரா?
பல. CARD_JOINED முதலில் வருகிறது, பின்னர் VOUCHER_PACK ஸ்டாம்ப் கார்டில் Voucher பேக் இருந்தால், பின்னர் DELIVERY_INSERT முத்திரைகளுடன்.
ஒவ்வொரு பிரச்சார செய்திக்கும் எனக்கு ஒரு நிகழ்வு கிடைக்குமா?
CARD_CAMPAIGN ஒவ்வொரு அட்டையிலும் ஒரு முறை அனுப்பி வைக்கப்படுகிறது, அட்டை ஒன்றைக் கொண்டிருக்கும்போது அட்டவணையின் வவுச்சர் அனுப்பி வைக்கப்படுகிறது.
ஒரு Webhook பெறும்
ஒவ்வொரு நிகழ்வும் ஒரே JSON உடலைக் கொண்டுள்ளதுஃ நிகழ்வு ஐடி, வணிகம் மற்றும் அதன் வகை கொண்ட நிகழ்வு, முத்திரை அட்டை, முத்திரைகள் முன் மற்றும் பின், கொள்முதல் தொகை, ஆர்டர் ஐடி மற்றும் external_id ஒருங்கிணைப்பு அனுப்பப்பட்டது, அதை வழங்கிய பணியாளர் உள்நுழைவு, அது வழங்கிய கூப்பன்கள் மற்றும் வெகுமதிகள், மற்றும் வாடிக்கையாளரின் பெயர், email, Telegram, WhatsApp தொலைபேசி மற்றும் பிறந்த தேதி.
amount என்பது சிறிய அலகுகளில் (சென்ட்கள்) வாங்கும் தொகைஃ ஸ்கேன் மூலம் அனுப்பப்பட்ட 12.50 தொகை 1250. நிகழ்வில் தொகை இல்லாதபோது அது காலியாக உள்ளது.
நிகழ்வு ஐடி உடலில் மற்றும் X-Webhook-Event-Id தலைப்பில் உள்ளது. அதே நிகழ்வின் மறு முயற்சி அதன் ஐடியை வைத்திருக்கிறது, எனவே ஒரு பெறுநர் மீண்டும் மீண்டும் செய்யலாம். ஒரு Make அல்லது Zapier URL நிகழ்வு card_event விசையின் கீழ் data க்கு பதிலாக அமைந்துள்ளது.
ஒரு Webhook வாடிக்கையாளரைப் பற்றி என்ன தரவுகளைக் கொண்டுள்ளது?
பெயர், email, Telegram, WhatsApp தொலைபேசி மற்றும் பிறந்த தேதி, முத்திரை அட்டை, முத்திரைகளுக்கு முன்னும் பின்னும், கூப்பன்கள் மற்றும் பரிசுகள்.
எந்த யூனிட்டில் தொகை உள்ளது?
சிறிய அலகுகளில் (சென்ட்கள்). ஸ்கேனிங் மூலம் அனுப்பப்பட்ட 12.50 அளவு 1250 ஆக வருகிறது; நிகழ்வில் அளவு இல்லாதபோது அது காலியாக உள்ளது.
ஒரே நிகழ்வை இரண்டு முறை செயலாக்குவதை நான் எவ்வாறு தவிர்க்க முடியும்?
நிகழ்வு ஐடி, உடலில் மற்றும் X-Webhook-Event-Id தலைப்பில் பயன்படுத்தவும். ஒரு மறு முயற்சியில் அதே ஐடி வைத்திருக்கும்.
card_event இன் கீழ் உள்ள நிகழ்வு ஏன் Make இல் உள்ளது?
ஒரு Make அல்லது Zapier URL நிகழ்வு data க்கு பதிலாக card_event விசையின் கீழ் உள்ளது, எனவே அவர்களின் பயன்பாடுகள் அதை வேறுபடுத்த முடியும்.
கையொப்பம்
ஒவ்வொரு விநியோகமும் கையொப்பமிடப்பட்டுள்ளது. X-Webhook-Signature தலைப்பில் ஒரு நேர முத்திரை மற்றும் அந்த நேர முத்திரையின் HMAC-SHA256 மற்றும் மூல உடல் உள்ளது, இது வெப்ஹூக்கின் ரகசிய விசையுடன் கிளிக் செய்யப்படுகிறது. ரகசிய விசையை வெப்ஹூக்கின் பக்கத்தில் காண்பிக்கப்பட்டு மறுசீரமைக்கப்படுகிறது. ஒரு அடிப்படை ஆசிரியர் உள்நுழைவு மற்றும் கடவுச்சொல்லையும் சேர்க்கப்படலாம்.
Webhook உண்மையில் 7Stamp இருந்து வருகிறது என்பதை நான் எப்படி சரிபார்க்க முடியும்?
Webhook இன் ரகசிய விசையுடன் நேர முத்திரையின் HMAC-SHA256 மற்றும் மூல உடலைக் கணக்கிட்டு அதை X-Webhook-Signature தலைப்புடன் ஒப்பிடுக.
நான் எங்கே Webhook இரகசிய திறவுகோல் கண்டுபிடிக்க முடியும்?
வெப்ஹூக்கின் பக்கத்தில், அங்கு அது மறுசீரமைக்கப்படலாம்.
நான் ஒரு கடவுச்சொல் கொண்டு என் இறுதி புள்ளி பாதுகாக்க முடியுமா?
ஆம். ஒரு அடிப்படை எழுத்தாளர் உள்நுழைவு மற்றும் கடவுச்சொல்லை Webhook சேர்க்க முடியும், கையொப்பத்தின் மேல்.
தவறிய விநியோகங்கள்
முப்பது வினாடிகளுக்குள் 2xx பதிலைப் பெறாத ஒரு விநியோகம் பத்து முறை வரை மீண்டும் முயற்சி செய்யப்படுகிறது, ஒவ்வொன்றும் கடைசியை விட நான்கு வினாடிகள் நீண்ட நேரம் காத்திருக்கும், எனவே மறு முயற்சிகள் சுமார் நான்கு நிமிடங்களுக்குள் முடிவடைகின்றன. மறு முயற்சியுடன் 429 பதில் அந்த நேரத்திற்குப் பிறகு மீண்டும் முயற்சி செய்யப்படுகிறது. ஒரு நிகழ்வின் முதல் தோல்வி நிர்வாகிக்கு அறிவிப்பை வைக்கிறது.
நூறு தொடர்ச்சியான தோல்வியுற்ற டெலிவரிகளுக்குப் பிறகு, வெப்ஹூக் கணினியால் தடுக்கப்படுகிறது, மேலும் நிகழ்வுகள் கிடைக்காது. அதன் பக்கம் அதற்கு முன்னர் எச்சரிக்கிறது மற்றும் திறப்பு பொத்தானைக் கொண்டுள்ளது; ஒரு வெற்றிகரமான டெலிவரி எண்ணிக்கையை மீட்டமைக்கிறது.
ஒவ்வொரு வெப்ஹூக்கின் பக்கத்திலும் அதன் டெலிவரிகளின் நாட்காட்டி உள்ளது, அனுப்பப்பட்ட கோரிக்கை மற்றும் பெறப்பட்ட பதில். மறுபரிசீலனை அதே நிகழ்வை மீண்டும் அனுப்புகிறது, இந்த வெப்ஹூக்கிற்கு மட்டுமே.
என் சேவையகம் கீழே இருந்தது. நிகழ்வுகள் இழக்கப்பட்டுள்ளன?
ஒவ்வொரு விநியோகமும் சுமார் நான்கு நிமிடங்களுக்குள் பத்து முறை மீண்டும் முயற்சி செய்யப்படுகிறது. அதன் பிறகு, Webhook இன் நாட்காட்டியைத் திறந்து, உங்களுக்குத் தேவையான நிகழ்வுகளுக்கு Resend ஐப் பயன்படுத்தவும்.
ஏன் என் Webhook நிகழ்வுகள் பெறுவதை நிறுத்தியது?
நூறு தொடர்ச்சியான தோல்வியுற்ற டெலிவரிகளுக்குப் பிறகு அது கணினியால் தடுக்கப்படுகிறது. இறுதி புள்ளியை சரிசெய்து Webhook பக்கத்தில் Unblock என்பதை அழுத்தவும்.
நான் என் Webhook அனுப்பப்பட்டது என்ன பார்க்க முடியுமா?
ஆம். ஒவ்வொரு வெப்ஹூக்கின் பக்கத்திலும் அனுப்பப்பட்ட கோரிக்கை மற்றும் பெறப்பட்ட பதிலுடன் விநியோகங்களின் நாட்காட்டி உள்ளது.
ஒருங்கிணைப்புகள் tab

ஒருங்கிணைப்புகள் பக்கத்தில் குழுக்களின் படி தயாரான வழிகள் பட்டியலிடப்பட்டுள்ளனஃ
- கட்டண இடத்தில் ஸ்டாம்பிடுதல் — Poster, Toast, உங்கள் சொந்த POS அல்லது CRM, மேலும் உங்கள் POS தெரியவில்லையா?;
- தொழில் சான்றிதழ்கள் — SmartKasa;
- ஆட்டோமேஷன் — Make, Zapier மற்றும் பொது Swagger.
ஒவ்வொரு அட்டையும் API விசை தேவையா என்று கூறுகிறது. தாவலில் ஒவ்வொரு நாட்டிலும் ஒரே அட்டைகள் வழங்கப்படுகின்றன; வரி வருமானங்கள் மட்டுமே நாடு வாரியாக வரையறுக்கப்பட்டுள்ளன.

ஒரு White Label Business-க்கு Make, Zapier அல்லது Public Swagger அட்டை கிடையாது; Poster மற்றும் 7stamp.com-இல் உள்ள அமைப்பு வழிகாட்டிகளும் வழங்கப்படாது.
எந்த POS அமைப்புகள் இணைக்க தயாராக உள்ளன?
Poster, மற்றும் Toast அது மேடையில் — — அது வரை அது விரைவில் வரும் காட்டுகிறது. மற்ற அமைப்புகள் API வழியாக இணைக்க, உங்கள் சொந்த POS அல்லது CRM.
ஒருங்கிணைப்பு நாடுகளால் மட்டுப்படுத்தப்பட்டதா?
இல்லை. தாவல் ஒவ்வொரு நாட்டிலும் ஒரே மாதிரியான கார்டுகளை வழங்குகிறது. நிதி ரசீதுகள் மட்டுமே நாடு வாரியாக வரையறுக்கப்பட்டுள்ளன.
நான் ஏன் Make மற்றும் Zapier பார்க்க முடியாது?
White Label வணிகத்திற்கு அவை காண்பிக்கப்படுவதில்லை. API விசைகள் மற்றும் Webhooks அதே வேலையைச் செய்கின்றன.
Poster
Poster என்பது Poster சந்தையில் உள்ள எங்கள் பயன்பாடாகும். Poster இல் நிறுவுதல் அதன் பட்டியலைத் திறக்கிறது, மேலும் பயன்பாடு ஒரு பணியாளர் உள்நுழைவின் API விசைடன் அமைக்கப்படுகிறது. அதன் முத்திரைகள் அந்த பணியாளர் உள்நுழைவின் Card Operation களாக எண்ணப்படுகின்றன.
Poster ஐ எவ்வாறு இணைப்பது?
Integrations → Poster ஐத் திறந்து Poster இல் நிறுவவும் என்பதைத் தேர்ந்தெடுக்கவும். செயலி ஒரு பணியாளர் உள்நுழைவின் API விசையுடன் அமைக்கப்படுகிறது.
யாருடைய Card Operation Poster முத்திரைகளைப் பயன்படுத்துகிறது?
பயன்பாட்டில் பயன்படுத்தப்படும் API விசை கொண்ட பணியாளர் உள்நுழைவு.
எனக்கு API க்கான Poster விசை தேவையா?
ஆம், ஒரு பணியாளர் உள்நுழைவு API விசை.
Toast
Toast ஒவ்வொரு வணிகத்திற்கும் விரைவில் வரும் வரை மேடையில் Toast அணுகல் அமைக்கப்படும். இது முழு தளத்திற்கும் ஒரு சுவிட்ச் ஆகும், வணிகத்தின் அமைப்பல்ல; அது இயக்கப்பட்டவுடன், Toast அட்டை அமைப்பை வைத்திருக்கும்.
ஒவ்வொரு Toast இருப்பிடமும் அதன் GUID மூலம் ஒரு பணியாளர் உள்நுழைவுடன் இணைக்கப்பட்டுள்ளது, API விசை இல்லாமல்ஃ அந்த பணியாளர் உள்நுழைவு வணிகம், முத்திரை அட்டை மற்றும் திட்டம் இருப்பிடத்திலிருந்து ஒவ்வொரு Toast கோரிக்கையுக்கும் பொருந்தும். ஒரு இருப்பிடத்தை ஒரு பணியாளர் உள்நுழைவுடன் மட்டுமே இணைக்க முடியும், மற்றும் ஒரு பணியாளர் உள்நுழைவு ஒரு இருப்பிடத்தை வைத்திருக்கும். ஒரு இருப்பிடத்திலிருந்து கோரிக்கைகள் இணைக்கப்படாதவுடன் நிராகரிக்கப்படுகின்றன, அல்லது அதன் பணியாளர் உள்நுழைவு அணைக்கப்படும் அல்லது நீக்கப்படும் போது.
ஒவ்வொரு குவாச்சருக்கும் ஒரு Toast மெனு தயாரிப்பு வழங்கப்படலாம்ஃ Toast POS இல் அது பின்னர் அந்த தயாரிப்பில் தள்ளுபடியாக மாறும். ஒரு குவாச்சர் இல்லாமல் ஒரு குவாச்சர் காசோலையில் பூஜ்ஜிய தள்ளுபடியாக விண்ணப்பிக்கப்படுகிறது, மற்றும் பணக்காரர் பரிசை கைமுறையாக வழங்குகிறார். குவாச்சர்கள் Toast POS இல் மீட்டெடுக்கப்படுகின்றன, மற்றும் ஒரு கட்டப்பட்ட காசோலால் அடையப்பட்ட சக்கரம் உடனடியாக சுழற்றப்படுகிறது. Toast ஒரு பரிவர்த்தனையை ரத்து செய்தால், அதன் முத்திரைகள் திரும்பப் பெறப்படுகின்றன அல்லது மீட்டெடுக்கப்பட்ட குவாச்சர்கள் மீட்டெடுக்கப்படுகின்றன.
ஒரு விருந்தினர் ஒரு Toast கியோஸ்கில் அல்லது ஒரு தொலைபேசி எண் அல்லது email உடன் விருந்தினர்களை எதிர்கொள்ளும் திரையில் சேரலாம். முத்திரை அட்டை உடனடியாக வழங்கப்படுகிறது; விருந்தினர்கள் அதே தொலைபேசி அல்லது email உடன் அதைத் திறக்கும் வரை 7Stamp இலிருந்து எதையும் பெற மாட்டார்கள்.
Toast ஏன் விரைவில் வருகிறேன் என்கிறார்?
Toast அணுகல் முழு தளத்திற்கும் ஒரு சுவிட்ச் ஆகும், உங்கள் வணிகத்தின் அமைப்பல்ல. அது இயங்கும் வரை, இணைக்க எதுவும் இல்லை.
Toast இடம் எப்படி இணைக்கப்பட்டுள்ளது?
API விசை இல்லாத ஒரு பணியாளர் உள்நுழைவுக்கு அதன் GUID மூலம். அந்த பணியாளர் உள்நுழைவு முத்திரை அட்டை மற்றும் திட்டம் இருப்பிடத்திலிருந்து ஒவ்வொரு கோரிக்கையுக்கும் பொருந்தும்.
Toast ஒரு காசோலையை ரத்து செய்யும் போது முத்திரைகளுக்கு என்ன நடக்கும்?
Toast ஒரு பரிவர்த்தனையை ரத்து செய்தால், அதன் முத்திரைகள் மீட்டெடுக்கப்படும் அல்லது மீட்டெடுக்கப்பட்ட கூப்பன்கள் மீட்டெடுக்கப்படும்.
SmartKasa

SmartKasa-க்கு API key தேவையில்லை. இது ரசீது ஸ்கேன் பகுதியில், எல்லா கடைகளையும் உள்ளடக்க SmartKasa shop ID அல்லது நிறுவனக் குறியீட்டால் சேர்க்கப்படும் ஒரு ரசீது மூலமாகும். வாடிக்கையாளர்கள் வணிகத்தின் சாட்பாட்டில் SmartKasa ரசீதை ஸ்கேன் செய்கிறார்கள்; ஸ்டாம்புகள் அந்த ரசீது மூலத்தின் Staff Login-க்கு சேரும்.
SmartKasa உக்ரைனியன் மொழியாகும், மேலும் உக்ரைன், ஸ்லோவாகியா, கஜகஸ்தான் மற்றும் உஸ்பெகிஸ்தான் ஆகிய நாடுகளில் மட்டுமே நிதி வருமானங்கள் செயல்படுகின்றன.
எனக்கு API க்கான SmartKasa க்கான விசை தேவையா?
இல்லை. 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 கூடுதல் தேவையா?
7Stamp வலை ஹோக்குகளால் சூழ்நிலைகள் மற்றும் Zaps தொடங்கப்படுகின்றன என்பதால் தூண்டுதல்கள் செய்யப்படுகின்றன. முத்திரைகளைச் சேர்ப்பது அல்லது வவுச்சரை வழங்குவது போன்ற செயல்களுக்கு API விசை மட்டுமே தேவை.
எனக்கு Make அல்லது Zapier க்கு API விசை தேவையா?
ஆம். செயலிகள் ஒரு பணியாளர் உள்நுழைவு API விசை வேலை.