Questa guida fornisce le specifiche di rete necessarie e i passaggi per configurare i tuoi terminali e le applicazioni POS affinché comunichino in modo sicuro con i servizi Market Pay.
1. Regole di whitelisting del firewall
Per garantire una comunicazione sicura, è necessario configurare il firewall per consentire il traffico HTTPS in uscita dalle applicazioni POS e dai terminali verso i seguenti servizi.
NTMS (Nexo Terminal Management System): Gestisce tutte le impostazioni del terminale e gli aggiornamenti delle applicazioni.
| Ambiente | Hostname | Indirizzi IP | Porte TCP |
| Preproduzione | tntms.novelpay.pl | 135.125.51.112 | 443, 8453, 4747, e 14747 |
| Produzione | ntms.novelpay.pl | 176.119.39.127 |
MPG (Market Pay Gateway): Elabora e instrada tutte le transazioni.
| Ambiente | Hostname | Indirizzi IP | Porte TCP |
| Preproduzione | preprod.mpg.market-pay.com | 185.203.232.51 e 185.203.233.51 | 50456 e 50460 |
| Produzione | prod.mpg.market-pay.com | 185.203.232.52 e 185.203.233.52 |
RKI (Remote Key Injection): Consente l'iniezione remota delle chiavi per la crittografia.
| Ambiente | Hostname | Indirizzi IP | Porte TCP |
| Produzione | rki.paxitalia.com | 93.62.136.11 | 35419 |
⚠️ Attenzione: non inserire manualmente gli indirizzi IP di Market Pay, poiché potrebbero cambiare nel tempo
2. Configurazione dell'indirizzo IP del terminale
Per inviare i pagamenti per l'autorizzazione online, il terminale deve avere un indirizzo IP valido.
Metodi per l'assegnazione dell'IP
IP dinamico: Il tuo server DHCP assegna un indirizzo IP al terminale in tempo reale.
Prenotazione DHCP: Sul server DHCP, si associa un indirizzo IP specifico all'indirizzo MAC del terminale. Il server DHCP assegnerà quindi sempre lo stesso indirizzo IP ogni volta. Questa è un'alternativa all'utilizzo degli indirizzi IP statici, soprattutto con un gran numero di terminali.
IP statico: Si inserisce manualmente l'indirizzo IP e gli altri dettagli di configurazione di rete sul terminale.
Importante: Non è possibile utilizzare una combinazione di IP dinamici e statici. Gli indirizzi IP del terminale, del server DNS e del router devono essere tutti dinamici oppure tutti statici. Per impostazione predefinita, il DHCP è abilitato sul terminale di pagamento.
Raccomandazioni
Durata del lease DHCP: Se possibile, imposta la durata del lease DHCP sul tuo server DHCP a 24 ore o più.
Comunicazioni cloud: Usa indirizzi IP dinamici senza prenotazione DHCP.
Comunicazioni locali: Usa la prenotazione DHCP oppure configura manualmente indirizzi IP statici.
Definire un indirizzo IP statico nel terminale
Se utilizzi un'integrazione local communications e non puoi utilizzare la prenotazione DHCP, devi disabilitare il DHCP e definire un indirizzo IP statico.
Sul terminale collegato, apri NTMS Agent.
Seleziona Impostazioni ed inserisci il codice di accesso Admin & Settings.
Inserisci i dettagli della tua rete:
Indirizzo IP del terminale (deve essere univoco nella rete)
Subnet mask della rete
Indirizzo IP del router
Indirizzi IP del server DNS preferito (DNS1) e del server DNS alternativo (DNS2)
Seleziona Salva per confermare.
Interfaccia locale dedicata (USB/RNDIS)
Oltre alla configurazione standard di comunicazione LAN, il tuo terminale di pagamento espone un'interfaccia di rete dedicata tramite USB per le comunicazioni locali. Questa interfaccia utilizza un indirizzo IP e una porta privati e fissi che possono essere utilizzati per la comunicazione tra POS e POI tramite USB. Il terminale richiederà una connessione diretta a internet tramite cavo ethernet (RJ45).
Indirizzo IP: 192.168.42.129
Porta:
Per modalità integrata (con launcher): 7778
Per modalità mista (applicazione di pagamento direttamente): 7777
Il launcher blocca l'accesso al menu Android, alle impostazioni e all'applicazione di pagamento per il cliente; questi sono i casi d'uso comuni per POI installati in supermercati o su dispositivi Self Check-Out. L'uso è limitato alle operazioni provenienti dal POS.
Gestione della perdita di connettività Internet
Quando una transazione viene rifiutata a causa di un problema di connessione di rete, hai due modi principali per continuare a elaborare le transazioni quando la tua connessione Internet principale non è disponibile:
Connessione di failover cellulare: Le transazioni vengono elaborate utilizzando la connessione cellulare del terminale di pagamento 4G (se la SIM è attivata) o un router cellulare quando la connessione Internet principale non funziona.
Abilitare le transazioni offline: Questo ti consente di continuare a elaborare le transazioni quando il negozio non ha connessione Internet. Contatta il tuo Account Manager per abilitare questa funzione.
Disponibilità: I pagamenti offline sono disponibili solo per integrazioni che utilizzano comunicazioni locali o app to app.
Rischio: Sei pienamente responsabile del rischio di acquisizioni non riuscite, chargeback e controversie relative ai pagamenti offline.