POST /api/v1/payment/{clientId}/pay – RetailForce

Αυτό το σημείο τερματισμού είναι απαραίτητο για την επεξεργασία πληρωμών με κάρτα στην Ελλάδα.

Οι πληρωμές με κάρτα (πιστωτική κάρτα, χρεωστική κάρτα) στην Ελλάδα πρέπει να υπογραφούν εκ των προτέρων μέσω του συστήματος myDATA.

Για περισσότερες πληροφορίες, ανατρέξτε στα ακόλουθα άρθρα:

Αποτέλεσμα

Μια επιτυχής κλήση στο endpoint (200)

καταχωρεί την πληρωμή με κάρτα στο myDATA και
επιστρέφει την
- υπογραφή και
- το ID της συναλλαγής.

Σημείωση: Τα δεδομένα από το αίτημα και την απάντηση πρέπει να ενσωματωθούν στο payload του εγγράφου (POST /api/v1/transactions/storeDocument) της αντίστοιχης συναλλαγής, στο στοιχείο «cardData». Για περισσότερες πληροφορίες, δείτε: Ροή διαδικασίας: Πληρωμή με ελληνική πιστωτική κάρτα.

Χρήση

κάθε φορά πριν από την πραγματοποίηση μιας νέας πληρωμής με κάρτα.

Προαπαιτούμενα

Έχει αρχικοποιηθεί ο φορολογικός πελάτης για την Ελλάδα
Υποστηριζόμενος terminal πληρωμών συνδεδεμένος στο σύστημα POS

Παράμετρος

clientId - το ID του αντίστοιχου φορολογικού πελάτη

Request body

Τα στοιχεία της πληρωμής πρέπει να προσδιορίζονται στο Request body.

Παράδειγμα:

{
  "paymentDate": "2025-10-15T05:34:19.773Z",
  "documentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "documentType": "[0] = Receipt",
  "documentNumber": "string",
  "netValue": 0,
  "taxValue": 0,
  "grossValue": 0,
  "paymentValue": 0,
  "terminalId": "string"
}

Στοιχεία:

Στοιχείο	Τύπος	Περιγραφή
PaymentDate	M	Ημερομηνία και ώρα πληρωμής. Σημείωση: Παρακαλούμε να τηρείτε τις οδηγίες σχετικά με την καταχώριση ωρών στο RetailForce system!
DocumentGuid	M	Μοναδικός αναγνωριστικός κωδικός του εγγράφου με χρήση UUID/GUID. Προσοχή: Αυτό πρέπει να αντιστοιχεί στο DocumentGuid του εγγράφου με το οποίο συνδέεται η πληρωμή! Χρησιμοποιείται επίσης ως σύνδεσμος για ψηφιακές αποδείξεις.
documentType	M	Καθορίστε τον τύπο εγγράφου – πρέπει να αντιστοιχεί στον τύπο εγγράφου του συγκεκριμένου εγγράφου.
DocumentNumber	M	Μοναδικός, διαδοχικός αριθμός του εγγράφου (= «αριθμός εγγράφου»), ο οποίος αποδίδεται από το σύστημα ταμειακής μηχανής. Προσοχή: Πρέπει να αντιστοιχεί στον αριθμό του εγγράφου με το οποίο συνδέεται η πληρωμή!
NetValue	M	Καθαρό συνολικό ποσό πληρωμής – χωρίς Vat.
TaxValue	M	Ποσό Vat της πληρωμής
GrossValue	M	Μικτό ποσό πληρωμής – συμπεριλαμβανομένου του Vat
PaymentValue	M	Ποσό πληρωμής
terminalId	M	ποσό πληρωμής

Απάντηση

Εάν η κλήση είναι επιτυχής, επιστρέφεται το ακόλουθο σώμα απόκρισης.