સંદર્ભ ઓપરેશન્સ

API, વેબહુક અને એકીકરણો

સ્ટાફ લૉગિન માટે API કી, API શું કરે છે, Webhooks અને ઇવેન્ટ્સ, payload, સિગ્નેચર, ફરી પ્રયાસો અને તૈયાર એકીકરણો: Poster, Toast, SmartKasa, Make અને Zapier.

ઝડપી વાંચન

અપડેટ કર્યું: 19 નવેમ્બર, 2026

API & integrations

API & integrations માં API કી

સેટિંગ્સ → API & integrations માં ત્રણ ટૅબ છે: API keys, Webhooks અને Integrations.

API અને API કી દરેક પ્લાન પર મફત છે, Free Forever સહિત; અલગ API એડ-ઓન નથી. API દ્વારા અપાયેલા સ્ટેમ્પ બીજા કોઈપણ સ્ટેમ્પની જેમ Card Operations છે, તેથી પ્લાનની Card Operations પૂરી થાય ત્યારે તે બંધ થઈ જાય છે. Webhooks ચૂકવણીવાળો ભાગ છે, નીચે જુઓ.

શું API માટે વધારાનો ખર્ચ થાય છે?

ના. API અને API કી દરેક પ્લાન પર મફત છે, Free Forever સહિત. તેના દ્વારા અપાયેલા સ્ટેમ્પ બીજા કોઈપણ સ્ટેમ્પની જેમ Card Operations છે.

શું હું Free Forever પર API વાપરી શકું?

હા. જ્યારે પ્લાનની Card Operations પૂરી થઈ જાય, ત્યારે API દ્વારા સ્ટેમ્પ પણ બીજા સ્ટેમ્પની જેમ જ બંધ થઈ જાય છે.

API સેટિંગ્સ ક્યાં છે?

સેટિંગ્સ → API & integrations માં, ત્રણ ટૅબ સાથે — API keys, Webhooks અને Integrations.

API કી

સ્ટાફ લૉગિન માટે API કી જનરેટ કરો

API કી API keys → API કી ઉમેરો હેઠળ એક સ્ટાફ લૉગિન માટે બનાવવામાં આવે છે. સ્ટાફ લૉગિન પાસે વધુમાં વધુ એક API કી હોય છે, અને બંધ કરેલો સ્ટાફ લૉગિન પસંદ કરી શકાતો નથી. પસંદ કરવા માટે કોઈ સ્ટાફ લૉગિન ન હોય, તો API કી જનરેટ કરો વિન્ડો ત્યાં જ નવો બનાવવાની ઑફર કરે છે; નવા સ્ટાફ લૉગિન માટે ખાલી Staff Seat જોઈએ, અને પ્લાન ભરાઈ ગયો હોય તો વિન્ડો તેના બદલે સીટ ઉમેરવાની અથવા પ્લાન અપગ્રેડ કરવાની ઑફર કરે છે.

API કી વડે કરાયેલો દરેક કૉલ તેના સ્ટાફ લૉગિન તરીકે કામ કરે છે: તે ફક્ત તે સ્ટાફ લૉગિનના વ્યવસાય સુધી પહોંચે છે, સ્વચાલિત સ્ટેમ્પિંગમાં તેના માટે પસંદ કરેલા સ્ટેમ્પ કાર્ડ પર સ્ટેમ્પ ઉમેરે છે, અને તેના સ્ટેમ્પ તે સ્ટાફ લૉગિનની Card Operations તરીકે ગણાય છે.

કી કોઈપણ સમયે API keys યાદીમાંથી ફરી જોઈ અને કૉપિ કરી શકાય છે. તેને ટર્મિનલમાં સ્કેન કરવા માટે QR કોડ તરીકે પણ બતાવી શકાય છે, અને સ્ટાફ લૉગિનના નામ સાથે પ્રિન્ટ કરી શકાય છે.

હું API કી કેવી રીતે બનાવું?

સેટિંગ્સ → API & integrations → API keys માં, API કી ઉમેરો પસંદ કરો અને એક સ્ટાફ લૉગિન પસંદ કરો. દરેક સ્ટાફ લૉગિન પાસે વધુમાં વધુ એક API કી હોય છે.

મારી API કી ખોવાઈ ગઈ. શું મારે નવી કી જોઈએ?

ના. કી કોઈપણ સમયે API keys યાદીમાંથી ફરી જોઈ અને કૉપિ કરી શકાય છે, અથવા QR કોડ તરીકે બતાવી શકાય છે.

API કૉલ્સ કયા સ્ટેમ્પ કાર્ડ પર સ્ટેમ્પ ઉમેરે છે?

કીના સ્ટાફ લૉગિન માટે સ્વચાલિત સ્ટેમ્પિંગમાં પસંદ કરેલા કાર્ડ પર. તેના સ્ટેમ્પ તે સ્ટાફ લૉગિનની Card Operations તરીકે ગણાય છે.

નવી કી માટે હું સ્ટાફ લૉગિન કેમ પસંદ કરી શકતો નથી?

