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

This endpoint is necessary to process card payments in Greece.

Card payments (credit card, debit card) in Greece must be signed in advance via the myDATA system.

For more information, please refer to the following articles:

Result

A successful call to the endpoint (200)

registers the card payment in myDATA and
returns the
- signature and
- the transaction ID.

Note: The data from the request and the response must be integrated into the document payload (POST /api/v1/transactions/storeDocument) of the corresponding transaction, in the ‘cardData’ element. For more information, see: Process flow: Greek credit card payment.

Usage

every time before a new card payment is to be made.

Prerequisites

Fiscal client for Greece initialised
Supported payment terminal connected to the POS system

Parameter

clientId - the ID of the corresponding fiscal client

Request Body

The details of the payment must be specified in the request body.

Example:

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

Elements:

Element	Type	Description
paymentDate	M	Date and time of payment. Note: Please observe the guidelines regarding time entries in the RetailForce system!
documentGuid	M	Unique identification of the document using UUID/GUID. Attention: This must correspond to the DocumentGuid of the document to which the payment is linked! Also used as a link for digital receipts.
documentType	M	Specify the document type – must correspond to the document type of the actual document.
documentNumber	M	Unique, sequential number of the document (=‘document number’), assigned by the cash register system. Attention: This must correspond to the document number of the document to which the payment is linked!
netValue	M	Net total of payment - excluding VAT.
taxValue	M	VAT amount of the payment
grossValue	M	Gross payment amount – including VAT
paymentValue	M	payment amount
terminalId	M	payment amount

Response

If the call is successful, the following response body is returned.