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.
Avant de commencer à construire une intégration de point de vente (POS), vous devez choisir une architecture d'intégration. Celle-ci détermine comment votre intégration interagit avec notre terminal (POI).
Nous proposons trois architectures d'intégration pour notre Terminal API :
API Locale : le système de caisse communique directement avec le terminal de paiement via votre réseau local.
API Cloud : le système de caisse communique avec le terminal de paiement via Internet.
App-to-App : l'application POS Android communique avec l'application de paiement installée sur le même terminal (POI).
1. Tableau comparatif
| Integration type | Local API | Cloud API | App-to-App | |
|---|---|---|---|---|
| Communication | HTTP | TCP/IP | HTTP | IPC |
| Cas d'utilisation | Intégrations locales simples, stations fixes, fiabilité maximale | Communication en temps réel, persistante et à faible latence | Cloud POS, intégrations de production sécurisées, communication REST/JSON | When Android POS apps runs on the same device as the payment app |
| Avantages | Très facile à utiliser, largement supporté | Connexion rapide, bidirectionnelle et persistante | Facile à utiliser, sécurisé (TLS) | Fastest, secure, no network required |
| Inconvénients | Plus complexe (gestion des sockets) | Gestion des certificats et des Webhooks requise | Android app required | |
| Ease of Implementation | ★★★★☆ | ★★☆☆☆ | ★★★☆☆ | ★★★☆☆ |
2. API Locale
Avec une intégration Terminal API locale, votre système de caisse communique directement avec le terminal via votre réseau local. Pour effectuer un paiement, vous envoyez une requête API directement à l'adresse IP du terminal pour que le client puisse finaliser la transaction.
3. API Cloud
Avec une intégration Terminal API utilisant notre API Cloud, votre système de caisse communique avec le terminal via Internet. Pour effectuer un paiement, vous envoyez une requête API à la passerelle (Gateway) Market Pay. Cette requête est ensuite transmise au terminal pour que le client puisse finaliser la transaction.
4. App-to-App
Avec une intégration App-to-App, votre application POS communique directement avec une application de paiement dédiée installée sur le même terminal. Pour effectuer un paiement, votre application POS lance l'application de paiement avec les détails spécifiques de la transaction. L'utilisateur finalise la transaction au sein de l'application de paiement, qui renvoie ensuite le résultat de manière sécurisée à votre application POS, permettant ainsi de clôturer la vente.