# aade_preloaded: η απόδειξη πριν από την πληρωμή με κάρτα, για delivery, παραλαβή και τραπέζι

> Με το aade_preloaded η απόδειξη εκδίδεται αμέσως με ΜΑΡΚ, επί πιστώσει, και η χρέωση περιμένει στο τερματικό. Πληρωμή με κάρτα την κάνει απόδειξη κάρτας, πληρωμή με μετρητά την αφήνει όπως είναι. Πότε το θέλεις και τι γίνεται μετά.
>
> AI-friendly Markdown version. HTML version: https://wrapp.ai/el/resources/aade-preloaded-apodeixi-prin-tin-pliromi-karta
> EN version: https://wrapp.ai/en/resources/aade-preloaded-receipt-before-card-payment.md

Στην κανονική ροή της κάρτας η απόδειξη περιμένει: φεύγει προς το τερματικό, ο πελάτης πληρώνει, και μόνο τότε παίρνει ΜΑΡΚ. Υπάρχουν όμως στιγμές όπου η απόδειξη πρέπει να υπάρχει **πριν** πληρώσει ο πελάτης, και μάλιστα πριν ξέρεις αν θα πληρώσει με κάρτα. Γι' αυτές υπάρχει το `aade_preloaded`.

## Τι κάνει

Στέλνεις την απόδειξη 11.1 με το τερματικό και ένα πεδίο παραπάνω:

| Πεδίο | Τιμή |
| --- | --- |
| `pos_device_id` | Το τερματικό που θα χρεώσει |
| `payment_method_type` | `3` |
| `aade_preloaded` | `true` |

- **Η απόδειξη εκδίδεται αμέσως**, με ΜΑΡΚ και τρόπο πληρωμής «επί πιστώσει».
- **Η χρέωση περιμένει στο τερματικό**, έτοιμη για όταν έρθει η στιγμή της πληρωμής.
- **Όταν ο πελάτης πληρώσει με κάρτα** σε εκείνο το τερματικό, το Wrapp αλλάζει τον τρόπο πληρωμής της απόδειξης σε κάρτα, με νέο ΜΑΡΚ πληρωμής.

Το πλήρες σώμα είναι στα [παραδείγματα JSON για την κάρτα στην πόρτα](/el/resources/paradeigmata-json-paraggelioliipsia-mydata-api#preloaded).

## Κανονική ροή ή aade_preloaded

| Πτυχή | Κάρτα στο τερματικό | Με aade_preloaded |
| --- | --- | --- |
| Πότε παίρνει ΜΑΡΚ η απόδειξη | Μόλις εγκριθεί η πληρωμή | Αμέσως |
| Τρόπος πληρωμής στην έκδοση | Κάρτα | Επί πιστώσει, γίνεται κάρτα με την πληρωμή |
| Αν ο πελάτης πληρώσει μετρητά | Στέλνεις απόδειξη μετρητών, χωρίς τερματικό | Η ίδια απόδειξη μένει επί πιστώσει |

## Πότε το θέλεις

### Delivery με κάρτα στην πόρτα

Η παραγγελία φεύγει με την απόδειξή της. Στέλνεις την απόδειξη με το τερματικό του διανομέα και `aade_preloaded`, και η χρέωση περιμένει σε εκείνο το τερματικό. Στην πόρτα ο πελάτης βάζει την κάρτα, και η απόδειξη που ήδη κρατά γίνεται απόδειξη κάρτας.

### Πληρωμή στην παραλαβή

Ο πελάτης παρήγγειλε για take-away και θα πληρώσει όταν έρθει. Η απόδειξη βγαίνει όταν ετοιμάζεται η παραγγελία, και η χρέωση περιμένει στο τερματικό του πάγκου μέχρι να εμφανιστεί.

### Ο λογαριασμός στο τραπέζι

Η απόδειξη τυπώνεται και πηγαίνει στο τραπέζι μαζί με το τερματικό, όπως ο πελάτης έχει συνηθίσει να βλέπει τον λογαριασμό πριν πληρώσει. Αν το τραπέζι έχει δελτία παραγγελίας, η απόδειξη τα συσχετίζει όπως κάθε απόδειξη τραπεζιού.

## Μετά την πληρωμή

- **Με κάρτα:** δεν έρχεται δεύτερο webhook, γιατί η απόδειξη είχε ήδη εκδοθεί και αλλάζει μόνο ο τρόπος πληρωμής της. Τα στοιχεία της κάρτας τα διαβάζεις από το `GET /invoices/{id}`.
- **Με μετρητά:** ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει «επί πιστώσει». Δεν χρειάζεται τίποτα άλλο: ούτε πιστωτικό, ούτε νέα απόδειξη.
- **Επιστροφή:** αφού την κάρτα τη χρέωσε η ίδια η απόδειξη, η επιστροφή είναι ένα 11.4 με το τερματικό, όπως εξηγεί ο οδηγός για την [επιστροφή χρημάτων στην κάρτα](/el/resources/epistrofi-chrimaton-karta-pos-mydata).

## Πώς ξεκινάς

Κάνε [δωρεάν εγγραφή στο wrapp.ai](https://wrapp.ai/el/users/new) με το ΑΦΜ σου και πάτα «Δοκίμασε το API». Στο staging συνδέεις ένα δοκιμαστικό τερματικό Viva και δοκιμάζεις και τις δύο ροές, χωρίς φορολογική ισχύ. Πώς λειτουργεί η κάρτα στην κανονική ροή, και η μικτή πληρωμή, το εξηγεί ο οδηγός για τη [μικτή πληρωμή και την κάρτα στο τραπέζι](/el/resources/mikti-pliromi-karta-trapezi-mydata).

## Συχνές ερωτήσεις

### Τι κάνει το aade_preloaded;

Εκδίδει την απόδειξη αμέσως, με ΜΑΡΚ και τρόπο πληρωμής επί πιστώσει, και στέλνει τη χρέωση να περιμένει στο τερματικό. Όταν ο πελάτης πληρώσει με κάρτα σε εκείνο το τερματικό, ο τρόπος πληρωμής της απόδειξης γίνεται κάρτα, με νέο ΜΑΡΚ πληρωμής.

### Πότε χρησιμοποιώ aade_preloaded αντί για την κανονική ροή;

Όταν η απόδειξη πρέπει να υπάρχει πριν πληρώσει ο πελάτης: στο delivery με κάρτα στην πόρτα, στην πληρωμή στην παραλαβή, και στον λογαριασμό που πηγαίνει τυπωμένος στο τραπέζι μαζί με το τερματικό.

### Τι γίνεται αν ο πελάτης πληρώσει τελικά μετρητά;

Ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει επί πιστώσει. Δεν χρειάζεται πιστωτικό ούτε νέα απόδειξη.

### Έρχεται webhook όταν πληρωθεί η κάρτα;

Όχι δεύτερο. Η απόδειξη είχε ήδη εκδοθεί και αλλάζει μόνο ο τρόπος πληρωμής της, οπότε τα στοιχεία της κάρτας τα διαβάζεις από το GET /invoices/{id}.

### Πώς γίνεται επιστροφή σε απόδειξη με aade_preloaded;

Αφού την κάρτα τη χρέωσε η ίδια η απόδειξη, ένα πιστωτικό 11.4 με pos_device_id, refund_invoice_id το id της απόδειξης και το ΜΑΡΚ της στο correlated_invoices πιστώνει την πώληση και επιστρέφει στην κάρτα μαζί.

Χρειάζεσαι βοήθεια; Επικοινώνησε μαζί μας: https://wrapp.ai/contact