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

Questo endpoint è necessario per elaborare i pagamenti con carta in Grecia.

I pagamenti con carta (carta di credito, carta di debito) in Grecia devono essere preventivamente autorizzati tramite il sistema myDATA.

Per ulteriori informazioni, si prega di consultare i seguenti articoli:

Risultato

Una chiamata riuscita all’endpoint (200)

registra il pagamento con carta in myDATA e
restituisce la
- firma e
- l’ID della transazione.

Nota: i dati della richiesta e della risposta devono essere integrati nel payload del documento (POST /api/v1/transactions/storeDocument) della transazione corrispondente, nell’elemento «cardData». Per ulteriori informazioni, consultare: Flusso di processo: pagamento con carta di credito greca.

Utilizzo

ogni volta prima di effettuare un nuovo pagamento con carta.

Prerequisiti

Client fiscale per la Grecia inizializzato
Terminale di pagamento supportato integrato con il sistema POS

Parametro

clientId - l’ID del client fiscale corrispondente

Corpo della richiesta

I dettagli del pagamento devono essere specificati nel Request body.

Esempio:

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

Elementi:

Elemento	Tipo	Descrizione
PaymentDate	M	Data e ora del pagamento. Nota: si prega di attenersi alle linee guida relative alla registrazione degli orari nel RetailForce system!
DocumentGuid	M	Identificativo univoco del documento tramite UUID/GUID. Attenzione: questo deve corrispondere al DocumentGuid del documento a cui è collegato il pagamento. Viene impiegato anche come riferimento per le ricevute digitali.
documentType	M	Specificare il tipo di documento – deve corrispondere al tipo di documento del documento effettivo.
DocumentNumber	M	Numero univoco e sequenziale del documento (= «numero del documento»), assegnato dal sistema di cassa. Attenzione: deve corrispondere al numero del documento a cui è collegato il pagamento.
valoreNetto	M	Totale netto del pagamento – IVA esclusa.
TaxValue	M	Importo dell’imposta sul valore aggiunto (VAT) relativo al pagamento
GrossValue	M	Importo lordo del pagamento – IVA inclusa
PaymentValue	M	importo del pagamento
terminalId	M	importo del pagamento

Risposta

In caso di esito positivo della richiesta, viene restituito il seguente corpo della risposta.