API & ενσωματώσεις

Ρυθμίσεις → API & ενσωματώσεις έχει τρεις καρτέλες: API κλειδιά, Webhooks και Ενσωματώσεις.
Τα πλήκτρα API και API είναι δωρεάν σε κάθε πρόγραμμα, περιλαμβανομένου του Free Forever· δεν υπάρχει πρόσθετο API. Οι σφραγίδες που δίνονται μέσω του API είναι Card Operations όπως οποιαδήποτε άλλη, οπότε σταματούν όταν τελειώσουν τα Card Operations του προγράμματος. Τα Webhooks είναι το επί πληρωμή μέρος, δείτε παρακάτω.
Κοστίζει επιπλέον το API;
Όχι. Τα κλειδιά API και API είναι δωρεάν σε κάθε σχέδιο, συμπεριλαμβανομένου του Free Forever. Οι σφραγίδες που δίνονται μέσω αυτού είναι Card Operations όπως οποιεσδήποτε άλλες.
Μπορώ να χρησιμοποιήσω το 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 δεν λήγει. Σταματά να λειτουργεί μόνο όταν αναγεννηθεί ή διαγραφεί, ή όταν απενεργοποιηθεί ή διαγραφεί το Staff Login του. Ένας νέος κωδικός ή σύνδεση για το Staff Login δεν το επηρεάζει.
- Το Regenerate δίνει στο Staff Login ένα νέο API κλειδί· το παλιό σταματά να λειτουργεί αμέσως.
- Το Delete σταματάει το κλειδί αμέσως. Η είσοδος του προσωπικού συνεχίζει να λειτουργεί στο 7Stamp Scanner και μπορεί να πάρει νέο κλειδί αργότερα.
- Η απενεργοποίηση μιας Σύνδεσης Προσωπικού κρατάει το κλειδί της: όταν η Σύνδεση Προσωπικού ενεργοποιηθεί ξανά, το ίδιο κλειδί λειτουργεί πάλι.
Λήγει ένα κλειδί API;
Όχι. Σταματά να λειτουργεί μόνο όταν ανανεωθεί ή διαγραφεί, ή όταν η Σύνδεση Προσωπικού απενεργοποιηθεί ή διαγραφεί.
Άλλαξα τον κωδικό πρόσβασης του Staff Login. Χρειάζομαι νέο κλειδί API;
Όχι. Ένας νέος κωδικός πρόσβασης ή σύνδεση δεν επηρεάζει το πλήκτρο API.
Άναψα ξανά μια Σύνδεση Προσωπικού. Λειτουργεί το παλιό της κλειδί API;
Ναι. Η απενεργοποίηση ενός Στοιχείου Σύνδεσης Προσωπικού διατηρεί το κλειδί του, και το ίδιο κλειδί λειτουργεί ξανά μόλις ενεργοποιηθεί ξανά.
Τι κάνει το API
Μέσω του API ένα σύστημα μπορεί:
- δώστε μια κάρτα σφραγίδας ως σύνδεσμο ή QR;
- προσθέστε γραμματόσημα;
- διάβασε μια κάρτα με τις σφραγίδες, τους στόχους και τα κουπόνια της;
- εκδώστε ένα κουπόνι απευθείας σε μια κάρτα;
- εξαγοράστε ένα κουπόνι με τον Κωδικό Κουπονιού του;
- στέλνω μήνυμα σε πελάτη.
Το API βρίσκει την κάρτα ενός Πελάτη χρησιμοποιώντας το δικό του αναγνωριστικό της Επιχείρησης, όπως ένα CRM ID, τηλέφωνο ή email, που αποστέλλεται ως external_id. Το αναγνωριστικό αποθηκεύεται στην κάρτα και επιστρέφει σε κάθε Webhook γι’ αυτήν. Το API δεν έχει καμία κλήση που να απαριθμεί τους Πελάτες μιας Επιχείρησης: ολόκληρη η βάση Πελατών εξάγεται μόνο μέσω της εξαγωγής διαχειριστή.
Αντί για ένα κλειδί API, μια εφαρμογή μπορεί να συνδεθεί με το login και τον κωδικό πρόσβασης ενός Staff Login — για μια συσκευή στην οποία συνδέεται ένας ταμίας. Ένα κλειδί API ταιριάζει σε μια συσκευή που λειτουργεί χωρίς επίβλεψη. Τα Webhooks προστίθενται μόνο στον διαχειριστή· το API δεν έχει κλήση για εγγραφή σε συμβάντα ή για λίστα αυτών.
Ο API δεν καθορίζει όριο ρυθμού αιτήσεων: οι κλήσεις δεν περιορίζονται βάσει αριθμού ή συχνότητας, και η ίδια κάρτα μπορεί να σαρωθεί ξανά αμέσως. Αυτό που περιορίζει την σφράγιση μέσω αυτού είναι το Card Operations του σχεδίου.
Μπορούμε να προσθέσουμε γραμματόσημα από το δικό μας CRM ή POS;
Ναι, μέσω του API. Μοιράζει κάρτες Σφραγίδων, προσθέτει σφραγίδες, διαβάζει κάρτες και εξαργυρώνει κουπόνια. Για να ενημερώνεται το σύστημά σας για γεγονότα, προσθέστε ένα Webhook — αυτό χρειάζεται το πρόσθετο Webhooks & Events.
Μπορούμε να εξαγάγουμε δεδομένα;
Μέσω του API διαβάζετε κάρτες με τον δικό σας αναγνωριστικό, και τα Webhooks στέλνουν γεγονότα καθώς συμβαίνουν. Το API δεν έχει λίστα με όλους τους Πελάτες — ολόκληρη η βάση Πελατών εξάγεται μέσω της διαχείρισης εξαγωγής.
Πώς βρίσκει η API την κάρτα ενός Πελάτη;
Με τον δικό σας αναγνωριστικό — ένα CRM ID, τηλέφωνο ή email — αποστέλλεται ως external_id. Αποθηκεύεται στην κάρτα και επιστρέφει σε κάθε Webhook σχετικά με αυτήν.
Μπορώ να εγγραφώ σε Webhooks μέσω του API;
Όχι. Τα 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 στη διαχείριση. Τα κλειδιά και τα Webhooks 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 και τα Webhooks της λειτουργούν με τον ίδιο τρόπο.
Webhooks

