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

Ce point de terminaison est nécessaire pour traiter les paiements par carte en Grèce.

Les paiements par carte (carte de crédit, carte de débit) en Grèce doivent être préalablement validés via le système myDATA.

Pour plus d’informations, veuillez vous reporter aux articles suivants :

Résultat

Un appel réussi vers le point de terminaison (200)

enregistre le paiement par carte dans myDATA et
renvoie la
- signature et
- l’ID de la transaction.

Remarque : les données issues de la requête et de la réponse doivent être intégrées dans le payload du document (POST /api/v1/transactions/storeDocument) de la transaction correspondante, dans l’élément « cardData ». Pour plus d’informations, consultez : Déroulement du processus : paiement par carte bancaire grecque.

Utilisation

à chaque fois qu’un nouveau paiement par carte doit être effectué.

Prérequis

Client fiscal pour la Grèce initialisé
Terminal de paiement pris en charge connecté au système de point de vente

Paramètre

clientId : l’ID du client fiscal correspondant

Corps de la requête

Les détails du paiement doivent être précisés dans le Request body.

Exemple :

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

Éléments :

Élément	Type	Description
PaymentDate	M	Date et heure du paiement. Remarque : veuillez respecter les consignes relatives à la saisie des heures dans le RetailForce system !
DocumentGuid	M	Identifiant unique du document à l'aide d'un UUID/GUID. Attention : celui-ci doit correspondre au DocumentGuid du document auquel le paiement est lié ! Il sert également de lien vers les reçus numériques.
documentType	M	Indiquez le type de document – il doit correspondre au type de document du document concerné.
DocumentNumber	M	Numéro unique et séquentiel du document (= « numéro de document »), attribué par le système de caisse. Attention : ce numéro doit correspondre au numéro du document auquel le paiement est lié.
NetValue	M	Montant net du paiement – hors Vat.
TaxValue	M	Montant de la TVA afférente au paiement
GrossValue	M	Montant brut du paiement – TVA comprise
Montant du paiement	M	montant du paiement
terminalId	M	montant du paiement

Réponse

En cas de succès, le corps de réponse suivant est renvoyé.