☰ Μενού · Αλλαγές
Περισσότερα

Αλλαγές

Τι άλλαξε στο 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 απαντούν με JSON 404 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 συνεχίζει να λειτουργεί.
Ερωτήσεις για μια σύνδεση: api@loyaltyfy.io. Απαντάμε μέσα σε μία εργάσιμη ημέρα.