Ένα Webhook προστίθεται κάτω από το API & ενσωματώσεις → Webhooks → Προσθήκη webhook, με το URL που λαμβάνει τα γεγονότα. Στο 7Stamp δημιουργείται ένα Webhook για γεγονότα κάρτας σφραγίδων. Μια επιχείρηση μπορεί να προσθέσει πολλά Webhooks, το καθένα με το δικό του URL.
Τα Webhooks χρειάζονται το πρόσθετο Webhooks & Events, €19 ανά μήνα, που προσφέρεται μόνο σε επί πληρωμή προγράμματα. Η προσθήκη του πρώτου Webhook προσφέρει να το αγοράσετε· χωρίς αυτό δεν μπορεί να δημιουργηθεί ή να ενεργοποιηθεί ξανά ένα Webhook. Ένα πρόσθετο διατηρεί ενεργό ένα Webhook: μπορούν να προστεθούν περισσότερα, αλλά κάθε ενημέρωση χρέωσης της συνδρομής απενεργοποιεί όλα εκτός από το παλαιότερο.
Τα Webhooks στέλνουν γεγονότα καθώς συμβαίνουν από τη στιγμή που προστίθεται το Webhook. Πιο προηγούμενα γεγονότα δεν αποστέλλονται.
Είναι δωρεάν τα Webhooks;
Όχι. Χρειάζονται το πρόσθετο Webhooks & Events, €19 το μήνα, που προσφέρεται μόνο σε επί πληρωμή πλάνα. Το ίδιο το API είναι δωρεάν.
Πρόσθεσα έναν δεύτερο Webhook και ήταν απενεργοποιημένος. Γιατί;
Ένα πρόσθετο Webhooks & Events διατηρεί ένα Webhook ενεργοποιημένο. Κάθε ενημέρωση τιμολόγησης της συνδρομής απενεργοποιεί όλα εκτός από το παλαιότερο.
Θα στείλει ένας νέος 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· ένας τροχός που περιμένει να περιστραφεί δεν στέλνει ακόμα τίποτα.
Οι κριτικές πελατών δεν είναι εκδηλώσεις Κάρτας Σφραγίδων. Κάθε νέα κριτική στέλνει ένα γεγονός με οντότητα review και ενέργεια created, στα Webhooks που έχουν επιλεγμένο το Reviews μεταξύ των αντικειμένων τους στη σελίδα του Webhook. Ένα Webhook που προστίθεται εδώ έχει ρυθμιστεί μόνο για εκδηλώσεις Κάρτας Σφραγίδων, οπότε θα λαμβάνει κριτικές μόνο όταν το Reviews είναι επιλεγμένο.
Αποστέλλεται Webhook όταν μια σάρωση δεν προσθέτει σφραγίδα;
Ναι. Μια σάρωση που δεν προσθέτει σφραγίδα, όπως μια αγορά κάτω από την τιμή της σφραγίδας, εξακολουθεί να στέλνει SCAN με μηδενικές προστιθέμενες σφραγίδες.
Ποιο γεγονός μου λέει ότι ένας πελάτης κέρδισε στον τροχό;
LOTTERY_WIN, αποστέλλεται μία φορά όταν γυρίζεται ο τροχός. Ένας τροχός που περιμένει να γυριστεί δεν στέλνει τίποτα ακόμη.
Μπορώ να καταλάβω πότε ένας πελάτης αφαιρεί την κάρτα από το πορτοφόλι του;
Ναι. Η προσθήκη της κάρτας σε ένα πορτοφόλι και η αφαίρεσή της στέλνουν CARD_ADDED_TO_WALLET και CARD_REMOVED_FROM_WALLET, με το πορτοφόλι, Apple ή Google.
Πώς μπορώ να λαμβάνω νέες αξιολογήσεις πελατών μέσω ενός Webhook;
Άνοιξε τη σελίδα του Webhook και τσέκαρε τα Reviews ανάμεσα στα αντικείμενά του. Κάθε νέα κριτική τότε φτάνει με οντότητα review και ενέργεια created· ένα Webhook που προστέθηκε κάτω από API & integrations λαμβάνει μόνο γεγονότα Stamp card μέχρι τότε.
Όταν αποστέλλεται κάθε γεγονός
| Διοργάνωση | Απεσταλμένο όταν |
|---|---|
SCAN | Η σύνδεση του προσωπικού σαρώει την κάρτα: στο 7Stamp Scanner, μέσω του API ή από ένα POS όπως το Toast. Οι σφραγίδες που αφαιρούνται στο 7Stamp Scanner είναι ένα SCAN με αρνητικό stamps_added |
DELIVERY_INSERT | Ένας πελάτης ανοίγει έναν Κωδικό Σφραγίδας που δίνει σφραγίδες — έναν QR, έναν σύνδεσμο, τον ίδιο τον κωδικό ή μια πρόσκληση που έγινε μέσω του API |
RECEIPT_SCAN | Ένας Πελάτης σαρώει μια φορολογική απόδειξη στο Chatbot της Επιχείρησης και αυτή σφραγίζεται· amount είναι το συνολικό ποσό της απόδειξης |
CARD_JOINED | Ένας πελάτης παίρνει μια καινούργια κάρτα σφραγίδων, όποιον τρόπο κι αν είναι, με το 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.
Ποιο γεγονός μου λέει ότι ένας Πελάτης έφτασε σε έναν στόχο;
REWARD_EARNED για έναν στόχο Award, VOUCHER_ISSUED για έναν στόχο Voucher και LOTTERY_WIN για έναν στόχο Lottery, καθένα αποστέλλεται μετά το δικό του γεγονός σάρωσης.
Αποστέλλεται ένα Webhook όταν αφαιρούνται σφραγίδες;
Ναι. Οι σφραγίδες που αφαιρούνται στο 7Stamp Scanner φτάνουν ως SCAN με αρνητικό stamps_added.
Ποια είναι η διαφορά μεταξύ του VOUCHER_ISSUED και του ADMIN_VOUCHER_ISSUE;
Το VOUCHER_ISSUED εμφανίζεται όταν μια σάρωση φτάνει σε έναν στόχο Voucher. Το ADMIN_VOUCHER_ISSUE εμφανίζεται όταν ένα Voucher εκδίδεται απευθείας σε μια κάρτα, χειροκίνητα από τον διαχειριστή ή μέσω του API.
Ένας πελάτης που συμμετέχει με έναν κωδικό σφραγίδας στέλνει ένα γεγονός ή αρκετά;
Πολλά. Το CARD_JOINED έρχεται πρώτο, μετά το VOUCHER_PACK αν η κάρτα Σφραγίδας έχει Πακέτο Κουπονιών, και μετά το DELIVERY_INSERT με τις σφραγίδες.
Λαμβάνω ένα γεγονός για κάθε μήνυμα καμπάνιας;
Η CARD_CAMPAIGN αποστέλλεται μία φορά για κάθε κάρτα που φτάνει η Καμπάνια, με το Κουπόνι της Καμπάνιας όταν υπάρχει.
Τι λαμβάνει ένα Webhook
Κάθε γεγονός έχει το ίδιο σώμα JSON: το ID του γεγονότος, την Επιχείρηση, και το γεγονός με τον τύπο του, την κάρτα Σφραγίδων, τις σφραγίδες πριν και μετά, το ποσό αγοράς, το ID παραγγελίας και external_id η αποστολή ολοκλήρωσης, το login του προσωπικού που το εξυπηρέτησε, τα κουπόνια και τις ανταμοιβές που έδωσε, και το όνομα, το 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, το γεγονός βρίσκεται κάτω από το κλειδί card_event αντί για data, ώστε οι εφαρμογές τους να μπορούν να το διακρίνουν.
Υπογραφή
Κάθε παράδοση υπογράφεται. Η κεφαλίδα X-Webhook-Signature περιέχει ένα χρονικό σήμα και ένα HMAC-SHA256 αυτού του χρονικού σήματος και του ακατέργαστου σώματος, με κλειδί το μυστικό κλειδί του Webhook. Το μυστικό κλειδί εμφανίζεται και αναγεννάται στη σελίδα του Webhook. Μπορεί επίσης να προστεθεί σύνδεση και κωδικός πρόσβασης Basic auth.
Πώς μπορώ να ελέγξω ότι ένα Webhook προέρχεται πραγματικά από το 7Stamp;
Υπολογίστε το HMAC-SHA256 του χρονοστίγματος και του ακατέργαστου σώματος με το μυστικό κλειδί του Webhook και συγκρίνετέ το με την κεφαλίδα X-Webhook-Signature.
Πού μπορώ να βρω το μυστικό κλειδί του Webhook;
Στη σελίδα του Webhook, όπου μπορεί επίσης να αναγεννηθεί.
Μπορώ να προστατεύσω το τερματικό μου με έναν κωδικό πρόσβασης;
Ναι. Μπορεί να προστεθεί ένα login και κωδικός Basic auth στο Webhook, επιπλέον της υπογραφής.
Αποτυχημένες παραδόσεις
Ένα μήνυμα παράδοσης που δεν λαμβάνει απάντηση 2xx εντός τριάντα δευτερολέπτων επαναλαμβάνεται έως και δέκα φορές, κάθε φορά με αναμονή τέσσερα δευτερόλεπτα μεγαλύτερη από την προηγούμενη, ώστε οι επαναλήψεις να ολοκληρώνονται εντός περίπου τεσσάρων λεπτών. Μία απάντηση 429 με Retry-After επαναλαμβάνεται μετά από αυτό το χρονικό διάστημα. Η πρώτη αποτυχία ενός γεγονότος καταγράφει μια ειδοποίηση στο διαχειριστικό.
Μετά από εκατό αποτυχημένες παραδόσεις στη σειρά, το Webhook μπλοκάρεται από το σύστημα και δεν λαμβάνει άλλα γεγονότα. Η σελίδα του προειδοποιεί γι’ αυτό και έχει ένα κουμπί Ξεκλείδωμα· μια επιτυχημένη παράδοση επαναφέρει τον μετρητή.
Η σελίδα κάθε Webhook έχει ένα ημερολόγιο των παραδόσεων του, με το αίτημα που στάλθηκε και την απάντηση που ελήφθη. Το Επανάκληση στέλνει ξανά το ίδιο γεγονός, μόνο σε αυτό το Webhook.
Ο διακομιστής μου ήταν εκτός λειτουργίας. Έχουν χαθεί τα γεγονότα;
Κάθε αποστολή επιχειρείται ξανά έως δέκα φορές μέσα σε περίπου τέσσερα λεπτά. Μετά από αυτό, ανοίξτε το ημερολόγιο του Webhook και χρησιμοποιήστε την Επανάληψη για τα γεγονότα που χρειάζεστε.
Γιατί ο Webhook μου σταμάτησε να λαμβάνει γεγονότα;
Μετά από εκατό αποτυχημένες παραδόσεις στη σειρά, αποκλείεται από το σύστημα. Διορθώστε το endpoint και πατήστε Ξεκλείδωμα στη σελίδα του Webhook.
Μπορώ να δω τι στάλθηκε στο Webhook μου;
Ναι. Η σελίδα κάθε Webhook έχει ένα ημερολόγιο παραδόσεων με το αίτημα που εστάλη και την απάντηση που λήφθηκε.
Καρτέλα Ενσωματώσεων