બંધ કરેલો સ્ટાફ લૉગિન પસંદ કરી શકાતો નથી, અને જે સ્ટાફ લૉગિન પાસે પહેલેથી કી છે તેને બીજી કી મળી શકતી નથી. પસંદ કરવા માટે કોઈ ન હોય, તો વિન્ડો સ્ટાફ લૉગિન બનાવવાની ઑફર કરે છે.

API કી ક્યારે કામ કરવાનું બંધ કરે છે

API કીની મુદત પૂરી થતી નથી. તે ફક્ત ત્યારે જ કામ કરવાનું બંધ કરે છે જ્યારે તેને ફરીથી જનરેટ કરવામાં આવે અથવા કાઢી નાખવામાં આવે, અથવા જ્યારે તેનો સ્ટાફ લૉગિન બંધ કરવામાં આવે અથવા કાઢી નાખવામાં આવે. સ્ટાફ લૉગિન માટે નવો પાસવર્ડ અથવા લૉગિન તેને અસર કરતા નથી.

  • ફરીથી જનરેટ કરો સ્ટાફ લૉગિનને નવી API કી આપે છે; જૂની કી તરત જ કામ કરવાનું બંધ કરે છે.
  • કાઢી નાખો કીને તરત જ બંધ કરે છે. સ્ટાફ લૉગિન પોતે 7Stamp Scanner માં કામ કરતો રહે છે અને પછીથી નવી કી મેળવી શકે છે.
  • સ્ટાફ લૉગિન બંધ કરવાથી તેની કી રહે છે: સ્ટાફ લૉગિન ફરી ચાલુ થાય ત્યારે એ જ કી ફરીથી કામ કરે છે.

શું API કીની મુદત પૂરી થાય છે?

ના. તે ફક્ત ત્યારે જ કામ કરવાનું બંધ કરે છે જ્યારે તેને ફરીથી જનરેટ કરવામાં આવે અથવા કાઢી નાખવામાં આવે, અથવા જ્યારે તેનો સ્ટાફ લૉગિન બંધ કરવામાં આવે અથવા કાઢી નાખવામાં આવે.

મેં સ્ટાફ લૉગિનનો પાસવર્ડ બદલ્યો. શું મારે નવી API કી જોઈએ?

ના. નવો પાસવર્ડ અથવા લૉગિન API કીને અસર કરતા નથી.

મેં સ્ટાફ લૉગિન ફરી ચાલુ કર્યો. શું તેની જૂની API કી કામ કરે છે?

હા. સ્ટાફ લૉગિન બંધ કરવાથી તેની કી રહે છે, અને તે ફરી ચાલુ થતાં જ એ જ કી ફરીથી કામ કરે છે.

API શું કરે છે

API દ્વારા સિસ્ટમ આ કરી શકે છે:

  • સ્ટેમ્પ કાર્ડ લિંક અથવા QR તરીકે આપવું;
  • સ્ટેમ્પ ઉમેરવા;
  • કાર્ડને તેના સ્ટેમ્પ, લક્ષ્યો અને વાઉચર સાથે વાંચવું;
  • વાઉચર સીધું કાર્ડ પર જારી કરવું;
  • વાઉચરને તેના વાઉચર કોડ વડે રિડીમ કરવું;
  • ગ્રાહકને સંદેશ મોકલવો.

API ગ્રાહકનું કાર્ડ વ્યવસાયના પોતાના ઓળખકર્તા વડે શોધે છે, જેમ કે CRM ID, ફોન અથવા ઇમેઇલ, જે external_id તરીકે મોકલાય છે. ઓળખકર્તા કાર્ડ પર સંગ્રહિત થાય છે અને તેના વિશેના દરેક Webhook માં પાછો આવે છે. API માં વ્યવસાયના ગ્રાહકોની યાદી આપતો કોઈ કૉલ નથી: આખો ગ્રાહક આધાર ફક્ત એડમિનના એક્સપોર્ટ દ્વારા જ કાઢવામાં આવે છે.

API કીને બદલે, એપ સ્ટાફ લૉગિનના લૉગિન અને પાસવર્ડ વડે સાઇન ઇન કરી શકે છે — એવા ઉપકરણ માટે જેમાં કૅશિયર સાઇન ઇન કરે છે. API કી એવા ઉપકરણ માટે યોગ્ય છે જે કોઈની દેખરેખ વગર ચાલે છે. Webhooks ફક્ત એડમિનમાં જ ઉમેરવામાં આવે છે; API માં ઇવેન્ટ્સ માટે સબ્સ્ક્રાઇબ કરવાનો કે તેમની યાદી મેળવવાનો કોઈ કૉલ નથી.

API વિનંતીઓ પર કોઈ રેટ લિમિટ રાખતું નથી: કૉલ્સને સંખ્યા કે આવર્તન પ્રમાણે ધીમા કરવામાં આવતા નથી, અને એ જ કાર્ડ તરત જ ફરીથી સ્કેન કરી શકાય છે. તેના દ્વારા સ્ટેમ્પિંગને મર્યાદિત કરે છે તે ફક્ત પ્લાનની Card Operations છે.

