☰ Μενού · Αλλαγές
Περισσότερα
Αλλαγές
Τι άλλαξε στο API, με τις νεότερες αλλαγές πρώτες.
22 Νοεμβρίου 2026
cashierσταPOST /v1/transactions,POST /v1/checks/calculateκαιPOST /v1/holds: ένα κείμενο ή{id, name}που λέει ποιος χτύπησε την απόδειξη. Αποθηκεύεται με την απόδειξη και τη δέσμευση, επιστρέφεται στοcashierκαι το χρησιμοποιούν τα σήματα ταμιών του ιδιοκτήτη. Δεν αλλάζει ποτέ το cashback και δεν μπαίνει στον έλεγχο idempotency.
17 Νοεμβρίου 2026
- Κανόνας «σε μία επίσκεψη ο πελάτης ή κερδίζει ή εξαργυρώνει»: μια απόδειξη με εξαργύρωση δεν δίνει cashback, και οι απαντήσεις των
POST /v1/checks/calculateκαιPOST /v1/transactionsέχουνearn_blocked: "redeemed". Χωρίς τον κανόνα το πεδίο δεν υπάρχει.
16 Νοεμβρίου 2026
- Καταστήματα: ο ιδιοκτήτης συνδέει κωδικούς ταμείων και κωδικούς καταστημάτων με καταστήματα. Στείλτε
store_idμε αποδείξεις, υπολογισμούς και δεσμεύσεις όταν λείπει τοregister_idή δεν είναι συνδεδεμένο· οι απαντήσεις έχουνlocationμεmatched_by. Δείτε πώς στέλνεται το κατάστημα και το ταμείο. - Κανόνες καταστήματος: δικό του ποσοστό, απενεργοποιημένη απόκτηση, πληρωμή με cashback απαγορευμένη ή περιορισμένη. Απόδειξη ή δέσμευση με cashback όπου απαγορεύεται απορρίπτεται με
400 redeem_not_allowed_here, και ο υπολογισμός απαντάredeem_blocked_reason. Εξαιρέσεις προϊόντων και κατηγοριών ανά κατάστημα:GET /v1/catalog/location-rules. - Κατηγορία με όνομα: οι επιχειρήσεις με αναλυτική σειρά κανόνων δέχονται στο
line_items[].categoryκαι το όνομα και τον κωδικό της κατηγορίας. Ένα όνομα δεν δημιουργεί ποτέ νέα κατηγορία· κερδίζει ο πιο συγκεκριμένος κανόνας. - Προϊόντα σε προσφορά:
line_items[].promo: true· ο ιδιοκτήτης αποφασίζει αν αυτές οι γραμμές δίνουν cashback και αν πληρώνονται με cashback. - Τύποι έκπτωσης:
discount_typeστην απόδειξη και στις γραμμές· ο ιδιοκτήτης ορίζει ανά τύπο αν δίνει cashback και αν πληρώνεται με cashback, αλλιώς400 discount_redeem_not_allowed. - Cashback ως πληρωμή ή ως έκπτωση: σε λειτουργία έκπτωσης κάθε γραμμή έχει
redeem_allocated· η λειτουργία είναι στοsettings.redeem_accounting. - Εκτός σύνδεσης: το
GET /v1/accountεπιστρέφει στοsettingsταtimeout_seconds,offline_redeemκαιoffline_max_hours. Δείτε Όταν το ταμείο είναι εκτός σύνδεσης. - Δώρα: το
POST /v1/checks/calculateαπαντάgifts.pendingκαιgifts.unlocks, τοPOST /v1/transactionsαπαντάgifts.unlocked· σημειώστε ένα δώρο ως παραδομένο μεPOST /v1/members/{member}/gifts/{gift_id}/give. Γεγονόταgift.unlockedκαιgift.given.
5 Νοεμβρίου 2026
- Κάθε συναλλαγή και το
POST /v1/checks/calculateέχουνline_itemsμε όσα κέρδισε κάθε γραμμή:amount,cashback_earned,earn_percent,redeemable,quantity_refunded. - Επιστροφές κατά γραμμές: το
POST /v1/transactions/{external_id}/refundsδέχεταιline_itemsμε κωδικό και ποσότητα· το cashback ακολουθεί όσα κέρδισε πραγματικά κάθε γραμμή. - Πρόθεμα αριθμού κάρτας: ο ιδιοκτήτης το ορίζει στους κανόνες για τα ταμεία και οι νέες κάρτες αρχίζουν με αυτό·
settings.card_prefixστοGET /v1/account. - Κανόνες ανά προϊόν: ο ιδιοκτήτης παρακάμπτει την κατηγορία σε ένα προϊόν, μόνιμα ή μεταξύ ημερομηνιών· το
GET /v1/catalog/productsτους επιστρέφει στοrules. - Το cashback μπορεί να γίνει αρνητικό: μια επιστροφή ή ακύρωση αφαιρεί cashback που ο πελάτης ήδη ξόδεψε, το
cashback.balanceγίνεται αρνητικό και η επόμενη απόδειξη καλύπτει πρώτα το χρέος. - Πίνακας: ευχές γενεθλίων στη γλώσσα της κάρτας, εκδηλώσεις και γενέθλια χωρίς εικόνα (το κείμενο μπαίνει πάνω στο σχέδιο της κάρτας), επίπεδα σφραγίδων που αλλάζουν τη στιγμή που συγκεντρώνονται οι σφραγίδες.
- Πίνακας: αυτόματες καμπάνιες (αγόρασε προϊόν, σταμάτησε να το αγοράζει, πρόγραμμα σε τμήμα) με ημερολόγιο αποστολών· κοόρτες αγοραστών με LTV· τμήματα κατά προϊόντα που αγοράστηκαν και κατά υπόλοιπο cashback.
- Επιστροφή ανά γραμμή: το
POST /v1/transactions/{external_id}/returnsδέχεται τα επιστρεφόμεναline_itemsκαι κινεί το cashback με βάση όσα κέρδισε κάθε γραμμή· ο ίδιος μηχανισμός με την επιστροφή με γραμμές, ως ξεχωριστό endpoint.
24 Οκτωβρίου 2026
- Παραγγελίες πακέτο:
type: pickupμεlocation,pickup_at,guestκαιday_number. - Κάθε παραγγελία έχει
paymentκαιhistory. ΤοGET /v1/ordersδέχεται?type=και?location=. - Ένα πιάτο με υποχρεωτική επιλογή χωρίς αυτήν απορρίπτεται με
needs_optionsπριν φτάσει σε εσάς.
9 Οκτωβρίου 2026
- Μια απόδειξη που ακυρώθηκε ή επιστράφηκε πλήρως δεν μετρά πια ως επίσκεψη ή δαπάνη, οπότε οι επιστροφές δεν ανεβάζουν το επίπεδο cashback του πελάτη.
- Οι άγνωστες διαδρομές κάτω από το
/v1απαντούν με JSON404 endpoint_not_foundαντί για τη σελίδα του ιστότοπου· τοGET /v1περιγράφει το API. - Τα σφάλματα επικύρωσης λένε τι να στείλετε, για παράδειγμα ότι το
amountείναι ακέραιος σε ελάχιστες μονάδες.
7 Οκτωβρίου 2026
- Κανόνες της επιχείρησης για τα ταμεία: εξαργύρωση μέσω δεσμεύσεων, αριθμοί αποδείξεων ανά ταμείο, όριο για αποδείξεις που στέλνονται αργότερα, όρια cashback ανά απόδειξη και ανά ημέρα, υποχρεωτική σάρωση κάρτας, χειροκίνητες διορθώσεις. Κάθε κλειδί μπορεί να έχει δικές του τιμές. Το
GET /v1/accountεπιστρέφει τους κανόνες στοsettings. - Δεσμεύσεις:
POST /v1/holds, επιβεβαίωση μεhold_id, αποδέσμευση, αυτόματη λήξη. - Το
POST /v1/checks/calculateδείχνει τι θα έκανε μια απόδειξη χωρίς να καταγράψει τίποτα. - Μερικές επιστροφές:
POST /v1/transactions/{external_id}/refunds. - Κατάλογος: ανέβασμα προϊόντων με βάση το SKU· ο ιδιοκτήτης ορίζει ανά κατηγορία αν δίνει cashback, αν πληρώνεται με cashback και αν έχει δικό της ποσοστό.
- Τα μέλη δείχνουν τα
levels,next_level,heldκαιavailableτου cashback. - Κάθε απόδειξη, σάρωση και υπολογισμός έχει
displayμε έτοιμο κείμενο για τον ταμία και την απόδειξη. - Νέα δικαιώματα
members:adjust,catalog:read,catalog:write· νέα συμβάνταtransaction.refunded,balance.adjusted.
6 Οκτωβρίου 2026
- API v1 στο
/api/v1, για κάθε τύπο προγράμματος: cashback, σφραγίδες, εκπτώσεις βάσει επισκέψεων, επίπεδα VIP. - Μέλη: εγγραφή με δικό σας αριθμό κάρτας, αναζήτηση με κάρτα, barcode, τηλέφωνο ή id, ιστορικό, εξαργύρωση επιβραβεύσεων.
- Μορφή barcode κάρτας ανά πρόγραμμα: QR ή Code 128 με τον αριθμό κάρτας, ή QR με το serial.
- Συναλλαγές με
line_items, ακυρώσεις, εξαργύρωση cashback με τα όρια του προγράμματος. - Kiosks και σαρωτές:
POST /v1/scans,POST /v1/visits, το δικαίωμαdevices:write. - API μενού με τα SKU σας στο
external_id, μαζικός συγχρονισμός τιμών και λίστας εξαντλημένων. - Παραγγελίες από το τραπέζι μέσω QR μενού, με καταστάσεις για το POS.
- Webhooks με υπογραφές και επαναλήψεις,
Idempotency-Key, σελιδοποίηση με cursor, δικαιώματα κλειδιών. - Το προηγούμενο POS API στο
/api/pos/v1συνεχίζει να λειτουργεί.