Η καρτέλα Ενσωματώσεις περιλαμβάνει τις έτοιμες μεθόδους κατά ομάδα:
- Σφράγισμα στο ταμείο σας — Poster, Toast, το δικό σας POS ή CRM και «Δεν βλέπετε το POS σας;»;
- Φορολογικές αποδείξεις — SmartKasa;
- Automation — Make, Zapier και Δημόσιο Swagger.
Κάθε κάρτα αναφέρει αν χρειάζεται ένα κλειδί API. Η καρτέλα προσφέρει τις ίδιες κάρτες σε κάθε χώρα· μόνο οι φορολογικές αποδείξεις περιορίζονται ανά χώρα.

Μια επιχείρηση White Label δεν βλέπει κάρτα 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 Operations αυτής της Σύνδεσης Προσωπικού.
Πώς συνδέω το Poster;
Ανοίξτε Ενσωματώσεις → Poster και επιλέξτε Εγκατάσταση σε Poster. Η εφαρμογή έχει ρυθμιστεί με το κλειδί API ενός Σύνδεσης Προσωπικού.
Του/Της Card Operations χρησιμοποιούν οι σφραγίδες Poster;
Όσοι από την Είσοδο Προσωπικού χρησιμοποιούν το κλειδί API που χρησιμοποιεί η εφαρμογή.
Χρειάζομαι ένα κλειδί API για το Poster;
Ναι, το πλήκτρο API μιας Εισόδου Προσωπικού.
Toast
Το Toast εμφανίζει Ερχόμενο σύντομα για κάθε Επιχείρηση μέχρι να ρυθμιστεί η πρόσβαση Toast στην πλατφόρμα. Είναι ένας διακόπτης για ολόκληρη την πλατφόρμα, όχι μια ρύθμιση της Επιχείρησης· μόλις είναι ενεργοποιημένος, η κάρτα Toast κρατά τη ρύθμιση αυτή καθαυτή.
Κάθε τοποθεσία Toast συνδέεται μέσω του GUID της σε ένα Staff Login, χωρίς κλειδί API: οι Επιχειρήσεις, η κάρτα Σφραγίδας και το σχέδιο αυτού του Staff Login εφαρμόζονται σε κάθε αίτημα Toast από την τοποθεσία. Μια τοποθεσία μπορεί να συνδεθεί μόνο με ένα Staff Login, και ένα Staff Login κατέχει μια τοποθεσία. Τα αιτήματα από μια τοποθεσία απορρίπτονται όταν αποσυνδεθεί ή ενώ το Staff Login της είναι απενεργοποιημένο ή διαγραφεί.
Κάθε κουπόνι μπορεί να δοθεί σε ένα προϊόν μενού Toast: στο Toast POS γίνεται τότε έκπτωση σε αυτό το προϊόν. Ένα κουπόνι χωρίς προϊόν εφαρμόζεται ως μηδενική έκπτωση στο λογαριασμό, και ο ταμίας παραδίδει το δώρο με το χέρι. Τα κουπόνια εξαργυρώνονται στο Toast POS, και ένας τροχός που φτάνεται με έναν πληρωμένο λογαριασμό γυρίζεται αμέσως. Όταν το Toast αναιρεί μια συναλλαγή, οι σφραγίδες του αφαιρούνται ή τα εξαργυρωμένα κουπόνια του αποκαθίστανται.
Ένας επισκέπτης μπορεί να συμμετάσχει σε ένα κιόσκι Toast ή σε οθόνη για επισκέπτες χρησιμοποιώντας έναν αριθμό τηλεφώνου ή ένα email. Η κάρτα Σφραγίδας εκδίδεται αμέσως· ο επισκέπτης δεν λαμβάνει τίποτα από το 7Stamp μέχρι να το ανοίξει με το ίδιο τηλέφωνο ή email.
Γιατί λέει το Toast ‘Έρχεται σύντομα’;
Η πρόσβαση Toast είναι ένας διακόπτης για ολόκληρη την πλατφόρμα, όχι μια ρύθμιση της Επιχείρησής σας. Μέχρι να είναι ενεργοποιημένη, δεν υπάρχει τίποτα να συνδεθεί.
Πώς συνδέεται μια τοποθεσία Toast;
Με το GUID του σε ένα Staff Login, χωρίς κλειδί API. Η κάρτα σφραγίδας και το σχέδιο αυτού του Staff Login ισχύουν για κάθε αίτηση από την τοποθεσία.
Τι συμβαίνει με τα γραμματόσημα όταν το Toast ακυρώνει μια επιταγή;
Όταν το Toast αναιρεί μια συναλλαγή, οι σφραγίδες του επιστρέφονται ή τα εξαργυρωμένα κουπόνια του αποκαθίστανται.
SmartKasa