શું અમે અમારા પોતાના CRM અથવા POS માંથી સ્ટેમ્પ ઉમેરી શકીએ?

હા, API દ્વારા. તે સ્ટેમ્પ કાર્ડ આપે છે, સ્ટેમ્પ ઉમેરે છે, કાર્ડ વાંચે છે અને વાઉચર રિડીમ કરે છે. તમારી સિસ્ટમને ઇવેન્ટ્સની જાણ થાય તે માટે Webhook ઉમેરો — તેના માટે Webhooks & Events એડ-ઓન જરૂરી છે.

શું અમે ડેટા એક્સપોર્ટ કરી શકીએ?

API દ્વારા તમે તમારા પોતાના ઓળખકર્તા વડે કાર્ડ વાંચો છો, અને Webhooks ઇવેન્ટ્સ બને તેમ મોકલે છે. API માં બધા ગ્રાહકોની યાદી નથી — આખો ગ્રાહક આધાર એડમિનના એક્સપોર્ટ દ્વારા કાઢવામાં આવે છે.

API ગ્રાહકનું કાર્ડ કેવી રીતે શોધે છે?

તમારા પોતાના ઓળખકર્તા વડે — CRM ID, ફોન અથવા ઇમેઇલ — જે 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 કી અથવા સ્ટાફ લૉગિન જરૂરી છે.

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 એ જ રીતે કામ કરે છે.

Webhooks

API & integrations માં Webhooks

Webhook API & integrations → Webhooks → Webhook ઉમેરો હેઠળ ઉમેરવામાં આવે છે, ઇવેન્ટ્સ મેળવનાર URL સાથે. 7Stamp માં Webhook સ્ટેમ્પ કાર્ડ ઇવેન્ટ્સ માટે બનાવવામાં આવે છે. વ્યવસાય અનેક Webhooks ઉમેરી શકે છે, દરેક પોતાના URL સાથે.

Webhooks માટે Webhooks & Events એડ-ઓન જરૂરી છે, મહિને $19, જે ફક્ત પેઇડ પ્લાન પર ઉપલબ્ધ છે. પહેલો Webhook ઉમેરતી વખતે તેને ખરીદવાની ઑફર આવે છે; તેના વગર Webhook બનાવી શકાતો નથી કે ફરી ચાલુ કરી શકાતો નથી. એક એડ-ઓન એક Webhook ને ચાલુ રાખે છે: વધુ ઉમેરી શકાય છે, પરંતુ સબ્સ્ક્રિપ્શનનું દરેક બિલિંગ અપડેટ સૌથી જૂના સિવાયના બધા Webhooks બંધ કરી દે છે.

Webhook ઉમેરવામાં આવે તે ક્ષણથી Webhooks ઇવેન્ટ્સ બને તેમ મોકલે છે. અગાઉની ઇવેન્ટ્સ મોકલાતી નથી.

શું Webhooks મફત છે?

ના. તેમના માટે Webhooks & Events એડ-ઓન જરૂરી છે, મહિને $19, જે ફક્ત પેઇડ પ્લાન પર ઉપલબ્ધ છે. API પોતે મફત છે.

મેં બીજો Webhook ઉમેર્યો અને તે બંધ થઈ ગયો. કેમ?

એક Webhooks & Events એડ-ઓન એક Webhook ને ચાલુ રાખે છે. સબ્સ્ક્રિપ્શનનું દરેક બિલિંગ અપડેટ સૌથી જૂના સિવાયના બધા Webhooks બંધ કરી દે છે.

શું નવો Webhook ભૂતકાળની ઇવેન્ટ્સ મોકલશે?

ના. ઇવેન્ટ્સ Webhook ઉમેરવામાં આવે તે ક્ષણથી મોકલાય છે.

Webhook ઇવેન્ટ્સ

Webhook ને પંદર સ્ટેમ્પ કાર્ડ ઇવેન્ટ્સ મળે છે, જેનું નામ 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. છેલ્લી બે ત્યારે આવે છે જ્યારે પાસ વૉલેટમાં ઉમેરાય અથવા તેમાંથી દૂર થાય, વૉલેટ — Apple અથવા Google — સાથે.

જે સ્કેન કોઈ સ્ટેમ્પ ઉમેરતું નથી, જેમ કે સ્ટેમ્પની કિંમતથી ઓછી ખરીદી, તે પણ શૂન્ય ઉમેરાયેલા સ્ટેમ્પ સાથે SCAN મોકલે છે. વ્હીલ પર જીતેલું ઇનામ વ્હીલ ફેરવાય ત્યારે એક LOTTERY_WIN દ્વારા જાહેર થાય છે, REWARD_EARNED કે VOUCHER_ISSUED દ્વારા નહીં; ફેરવવાની રાહ જોતું વ્હીલ હજી કંઈ મોકલતું નથી.

