aade_preloaded: η απόδειξη πριν από την πληρωμή με κάρτα, για delivery, παραλαβή και τραπέζι
Με το aade_preloaded η απόδειξη εκδίδεται αμέσως με ΜΑΡΚ, επί πιστώσει, και η χρέωση περιμένει στο τερματικό. Πληρωμή με κάρτα την κάνει απόδειξη κάρτας, πληρωμή με μετρητά την αφήνει όπως είναι. Πότε το θέλεις και τι γίνεται μετά.
Στην κανονική ροή της κάρτας η απόδειξη περιμένει: φεύγει προς το τερματικό, ο πελάτης πληρώνει, και μόνο τότε παίρνει ΜΑΡΚ. Υπάρχουν όμως στιγμές όπου η απόδειξη πρέπει να υπάρχει πριν πληρώσει ο πελάτης, και μάλιστα πριν ξέρεις αν θα πληρώσει με κάρτα. Γι' αυτές υπάρχει το aade_preloaded.
Τι κάνει
Στέλνεις την απόδειξη 11.1 με το τερματικό και ένα πεδίο παραπάνω:
| Πεδίο | Τιμή |
|---|---|
pos_device_id | Το τερματικό που θα χρεώσει |
payment_ | 3 |
aade_ | true |
- Η απόδειξη εκδίδεται αμέσως, με ΜΑΡΚ και τρόπο πληρωμής «επί πιστώσει».
- Η χρέωση περιμένει στο τερματικό, έτοιμη για όταν έρθει η στιγμή της πληρωμής.
- Όταν ο πελάτης πληρώσει με κάρτα σε εκείνο το τερματικό, το Wrapp αλλάζει τον τρόπο πληρωμής της απόδειξης σε κάρτα, με νέο ΜΑΡΚ πληρωμής.
Το πλήρες σώμα είναι στα παραδείγματα JSON για την κάρτα στην πόρτα.
Κανονική ροή ή aade_preloaded
| Πτυχή | Κάρτα στο τερματικό | Με aade_preloaded |
|---|---|---|
| Πότε παίρνει ΜΑΡΚ η απόδειξη | Μόλις εγκριθεί η πληρωμή | Αμέσως |
| Τρόπος πληρωμής στην έκδοση | Κάρτα | Επί πιστώσει, γίνεται κάρτα με την πληρωμή |
| Αν ο πελάτης πληρώσει μετρητά | Στέλνεις απόδειξη μετρητών, χωρίς τερματικό | Η ίδια απόδειξη μένει επί πιστώσει |
Πότε το θέλεις
Delivery με κάρτα στην πόρτα
Η παραγγελία φεύγει με την απόδειξή της. Στέλνεις την απόδειξη με το τερματικό του διανομέα και aade_preloaded, και η χρέωση περιμένει σε εκείνο το τερματικό. Στην πόρτα ο πελάτης βάζει την κάρτα, και η απόδειξη που ήδη κρατά γίνεται απόδειξη κάρτας.
Πληρωμή στην παραλαβή
Ο πελάτης παρήγγειλε για take-away και θα πληρώσει όταν έρθει. Η απόδειξη βγαίνει όταν ετοιμάζεται η παραγγελία, και η χρέωση περιμένει στο τερματικό του πάγκου μέχρι να εμφανιστεί.
Ο λογαριασμός στο τραπέζι
Η απόδειξη τυπώνεται και πηγαίνει στο τραπέζι μαζί με το τερματικό, όπως ο πελάτης έχει συνηθίσει να βλέπει τον λογαριασμό πριν πληρώσει. Αν το τραπέζι έχει δελτία παραγγελίας, η απόδειξη τα συσχετίζει όπως κάθε απόδειξη τραπεζιού.
Μετά την πληρωμή
- Με κάρτα: δεν έρχεται δεύτερο webhook, γιατί η απόδειξη είχε ήδη εκδοθεί και αλλάζει μόνο ο τρόπος πληρωμής της. Τα στοιχεία της κάρτας τα διαβάζεις από το
GET /invoices/{id}. - Με μετρητά: ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει «επί πιστώσει». Δεν χρειάζεται τίποτα άλλο: ούτε πιστωτικό, ούτε νέα απόδειξη.
- Επιστροφή: αφού την κάρτα τη χρέωσε η ίδια η απόδειξη, η επιστροφή είναι ένα 11.4 με το τερματικό, όπως εξηγεί ο οδηγός για την επιστροφή χρημάτων στην κάρτα.
Πώς ξεκινάς
Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και πάτα «Δοκίμασε το API». Στο staging συνδέεις ένα δοκιμαστικό τερματικό Viva και δοκιμάζεις και τις δύο ροές, χωρίς φορολογική ισχύ. Πώς λειτουργεί η κάρτα στην κανονική ροή, και η μικτή πληρωμή, το εξηγεί ο οδηγός για τη μικτή πληρωμή και την κάρτα στο τραπέζι.
Συχνές ερωτήσεις
Τι κάνει το aade_preloaded;
Εκδίδει την απόδειξη αμέσως, με ΜΑΡΚ και τρόπο πληρωμής επί πιστώσει, και στέλνει τη χρέωση να περιμένει στο τερματικό. Όταν ο πελάτης πληρώσει με κάρτα σε εκείνο το τερματικό, ο τρόπος πληρωμής της απόδειξης γίνεται κάρτα, με νέο ΜΑΡΚ πληρωμής.
Πότε χρησιμοποιώ aade_preloaded αντί για την κανονική ροή;
Όταν η απόδειξη πρέπει να υπάρχει πριν πληρώσει ο πελάτης: στο delivery με κάρτα στην πόρτα, στην πληρωμή στην παραλαβή, και στον λογαριασμό που πηγαίνει τυπωμένος στο τραπέζι μαζί με το τερματικό.
Τι γίνεται αν ο πελάτης πληρώσει τελικά μετρητά;
Ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει επί πιστώσει. Δεν χρειάζεται πιστωτικό ούτε νέα απόδειξη.
Έρχεται webhook όταν πληρωθεί η κάρτα;
Όχι δεύτερο. Η απόδειξη είχε ήδη εκδοθεί και αλλάζει μόνο ο τρόπος πληρωμής της, οπότε τα στοιχεία της κάρτας τα διαβάζεις από το GET /invoices/{id}.
Πώς γίνεται επιστροφή σε απόδειξη με aade_preloaded;
Αφού την κάρτα τη χρέωσε η ίδια η απόδειξη, ένα πιστωτικό 11.4 με pos_device_id, refund_invoice_id το id της απόδειξης και το ΜΑΡΚ της στο correlated_invoices πιστώνει την πώληση και επιστρέφει στην κάρτα μαζί.
Χρειάζεσαι βοήθεια;
Αν έχεις απορία για αυτό το θέμα ή θέλεις να σιγουρευτείς ότι όλα ρυθμίστηκαν σωστά, επικοινώνησε μαζί μας και θα το δούμε μαζί.