Το SmartKasa δεν χρειάζεται κλειδί API. Είναι μια πηγή αποδείξεων στην σάρωση αποδείξεων, προστιθέμενη από ένα ID καταστήματος SmartKasa ή από τον κωδικό εταιρείας για να καλύψει κάθε κατάστημα. Οι πελάτες σκανάρουν την απόδειξη SmartKasa στο Chatbot της Επιχείρησης, και οι σφραγίδες πηγαίνουν στο Είσοδο Προσωπικού αυτής της πηγής αποδείξεων.
Το SmartKasa είναι Ουκρανικό, και οι φορολογικές αποδείξεις λειτουργούν μόνο στην Ουκρανία, τη Σλοβακία, το Καζακστάν και το Ουζμπεκιστάν.
Χρειάζομαι ένα κλειδί API για το SmartKasa;
Όχι. Το SmartKasa είναι μια πηγή απόδειξης στην ανίχνευση αποδείξεων, προστιθέμενη από ένα αναγνωριστικό καταστήματος ή από τον κωδικό της εταιρείας.
Πού σαρώνονται οι αποδείξεις SmartKasa από τους πελάτες;
Στο Chatbot της Επιχείρησής σας. Οι σφραγίδες πηγαίνουν στο Σύνδεση Προσωπικού αυτής της πηγής απόδειξης.
Σε ποιες χώρες λειτουργούν οι φορολογικές αποδείξεις;
Στην Ουκρανία, τη Σλοβακία, το Καζακστάν και το Ουζμπεκιστάν.
Make και Zapier