ગ્રાહક સમીક્ષાઓ સ્ટેમ્પ કાર્ડ ઇવેન્ટ્સ નથી. દરેક નવી સમીક્ષા entity review અને action created સાથે ઇવેન્ટ મોકલે છે, એવા Webhooks ને જેમના પેજ પર ઑબ્જેક્ટ્સમાં સમીક્ષાઓ ટિક કરેલું હોય. અહીં ઉમેરાયેલો Webhook ફક્ત સ્ટેમ્પ કાર્ડ ઇવેન્ટ્સ માટે સેટ થાય છે, તેથી સમીક્ષાઓ ટિક થયા પછી જ તેને સમીક્ષાઓ મળે છે.

સ્કેન કોઈ સ્ટેમ્પ ન ઉમેરે ત્યારે પણ શું Webhook મોકલાય છે?

હા. જે સ્કેન કોઈ સ્ટેમ્પ ઉમેરતું નથી, જેમ કે સ્ટેમ્પની કિંમતથી ઓછી ખરીદી, તે પણ શૂન્ય ઉમેરાયેલા સ્ટેમ્પ સાથે SCAN મોકલે છે.

ગ્રાહક વ્હીલ પર જીત્યો તે કઈ ઇવેન્ટ જણાવે છે?

LOTTERY_WIN, જે વ્હીલ ફેરવાય ત્યારે એક વાર મોકલાય છે. ફેરવવાની રાહ જોતું વ્હીલ હજી કંઈ મોકલતું નથી.

ગ્રાહક પોતાના વૉલેટમાંથી કાર્ડ દૂર કરે ત્યારે શું મને ખબર પડી શકે?

હા. પાસ વૉલેટમાં ઉમેરવાથી અને દૂર કરવાથી CARD_ADDED_TO_WALLET અને CARD_REMOVED_FROM_WALLET મોકલાય છે, વૉલેટ — Apple અથવા Google — સાથે.

Webhook દ્વારા હું નવી ગ્રાહક સમીક્ષાઓ કેવી રીતે મેળવું?

Webhook નું પેજ ખોલો અને તેના ઑબ્જેક્ટ્સમાં સમીક્ષાઓ પર ટિક કરો. પછી દરેક નવી સમીક્ષા entity review અને action created સાથે આવે છે; ત્યાં સુધી API & integrations હેઠળ ઉમેરાયેલા Webhook ને ફક્ત સ્ટેમ્પ કાર્ડ ઇવેન્ટ્સ મળે છે.

દરેક ઇવેન્ટ ક્યારે મોકલાય છે

ઇવેન્ટક્યારે મોકલાય છે
SCANસ્ટાફ લૉગિન કાર્ડ સ્કેન કરે છે: 7Stamp Scanner માં, API દ્વારા અથવા Toast જેવા POS માંથી. 7Stamp Scanner માં દૂર કરાયેલા સ્ટેમ્પ નકારાત્મક stamps_added સાથેનું SCAN છે
DELIVERY_INSERTગ્રાહક સ્ટેમ્પ આપતો સ્ટેમ્પ કોડ ખોલે છે — QR, લિંક, કોડ પોતે અથવા API દ્વારા બનાવેલું આમંત્રણ
RECEIPT_SCANગ્રાહક વ્યવસાયના ચેટબોટમાં ફિસ્કલ રસીદ સ્કેન કરે છે અને તેના પર સ્ટેમ્પ મળે છે; amount રસીદની કુલ રકમ છે
CARD_JOINEDગ્રાહકને કોઈપણ રીતે નવું સ્ટેમ્પ કાર્ડ મળે છે, તમે મોકલેલા external_id સાથે
REWARD_EARNEDસ્કેન Award લક્ષ્ય સુધી પહોંચે છે
VOUCHER_ISSUEDસ્કેન વાઉચર લક્ષ્ય સુધી પહોંચે છે
LOTTERY_WINLottery વ્હીલ ફેરવાય છે અને ઇનામ આપે છે
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; દરેક સ્કેનની પોતાની ઇવેન્ટ પછી મોકલાય છે.

સ્ટેમ્પ દૂર કરવામાં આવે ત્યારે શું Webhook મોકલાય છે?

હા. 7Stamp Scanner માં દૂર કરાયેલા સ્ટેમ્પ નકારાત્મક stamps_added સાથે SCAN તરીકે આવે છે.

VOUCHER_ISSUED અને ADMIN_VOUCHER_ISSUE વચ્ચે શું તફાવત છે?

VOUCHER_ISSUED ત્યારે આવે છે જ્યારે સ્કેન વાઉચર લક્ષ્ય સુધી પહોંચે છે. ADMIN_VOUCHER_ISSUE ત્યારે આવે છે જ્યારે વાઉચર સીધું કાર્ડ પર જારી કરવામાં આવે છે — એડમિનમાં હાથથી અથવા API દ્વારા.

