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

Тази крайна точка е необходима за обработката на плащания с карта в Гърция.

Плащанията с карта (кредитна карта, дебитна карта) в Гърция трябва да бъдат предварително одобрени чрез системата myDATA.

За повече информация, моля, вижте следните статии:

Резултат

Успешно извикване на крайната точка (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	сума на плащането

Отговор

Ако заявката е успешна, се връща следният текст на отговора.