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

Acest punct de interfață este necesar pentru procesarea plăților cu cardul în Grecia.

Plățile cu cardul (card de credit, card de debit) în Grecia trebuie semnate în prealabil prin intermediul sistemului myDATA.

Pentru mai multe informații, vă rugăm să consultați următoarele articole:

Rezultat

Un apel reușit către punctul final (200)

înregistrează plata cu cardul în myDATA și
returnează
- semnătura și
- ID-ul tranzacției.

Notă: Datele din cerere și din răspuns trebuie integrate în payload-ul documentului (POST /api/v1/transactions/storeDocument) al tranzacției corespunzătoare, în elementul „cardData”. Pentru mai multe informații, consultați: Fluxul procesului: Plată cu card de credit în Grecia.

Utilizare

de fiecare dată înainte de efectuarea unei noi plăți cu cardul.

Cerințe preliminare

Client fiscal pentru Grecia inițializat
Terminal de plată compatibil conectat la sistemul POS

Parametru

clientId – ID-ul clientului fiscal corespunzător

Request body

Detaliile plății trebuie specificate în Request body.

Exemplu:

{
  "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"
}

Elemente:

Element	Tip	Descriere
PaymentDate	M	Data și ora plății. Notă: Vă rugăm să respectați instrucțiunile privind înregistrarea orelor în RetailForce system!
DocumentGuid	M	Identificator unic al documentului folosind UUID/GUID. Atenție: Acesta trebuie să corespundă cu DocumentGuid-ul documentului la care este asociată plata! Se utilizează și ca link pentru chitanțele digitale.
documentType	M	Specificați tipul documentului – trebuie să corespundă tipului documentului propriu-zis.
DocumentNumber	M	Număr unic și secvențial al documentului (= „numărul documentului”), atribuit de sistemul casei de marcat. Atenție: Acesta trebuie să corespundă cu numărul documentului la care este asociată plata!
NetValue	M	Totalul net al plății – fără Vat.
TaxValue	M	Suma Vat aferentă plății
GrossValue	M	Valoarea brută a plății – inclusiv Vat
PaymentValue	M	suma plății
terminalId	M	suma plății

Răspuns

Dacă apelul are succes, se returnează următorul corp al răspunsului.