સ્ટેમ્પ કોડ વડે જોડાનાર ગ્રાહક એક ઇવેન્ટ મોકલે છે કે અનેક?

અનેક. પહેલા CARD_JOINED આવે છે, પછી જો સ્ટેમ્પ કાર્ડમાં વાઉચર પેક હોય તો VOUCHER_PACK, પછી સ્ટેમ્પ સાથે DELIVERY_INSERT.

શું મને દરેક ઝુંબેશ સંદેશ માટે ઇવેન્ટ મળે છે?

ઝુંબેશ જે કાર્ડ સુધી પહોંચે છે તે દરેક કાર્ડ માટે CARD_CAMPAIGN એક વાર મોકલાય છે, અને જો ઝુંબેશમાં વાઉચર હોય તો તે વાઉચર સાથે.

Webhook ને શું મળે છે

દરેક ઇવેન્ટનું JSON body એકસરખું હોય છે: ઇવેન્ટ ID, વ્યવસાય, અને ઇવેન્ટ — તેના પ્રકાર, સ્ટેમ્પ કાર્ડ, પહેલાં અને પછીના સ્ટેમ્પ, ખરીદીની રકમ, એકીકરણે મોકલેલા ઓર્ડર ID અને external_id, તેને સેવા આપનાર સ્ટાફ લૉગિન, તેણે આપેલા વાઉચર અને ઇનામો, તથા ગ્રાહકના નામ, ઇમેઇલ, Telegram, WhatsApp ફોન અને જન્મ તારીખ સાથે.

amount ખરીદીની રકમ નાના એકમોમાં (સેન્ટ) છે: સ્કેન સાથે મોકલેલી 12.50 ની રકમ 1250 તરીકે આવે છે. ઇવેન્ટમાં રકમ ન હોય ત્યારે તે ખાલી હોય છે.

ઇવેન્ટ ID body માં અને X-Webhook-Event-Id હેડરમાં હોય છે. એ જ ઇવેન્ટના ફરી પ્રયાસમાં તેનું ID રહે છે, તેથી મેળવનાર પુનરાવર્તનો છોડી શકે છે. Make અથવા Zapier URL માટે ઇવેન્ટ data ને બદલે card_event કી હેઠળ હોય છે.

Webhook ગ્રાહક વિશે કયો ડેટા લાવે છે?

નામ, ઇમેઇલ, Telegram, WhatsApp ફોન અને જન્મ તારીખ, સાથે સ્ટેમ્પ કાર્ડ, પહેલાં અને પછીના સ્ટેમ્પ, અને આપેલા વાઉચર અને ઇનામો.

amount કયા એકમમાં હોય છે?

નાના એકમોમાં (સેન્ટ). સ્કેન સાથે મોકલેલી 12.50 ની રકમ 1250 તરીકે આવે છે; ઇવેન્ટમાં રકમ ન હોય ત્યારે તે ખાલી હોય છે.

એક જ ઇવેન્ટને બે વાર પ્રોસેસ કરવાનું હું કેવી રીતે ટાળું?

ઇવેન્ટ ID નો ઉપયોગ કરો, જે body માં અને X-Webhook-Event-Id હેડરમાં હોય છે. ફરી પ્રયાસમાં એ જ ID રહે છે.

Make માં ઇવેન્ટ card_event હેઠળ કેમ હોય છે?

Make અથવા Zapier URL માટે ઇવેન્ટ data ને બદલે card_event કી હેઠળ હોય છે, જેથી તેમની એપ્સ તેને અલગ ઓળખી શકે.

સિગ્નેચર

દરેક ડિલિવરી સાઇન કરેલી હોય છે. X-Webhook-Signature હેડરમાં timestamp અને તે timestamp તથા raw body નો HMAC-SHA256 હોય છે, જે Webhook ની સિક્રેટ કી વડે ગણાય છે. સિક્રેટ કી Webhook ના પેજ પર બતાવવામાં આવે છે અને ત્યાં જ ફરીથી જનરેટ થાય છે. Basic auth લૉગિન અને પાસવર્ડ પણ ઉમેરી શકાય છે.

Webhook ખરેખર 7Stamp તરફથી આવે છે તે હું કેવી રીતે ચકાસું?

Webhook ની સિક્રેટ કી વડે timestamp અને raw body નો HMAC-SHA256 ગણો અને તેને X-Webhook-Signature હેડર સાથે સરખાવો.

Webhook ની સિક્રેટ કી ક્યાં મળે?

Webhook ના પેજ પર, જ્યાં તેને ફરીથી જનરેટ પણ કરી શકાય છે.

શું હું મારા endpoint ને પાસવર્ડથી સુરક્ષિત કરી શકું?

હા. સિગ્નેચર ઉપરાંત Webhook માં Basic auth લૉગિન અને પાસવર્ડ ઉમેરી શકાય છે.

નિષ્ફળ ડિલિવરી

