Specifiche di utilizzo del servizio
I servizi esposti dal Gateway di pagamento ecommerce supportano il protocollo HTTP con cifratura del canale e utilizzano il formato NVP per la richiesta e il formato XML per la risposta.
Di seguito i dettagli tecnici per l'invocazione ai servizi:
Specifiche di chiamata
| Protocollo | HTTPS |
| Metodo | POST |
| Content-Type | application/x-www-form-urlencoded |
| Url di produzione | https://xpay.nexigroup.com/monetaweb/payment/2/xml |
| Url di test | https://stg-ta.nexigroup.com/monetaweb/payment/2/xml |
Raccomandiamo di evitare chiamate dirette e/o l'inserimento degli indirizzi IP di risoluzione DNS degli endpoint nelle liste di autorizzazione del firewall. Tuttavia, nel caso in cui siano state configurate whitelist, aggiornarle con i seguenti indirizzi di produzione:
- 185.198.117.102
- 185.198.118.102
L’unico protocollo supportato è TLSv1.2. Di seguito i cipher:
- TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
- TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
- TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
L’encoding utilizzato per i singoli caratteri deve essere ISO 8859-1.
Di seguito il dettaglio del certificato installato in ambiente di test e produzione:
| CERTIFICATO DI ROOT | GlobalSign Root R3 |
| Numero di serie | 04:00:00:00:00:01:21:58:53:08:A2 |
| La CA intermedia è | GlobalSign RSA Organization Validation CA - 2018 |
| Numero di serie | 01:EE:5F:22:1D:FC:62:3B:D4:33:3A:85:57 |
Qualora fosse necessario scaricare i certificati, consultare le pagine web della Certification Authority (CA):
- https://support.globalsign.com/ca-certificates/root-certificates/globalsign-root-certificates
- https://support.globalsign.com/ca-certificates/intermediate-certificates/organizationssl-intermediate-certificates
Specifiche di risposta
Le risposte alle chiamate ai servizi sincroni utilizzano il formato XML.
All'interno del paragrafo di ogni protocollo di pagamento, sono riportati degli esempi con il tracciato corretto.
Specifiche di notifica
Le notifiche di pagamento per servizi asincroni potranno essere effettuate solo su porte 443 o 8443.
Di seguito gli indirizzi IP del Gateway da cui vengono inviate le notifiche:
| Dominio | Indirizzi IP |
|---|---|
| stg-ta.nexigroup.com |
|
| xpay.nexigroup.com |
|