Η εφαρμογή 7Stamp για το Make βρίσκεται στη δημόσια βιβλιοθήκη εφαρμογών του Make: αναζητήστε το 7Stamp σε οποιοδήποτε σενάριο του Make ή χρησιμοποιήστε Άνοιγμα στο Make στην καρτέλα Ενσωματώσεις. Η εφαρμογή μας για το Zapier δεν βρίσκεται στον δημόσιο κατάλογο του Zapier: το Άνοιγμα στο Zapier είναι πρόσκληση που προσθέτει την εφαρμογή στον λογαριασμό Zapier της ίδιας της επιχείρησης. Και οι δύο εφαρμογές λειτουργούν με το κλειδί API μιας Σύνδεσης Προσωπικού.
Τα σενάρια του Make και τα Zaps ξεκινούνται από τα Webhooks 7Stamp, επομένως οι ενεργοποιήσεις χρειάζονται το πρόσθετο Webhooks & Events. Ενέργειες όπως η προσθήκη σφραγίδων ή η έκδοση κουπονιού χρειάζονται μόνο ένα κλειδί API. Το Make και το Zapier δεν προσφέρονται σε μια Επιχείρηση White Label.
Πού βρίσκω την εφαρμογή 7Stamp στο Make και στο Zapier;
Στο Make, αναζητήστε το 7Stamp σε οποιοδήποτε σενάριο — η εφαρμογή βρίσκεται στη δημόσια βιβλιοθήκη εφαρμογών του Make. Στο Zapier δεν είναι ακόμη δημόσια, οπότε χρησιμοποιήστε Άνοιγμα στο Zapier στην καρτέλα Ενσωματώσεις — η πρόσκληση προσθέτει την εφαρμογή στον δικό σας λογαριασμό.
Χρειάζονται το Webhooks & Events πρόσθετο τα Make και Zapier;
Οι ενεργοποιητές το κάνουν, επειδή τα σενάρια και τα Zaps ξεκινούν από τα Webhooks 7Stamp. Ενέργειες όπως η προσθήκη σφραγίδων ή η έκδοση ενός κουπονιού χρειάζονται μόνο ένα κλειδί API.
Χρειάζομαι ένα κλειδί API για το Make ή Zapier;
Ναι. Οι εφαρμογές λειτουργούν με το κλειδί API ενός Staff Login.