જે ડિલિવરીને ત્રીસ સેકન્ડમાં 2xx જવાબ મળતો નથી તેનો દસ વખત સુધી ફરી પ્રયાસ થાય છે, અને દરેક રાહ પાછલી કરતાં ચાર સેકન્ડ લાંબી હોય છે, તેથી ફરી પ્રયાસો લગભગ ચાર મિનિટમાં પૂરા થાય છે. Retry-After સાથેના 429 જવાબનો તે સમય પછી ફરી પ્રયાસ થાય છે. ઇવેન્ટની પહેલી નિષ્ફળતા એડમિનમાં સૂચના મૂકે છે.

સળંગ સો નિષ્ફળ ડિલિવરી પછી સિસ્ટમ Webhook ને બ્લૉક કરે છે અને તેને વધુ ઇવેન્ટ્સ મળતી નથી. તેનું પેજ તે પહેલાં ચેતવણી આપે છે અને તેમાં અનબ્લૉક કરો બટન છે; એક સફળ ડિલિવરી ગણતરી શૂન્ય કરી દે છે.

દરેક Webhook ના પેજ પર તેની ડિલિવરીનું જર્નલ છે, જેમાં મોકલેલી વિનંતી અને મળેલો જવાબ હોય છે. ફરીથી મોકલો એ જ ઇવેન્ટ ફરી મોકલે છે, ફક્ત આ Webhook ને.

મારું સર્વર બંધ હતું. શું ઇવેન્ટ્સ ખોવાઈ ગઈ?

દરેક ડિલિવરીનો લગભગ ચાર મિનિટમાં દસ વખત સુધી ફરી પ્રયાસ થાય છે. તે પછી, Webhook નું જર્નલ ખોલો અને જરૂરી ઇવેન્ટ્સ માટે ફરીથી મોકલો નો ઉપયોગ કરો.

મારા Webhook ને ઇવેન્ટ્સ મળવાનું કેમ બંધ થયું?

સળંગ સો નિષ્ફળ ડિલિવરી પછી સિસ્ટમ તેને બ્લૉક કરે છે. endpoint ઠીક કરો અને Webhook ના પેજ પર અનબ્લૉક કરો દબાવો.

શું હું જોઈ શકું કે મારા Webhook ને શું મોકલવામાં આવ્યું હતું?

હા. દરેક Webhook ના પેજ પર ડિલિવરીનું જર્નલ છે, જેમાં મોકલેલી વિનંતી અને મળેલો જવાબ હોય છે.

Integrations ટૅબ

Integrations ટૅબ

Integrations ટૅબ તૈયાર રીતોને જૂથ પ્રમાણે બતાવે છે:

  • તમારા ચેકઆઉટ પર સ્ટેમ્પ — Poster, Toast, તમારું પોતાનું POS અથવા CRM અને તમારું POS દેખાતું નથી?;
  • ફિસ્કલ રસીદો — SmartKasa;
  • ઓટોમેશન — Make, Zapier અને Public Swagger.

દરેક કાર્ડ જણાવે છે કે તેને API કી જોઈએ કે નહીં. ટૅબ દરેક દેશમાં એ જ કાર્ડ આપે છે; ફક્ત ફિસ્કલ રસીદો દેશ પ્રમાણે મર્યાદિત છે.

તમારું પોતાનું POS અથવા CRM

White Label વ્યવસાયને Make, Zapier કે Public Swagger કાર્ડ દેખાતું નથી, અને તેને Poster કે 7stamp.com પરની સેટઅપ માર્ગદર્શિકાઓ ઑફર કરવામાં આવતી નથી.

કઈ POS સિસ્ટમ્સ કનેક્ટ કરવા માટે તૈયાર છે?

Poster, અને Toast જ્યારે પ્લેટફોર્મ માટે ચાલુ થાય ત્યારે — ત્યાં સુધી તે Coming soon બતાવે છે. અન્ય સિસ્ટમ્સ API દ્વારા, તમારું પોતાનું POS અથવા CRM કાર્ડ વડે કનેક્ટ થાય છે.

શું એકીકરણો દેશ પ્રમાણે મર્યાદિત છે?

ના. ટૅબ દરેક દેશમાં એ જ કાર્ડ આપે છે. ફક્ત ફિસ્કલ રસીદો દેશ પ્રમાણે મર્યાદિત છે.

મને Make અને Zapier કેમ દેખાતા નથી?

તે White Label વ્યવસાયને બતાવવામાં આવતા નથી. તેની API કી અને Webhooks એ જ રીતે કામ કરે છે.

Poster

Poster એ Poster માર્કેટપ્લેસમાં અમારી એપ છે. Poster માં ઇન્સ્ટોલ કરો તેનું લિસ્ટિંગ ખોલે છે, અને એપ સ્ટાફ લૉગિનની API કી વડે સેટ થાય છે. તેના સ્ટેમ્પ તે સ્ટાફ લૉગિનની Card Operations તરીકે ગણાય છે.

હું Poster કેવી રીતે કનેક્ટ કરું?

Integrations → Poster ખોલો અને Poster માં ઇન્સ્ટોલ કરો પસંદ કરો. એપ સ્ટાફ લૉગિનની API કી વડે સેટ થાય છે.

