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

Dieser Endpunkt ist notwendig, um Kartenzahlungen in Griechenland abzuwickeln.

Kartenzahlungen (Kreditkarte, Debitkarte) müssen in Griechenland, vorab über das myDATA-System signiert werden.

Weitere Informationen dazu, finden Sie in den nachfolgenden Artikeln:

Ergebnis

Ein erfolgreicher Aufruf des Endpunktes (200)

registriert die Kartenzahlung in myDATA und
gibt die
- Signatur sowie
- die TransaktionsId zurück.

Hinweis: Die Daten aus dem Request sowie aus dem Response müssen in den Document-Payload (POST /api/v1/transactions/storeDocument) der entsprechenden Transaktion, im Element "cardData", integriert werden. Weitere Informationen dazu finden Sie in: Prozessablauf: Griechische Kreditkartenbezahlung.

Verwendung

jedes Mal, bevor eine neue Kartenzahlung erfolgen soll.

Voraussetzungen

Fiskal Client für Griechenland initialisiert
unterstütztes Bezahlterminal an das Kassensystem angeschlossen

Parameter

clientId - die ID des entsprechenden Fiskal Clients

Request Body

Im Request body müssen die Einzelheiten der Zahlung angeführt werden.

Beispiel:

{
  "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	Typ	Beschreibung
paymentDate	M	Datum und Uhrzeit der Zahlung. Hinweis: beachten Sie die Vorgaben zu Zeitangaben im RetailForce System!
documentGuid	M	Eindeutige Kennung des Dokuments mittels UUID / GUID. Achtung: Diese muss der DocumentGuid des Dokumentes entsprechen, mit welchem die Zahlung verknüpft ist! Wird auch als Verknüpfung für digitale Belege verwendet.
documentType	M	Angabe des Dokumententyps - muss dem Dokumententyp des eigentlichen Beleges entsprechen.
documentNumber	M	Eindeutige, fortlaufende Nummer des Dokuments (="Belegnummer"), vom Kassensystem vergeben. Achtung: Diese muss der DocumentNumber des Dokumentes entsprechen, mit welchem die Zahlung verknüpft ist!
netValue	M	Netto-Summe der Zahlung - exkl. MwSt.
taxValue	M	MwSt.-Summe der Zahlung
grossValue	M	Brutto-Summe der Zahlung - inkl. MwSt.
paymentValue	M	Zahlungsbetrag
terminalId	M	ID des Bezahlterminals

Response

Bei einem erfolgreichen Aufruf wird folgender Response Body zurückgegeben.