Prima di iniziare a creare un'integrazione point-of-sale (POS), è necessario scegliere un'architettura di integrazione. Questo determina come la tua integrazione interagisce con il nostro POI.
Offriamo tre architetture di integrazione per la nostra Terminal API:
- Local API: il sistema POS comunica direttamente con il terminale di pagamento tramite la tua rete locale.
- Cloud API: il sistema POS comunica con il terminale di pagamento tramite internet.
- App to App: l'applicazione POS Android comunica con l'applicazione di pagamento installata sullo stesso POI.
1. Tabella di confronto
| Tipo di integrazione | Local API | Cloud API | App-to-App | |
|---|---|---|---|---|
| Comunicazione | HTTP | TCP/IP | HTTP | IPC |
| Casi d'uso | Integrazioni locali semplici, postazioni fisse, massima affidabilità | Comunicazione in tempo reale, persistente, a bassa latenza | Cloud POS, integrazioni di produzione sicure, comunicazione REST/JSON | Quando le app POS Android vengono eseguite sullo stesso dispositivo dell'app di pagamento |
| Pro | Molto facile da usare, ampiamente supportata | Connessione veloce, bidirezionale e persistente | facile da usare, Sicura (TLS) | La più veloce, sicura, non richiede rete |
| Contro | Più complessa (gestione socket) | Gestione di certificati e webhook richiesta | Richiede app Android | |
| Facilità di implementazione | ★★★★☆ | ★★☆☆☆ | ★★★☆☆ | ★★★☆☆ |
2. Local API
Con un'integrazione Terminal API locale, il tuo sistema POS comunica direttamente con il terminale tramite la rete locale. Per effettuare un pagamento, effettui una richiesta API direttamente all'indirizzo IP del terminale, affinché l'acquirente completi la transazione.
3. Cloud API
Con un'integrazione Terminal API utilizzando la nostra Cloud API, il tuo sistema POS comunica con il terminale tramite internet. Per effettuare un pagamento, effettui una richiesta API a Market Pay Gateway. Questa richiesta viene inoltrata al terminale, affinché l'acquirente completi la transazione.
4. App to App
Con un'integrazione App-to-App, la tua applicazione POS comunica direttamente con un'applicazione di pagamento dedicata installata sullo stesso POI. Per effettuare un pagamento, la tua app POS avvia l'app di pagamento con i dettagli specifici della transazione. L'utente completa la transazione all'interno dell'app di pagamento, che poi trasmette in modo sicuro il risultato alla tua app POS, permettendo il completamento della vendita.