Poster ના સ્ટેમ્પ કોની Card Operations વાપરે છે?

એ સ્ટાફ લૉગિનની, જેની API કી એપ વાપરે છે.

શું Poster માટે મને API કી જોઈએ?

હા, સ્ટાફ લૉગિનની API કી.

Toast

પ્લેટફોર્મ પર Toast ઍક્સેસ સેટ ન થાય ત્યાં સુધી Toast દરેક વ્યવસાય માટે Coming soon બતાવે છે. તે આખા પ્લેટફોર્મ માટે એક સ્વિચ છે, વ્યવસાયનું સેટિંગ નથી; તે ચાલુ થયા પછી, સેટઅપ પોતે Toast કાર્ડમાં જ હોય છે.

દરેક Toast લોકેશન તેના GUID વડે એક સ્ટાફ લૉગિન સાથે કનેક્ટ થાય છે, API કી વગર: તે સ્ટાફ લૉગિનનો વ્યવસાય, સ્ટેમ્પ કાર્ડ અને પ્લાન લોકેશનની દરેક Toast વિનંતી પર લાગુ થાય છે. લોકેશન ફક્ત એક સ્ટાફ લૉગિન સાથે કનેક્ટ થઈ શકે છે, અને સ્ટાફ લૉગિન એક જ લોકેશન ધરાવે છે. લોકેશન ડિસ્કનેક્ટ થયા પછી, અથવા તેનો સ્ટાફ લૉગિન બંધ હોય કે કાઢી નાખેલો હોય ત્યારે, તેની વિનંતીઓ નકારવામાં આવે છે.

દરેક વાઉચરને Toast મેનૂનું પ્રોડક્ટ આપી શકાય છે: પછી Toast POS પર તે વાઉચર તે પ્રોડક્ટ પર ડિસ્કાઉન્ટ બને છે. પ્રોડક્ટ વગરનું વાઉચર બિલ પર શૂન્ય ડિસ્કાઉન્ટ તરીકે લાગુ થાય છે, અને કૅશિયર ભેટ હાથોહાથ આપે છે. વાઉચર Toast POS પર રિડીમ થાય છે, અને ચૂકવેલા બિલથી પહોંચેલું વ્હીલ તરત જ ફેરવાય છે. જ્યારે Toast વ્યવહાર રદ કરે છે, ત્યારે તેના સ્ટેમ્પ પાછા લેવાય છે અથવા તેમાં રિડીમ થયેલા વાઉચર પુનઃસ્થાપિત થાય છે.

મહેમાન Toast કિઓસ્ક અથવા મહેમાન તરફની સ્ક્રીન પર ફોન નંબર અથવા ઇમેઇલ વડે જોડાઈ શકે છે. સ્ટેમ્પ કાર્ડ તરત જ જારી થાય છે; મહેમાન એ જ ફોન અથવા ઇમેઇલ વડે તેને ખોલે નહીં ત્યાં સુધી તેને 7Stamp તરફથી કંઈ મળતું નથી.

Toast માં Coming soon કેમ લખેલું છે?

Toast ઍક્સેસ આખા પ્લેટફોર્મ માટે એક સ્વિચ છે, તમારા વ્યવસાયનું સેટિંગ નથી. તે ચાલુ ન થાય ત્યાં સુધી કનેક્ટ કરવા માટે કંઈ નથી.

Toast લોકેશન કેવી રીતે કનેક્ટ થાય છે?

તેના GUID વડે એક સ્ટાફ લૉગિન સાથે, API કી વગર. તે સ્ટાફ લૉગિનનું સ્ટેમ્પ કાર્ડ અને પ્લાન લોકેશનની દરેક વિનંતી પર લાગુ થાય છે.

Toast બિલ રદ કરે ત્યારે સ્ટેમ્પનું શું થાય છે?

જ્યારે Toast વ્યવહાર રદ કરે છે, ત્યારે તેના સ્ટેમ્પ પાછા લેવાય છે અથવા તેમાં રિડીમ થયેલા વાઉચર પુનઃસ્થાપિત થાય છે.

SmartKasa

Integrations ટૅબ પર SmartKasa

SmartKasa ને API કીની જરૂર નથી. તે રસીદ સ્કેનિંગમાં એક રસીદ સ્રોત છે, જે SmartKasa આઉટલેટ ID વડે અથવા બધા આઉટલેટ આવરી લેવા કંપની કોડ વડે ઉમેરાય છે. ગ્રાહકો વ્યવસાયના ચેટબોટમાં SmartKasa રસીદ સ્કેન કરે છે, અને સ્ટેમ્પ તે રસીદ સ્રોતના સ્ટાફ લૉગિનને જાય છે.

SmartKasa યુક્રેનિયન છે, અને ફિસ્કલ રસીદો ફક્ત યુક્રેન, સ્લોવાકિયા, કઝાકિસ્તાન અને ઉઝબેકિસ્તાનમાં જ કામ કરે છે.

