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

Este ponto de extremidade é necessário para processar pagamentos com cartão na Grécia.

Os pagamentos com cartão (cartão de crédito, cartão de débito) na Grécia têm de ser pré-autorizados através do sistema myDATA.

Para mais informações, consulte os seguintes artigos:

Resultado

Uma chamada bem-sucedida ao ponto de extremidade (200)

regista o pagamento com cartão no myDATA e
retorna a
- assinatura e
- o ID da transação.

Nota: Os dados da solicitação e da resposta devem ser integrados na payload do documento (POST /api/v1/transactions/storeDocument) da transação correspondente, no elemento «cardData». Para mais informações, consulte: Fluxo do processo: pagamento com cartão de crédito grego.

Utilização

sempre antes de efetuar um novo pagamento com cartão.

Pré-requisitos

Fiscal client for Greece initialised
Terminal de pagamento compatível ligado ao sistema POS

Parâmetro

clientId — o ID do cliente fiscal correspondente

Request body

Os detalhes do pagamento devem ser especificados no Request body.

Exemplo:

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

Elementos:

Elemento	Tipo	Descrição
PaymentDate	M	Data e hora do pagamento. Nota: Por favor, respeite as orientações relativas às entradas de hora no RetailForce system!
DocumentGuid	M	Identificação única do documento através de UUID/GUID. Atenção: Este valor deve corresponder ao DocumentGuid do documento ao qual o pagamento está associado! Também utilizado como ligação para recibos digitais.
documentType	M	Especifique o tipo de documento – deve corresponder ao tipo de documento do documento em questão.
DocumentNumber	M	Número único e sequencial do documento (= «número do documento»), atribuído pelo sistema de caixa registadora. Atenção: Este número deve corresponder ao número do documento ao qual o pagamento está associado!
NetValue	M	Total líquido do pagamento — sem Vat.
TaxValue	M	Montante do Vat do pagamento
GrossValue	M	Montante bruto do pagamento – incluindo Vat
PaymentValue	M	montante do pagamento
terminalId	M	montante do pagamento

Resposta

Se a chamada for bem-sucedida, é devolvido o seguinte corpo de resposta.