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

Ten punkt końcowy jest niezbędny do przetwarzania płatności kartowych w Grecji.

Płatności kartą (karta kredytowa, karta debetowa) w Grecji muszą zostać wcześniej zatwierdzone za pośrednictwem systemu myDATA.

Więcej informacji można znaleźć w następujących artykułach:

Wynik

Pomyślne wywołanie punktu końcowego (200)

rejestruje płatność kartą w systemie myDATA oraz
zwraca
- podpis oraz
- ID transakcji.

Uwaga: Dane z żądania i odpowiedzi należy umieścić w payload dokumentu (POST /api/v1/transactions/storeDocument) odpowiadającej transakcji, w elemencie „cardData”. Więcej informacji można znaleźć w sekcji: Schemat procesu: Płatność grecką kartą kredytową.

Sposób użycia

za każdym razem przed dokonaniem nowej płatności kartą.

Wymagania wstępne

Zainicjowany klient fiskalny dla Grecji
Obsługiwany terminal płatniczy podłączony do systemu POS

Parametr

clientId – ID odpowiedniego klienta fiskalnego

Request body

In the Request body, you must provide details about the payment.

Przykład:

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

Elementy:

Element	Typ	Opis
PaymentDate	M	Data i godzina płatności. Uwaga: Prosimy o przestrzeganie wytycznych dotyczących wprowadzania danych czasowych w RetailForce systemie!
DocumentGuid	M	Unikalny identyfikator dokumentu przy użyciu UUID/GUID. Uwaga: Musi to odpowiadać DocumentGuid dokumentu, z którym powiązana jest płatność! Służy również jako odnośnik do cyfrowych paragonów.
documentType	M	Należy określić typ dokumentu – musi on odpowiadać typowi dokumentu rzeczywistego.
DocumentNumber	M	Unikalny, kolejny numer dokumentu (= „numer dokumentu”), nadany przez system kasowy. Uwaga: Musi on odpowiadać numerowi dokumentu, z którym powiązana jest płatność!
NetValue	M	Suma netto płatności – bez podatku Vat.
TaxValue	M	Kwota podatku Vat od płatności
GrossValue	M	Kwota płatności brutto – wraz z podatkiem Vat
PaymentValue	M	kwota płatności
terminalId	M	kwota płatności

Odpowiedź

Jeśli wywołanie zakończy się powodzeniem, zwracana jest następująca treść odpowiedzi.