શું SmartKasa માટે મને API કી જોઈએ?

ના. SmartKasa રસીદ સ્કેનિંગમાં એક રસીદ સ્રોત છે, જે SmartKasa આઉટલેટ ID અથવા કંપની કોડ વડે ઉમેરાય છે.

ગ્રાહકો SmartKasa રસીદ ક્યાં સ્કેન કરે છે?

તમારા વ્યવસાયના ચેટબોટમાં. સ્ટેમ્પ તે રસીદ સ્રોતના સ્ટાફ લૉગિનને જાય છે.

ફિસ્કલ રસીદો કયા દેશોમાં કામ કરે છે?

યુક્રેન, સ્લોવાકિયા, કઝાકિસ્તાન અને ઉઝબેકિસ્તાનમાં.

Make અને Zapier

Integrations ટૅબ પર Make

Make માટેની 7Stamp એપ Make ની સાર્વજનિક એપ લાઇબ્રેરીમાં છે: કોઈપણ Make સિનારિયોમાં 7Stamp શોધો, અથવા Integrations ટૅબ પર Make માં ખોલો નો ઉપયોગ કરો. અમારી Zapier એપ Zapier ની સાર્વજનિક ડિરેક્ટરીમાં નથી: Zapier માં ખોલો એક આમંત્રણ છે જે એપને વ્યવસાયના પોતાના Zapier એકાઉન્ટમાં ઉમેરે છે. બંને એપ સ્ટાફ લૉગિનની API કી સાથે કામ કરે છે.

Make સિનારિયો અને Zaps 7Stamp Webhooks દ્વારા શરૂ થાય છે, તેથી ટ્રિગર્સ માટે Webhooks & Events એડ-ઓન જરૂરી છે. સ્ટેમ્પ ઉમેરવા અથવા વાઉચર જારી કરવા જેવી ક્રિયાઓને ફક્ત API કી જોઈએ. Make અને Zapier White Label વ્યવસાયને ઑફર કરવામાં આવતા નથી.

Make અને Zapier માં 7Stamp એપ ક્યાં મળશે?

Make માં કોઈપણ સિનારિયોમાં 7Stamp શોધો — એપ Make ની સાર્વજનિક એપ લાઇબ્રેરીમાં છે. Zapier માં તે હજી સાર્વજનિક નથી, તેથી Integrations ટૅબ પર Zapier માં ખોલો નો ઉપયોગ કરો — આમંત્રણ એપને તમારા પોતાના એકાઉન્ટમાં ઉમેરે છે.

શું Make અને Zapier ને Webhooks & Events એડ-ઓન જોઈએ?

ટ્રિગર્સને જોઈએ, કારણ કે સિનારિયો અને Zaps 7Stamp Webhooks દ્વારા શરૂ થાય છે. સ્ટેમ્પ ઉમેરવા અથવા વાઉચર જારી કરવા જેવી ક્રિયાઓને ફક્ત API કી જોઈએ.

શું Make અથવા Zapier માટે મને API કી જોઈએ?

હા. એપ્સ સ્ટાફ લૉગિનની API કી સાથે કામ કરે છે.

સંદર્ભ
ઓપરેશન્સ 28 ઑક્ટોબર, 2026

પ્લાન અને બિલિંગ

તે ત્રણ યોજનાઓ, શું Card Operation છે, શું ગણવામાં આવે છે અને શું મફત છે, એડ-ઓન્સ, એક Access Code માંથી Packages અને જ્યારે ચુકવણી નિષ્ફળ થાય છે ત્યારે શું થાય છે.

અપડેટ કર્યું: 28 ઑક્ટોબર, 2026

લેખ ખોલો
સંદર્ભ
ઓપરેશન્સ 28 ઑક્ટોબર, 2026

સ્ટાફ ઍક્સેસ

એક સ્ટાફ લૉગિન શું છે, તેને કેવી રીતે બનાવવું, બદલવું, બંધ કરવું અને કાઢી નાખવું, સ્ટાફ કેવી રીતે 7Stamp Scanner માં સાઇન ઇન કરે છે, ત્યાં તેઓ શું કરી શકે છે, અને એડમિન પેનલ કોણ વાપરે છે.

અપડેટ કર્યું: 28 ઑક્ટોબર, 2026

લેખ ખોલો
સંદર્ભ
ઓપરેશન્સ 28 ઑક્ટોબર, 2026

ગ્રાહકો અને ઇતિહાસ

ગ્રાહકોના સ્ટેમ્પ કાર્ડ યાદી, એક ગ્રાહકનું કાર્ડ પેજ, કાઢી નાખવું એક કાર્ડ, ઇવેન્ટ લોગ, શું 7Stamp રાખે છે વિશે એક ગ્રાહક અને કેવી રીતે એક ગ્રાહક's ડેટા છે ભૂંસી નાખવામાં આવે છે.

અપડેટ કર્યું: 28 ઑક્ટોબર, 2026

લેખ ખોલો