Cloud API integration

Ce contenu a été traduit par une intelligence artificielle. Si vous repérez une erreur, merci de nous le signaler pour nous aider à améliorer notre support. En cas de doute, la version originale en anglais fait foi.

Avec une intégration cloud, votre logiciel de caisse et le terminal de paiement communiquent via Internet – aucun câble physique ou connexion locale n'est nécessaire.

Fonctionnement (vue d'ensemble) :

1. Le logiciel de caisse envoie une demande de paiement à la plateforme Market Pay.

2. La plateforme Market Pay transmet cette demande au terminal de paiement.

3. Le terminal gère l'interaction avec le client et traite le paiement.

4. Le résultat est renvoyé via la plateforme.

5. Votre logiciel de caisse reçoit le statut final de la transaction.

Cette approche rend l'installation plus simple, plus flexible et plus facile à déployer sur plusieurs appareils.

Mise en place d'une communication sécurisée

Avant que votre caisse ne puisse échanger des messages avec le terminal de paiement, un certificat sécurisé doit être mis en place :

1. Vous créez une demande de signature de certificat (CSR) et l'envoyez à Market Pay (à votre chargé d'implémentation).

2. L'équipe AppOps de Market Pay émet le certificat et vous le renvoie.

3. Vous installez le certificat sur votre système.

👉 Lire le guide étape par étape pour la configuration du certificat

Configurez votre réseau

Assurez-vous que votre réseau et votre pare-feu autorisent le trafic HTTPS sortant vers les services Market Pay et les points de terminaison partenaires. Ajoutez les adresses IP et les ports TCP ci-dessous à votre liste blanche afin que les applications POS et les terminaux puissent atteindre les services nécessaires.

• NTMS – Système de gestion des terminaux : Gestion des paramètres et des mises à jour.

• MPG – Passerelle Market Pay : Traitement et acheminement de toutes les transactions.

• RKI – Injection de clés à distance : Gestion à distance des clés de chiffrement.

👉 Consulter la liste complète des exigences de configuration réseau

Communication POS ↔ Terminal

Votre caisse communique avec le terminal via les points de terminaison (endpoints) API suivants :

Vous trouverez les spécifications détaillées ici: api-hub.market-pay.com

1. POST /process-transaction

• Rôle : Lance un nouveau paiement et affiche l'écran de paiement sur le terminal.

• Fonctionnement : Les mises à jour de statut (carte insérée, code PIN saisi, paiement autorisé) sont envoyées à l'URL de notification que vous avez configurée.

• Quand l'utiliser : Chaque fois qu'un caissier initie un paiement.

  👉 Voir la doc détaillée pour /process-transaction

2. GET /last-transaction

• Rôle : Récupère le résultat de la transaction la plus récente.

• Fonctionnement : Aide à récupérer les résultats si la caisse a perdu la connexion. Vérifiez toujours le transactionId pour vous assurer qu'il correspond à la bonne requête.

• Quand l'utiliser : Si votre caisse n'a pas reçu de résultat et que vous devez confirmer ce qui s'est passé.

  👉 Voir la doc détaillée pour /last-transaction

3. POST /cancel-transaction/{terminal-id}

• Rôle : Annule un paiement réussi précédemment en effectuant une extourne (reversal).

• Fonctionnement : Le terminal envoie une demande d'extourne à l'acquéreur. Les mises à jour de statut (initié, en cours, terminé) sont envoyées à votre URL de notification.

• Quand l'utiliser : Lorsqu'un paiement a été effectué par erreur ou doit être annulé avant la télécollecte (settlement).

  👉 Voir la doc détaillée pour /cancel-transaction

4. POST /update-terminal

• Rôle : Demande au terminal de mettre à jour son logiciel ou sa configuration.

• Quand l'utiliser : Lors des déploiements, de la maintenance ou avant l'introduction de nouvelles fonctionnalités.

  👉 Voir la doc détaillée pour /update-terminal

5. POST /abort-transaction

• Rôle : Annule une transaction en cours.

• Fonctionnement : Si la demande arrive tôt, la transaction est arrêtée. S'il est trop tard, le terminal peut quand même la finaliser ; dans ce cas, le POS doit envoyer un remboursement (Refund).

• Quand l'utiliser : Si un client ou un caissier décide d'annuler avant la fin du processus.

  👉 Voir la doc détaillée pour /abort-transaction

6. GET /terminals

• Rôle : Liste tous les terminaux connectés pour un code magasin donné.

• Fonctionnement : Renvoie une réponse vide si aucune session n'est active.

• Quand l'utiliser : Au démarrage de la caisse, pour vérifier quels terminaux sont disponibles.

  👉 Voir la doc détaillée pour /get-terminals

7. Comment générer votre CSR (Certificate Signing Request)

Pour obtenir votre certificat, vous devez générer un CSR et une clé privée à l'aide d'OpenSSL.

1. Générer le CSR et la clé privée

Utilisez la commande suivante selon votre environnement :

Pour la pré-production :

openssl req -nodes -newkey rsa:2048 -keyout POS_NomMarchand_PREPROD_PRIVATEKEY.key -out POS_NomMarchand_PREPROD_CSR.csr

Pour la production :

openssl req -nodes -newkey rsa:2048 -keyout POS_NomMarchand_PROD_PRIVATEKEY.key -out POS_NomMarchand_PROD_CSR.csr

Remplacez NomMarchand par votre identifiant marchand réel (ex: POS_MonMagasin_PREPROD_PRIVATEKEY.key).

2. Remplir les informations requises

Lorsque la commande OpenSSL vous le demande, remplissez les champs suivants :

⚠️ Important : Veuillez vous assurer que le champ Organizational Unit (OU) indique clairement l'utilisation du certificat — cette information est obligatoire. Les autres champs peuvent rester vides.

3. Envoyer le fichier CSR

Une fois le CSR généré, envoyez le fichier .csr à votre contact Market Pay.

N'envoyez jamais le fichier .key — conservez-le précieusement et en toute sécurité.

4. Optionnel (Tests uniquement)

Vous pouvez également générer un CSR via un outil en ligne (non recommandé pour la production) :

👉 Générateur de CSR et de clé en ligne – SSL.com