Pagamenti Multivaluta

XPay consente agli esercenti eCommerce di esporre i prezzi nella valuta locale del cliente e di accettare pagamenti in 46 valute internazionali. La conversione è interamente gestita dalla piattaforma di pagamento.

Valute supportate

Il servizio supporta 46 valute internazionali. L'accettazione dei pagamenti è disponibile per i circuiti Visa e Mastercard.

• La lista è soggetta ad aggiornamenti periodici. Per verificare la disponibilità in tempo reale il portale Nexi Business o contattare il supporto Nexi.
• Nelle API delle Modalità di integrazione, è possibile cambiare valuta modificando il valore del parametro "currency" presente all'interno dell'oggetto "order".

Modalità di liquidazione

L'accredito avviene in euro per i clienti Nexi, mentre può avvenire nella valuta locale dell'esercente secondo le seguenti regole solo per i clienti di Intesa Sanpaolo:

NOTA: l'accredito nelle valute non-EUR (BGN, HRK, DKK, NOK, PLN, CZK, RON, SEK, HUF) richiede che l'esercente abbia sede legale nel paese corrispondente alla valuta richiesta e può avvenire solo per i clienti Intesa Sanpaolo. Per i clienti Nexi l’accredito è disponibile solo in valuta euro.

API mccExchangeRates

La mccExchangeRates API è lo strumento principale per integrare la gestione dei tassi di cambio direttamente nel backend dell'esercente. Permette di:

• recuperare in tempo reale i tassi di cambio applicati da Nexi per ogni valuta supportata;
• definire listini prezzi personalizzati per valuta, mostrando al cliente il prezzo esatto nella sua valuta locale;
• calcolare l'importo che verrà accreditato in EUR, garantendo precisione nella riconciliazione contabile;
• aggiornare dinamicamente i prezzi sul sito eCommerce ad ogni sessione di checkout.

	{
	  "MERCHANT_AMOUNT": 0.91,
	  "functionCode": "101",
	  "CONVERSION_RATE_DATE": "2026-06-12T12:30:15.998",
	  "transactionTime": "2026-06-12 12:30:15.646",
	  "authorizationStatus": "120",
	  "cardId4": "E5sCJfWY82QJMkKEeb0rA2CIsZ9Hr53sWyyLcDFjEvk=",
	  "cardExpiryDate": "203312",
	  "network_tech": "NA",
	  "maskedPan": "518600******8785",
	  "cardCountry": "USA",
	  "CONVERSION_RATE": 0.911493938,
	  "MERCHANT_CURRENCY": "978",
	  "cardType": "NONE",
	  "OPERATION_AMOUNT": 1.0,
	  "threeDS": "H",
	  "rrn": "616301023091",
	  "originalTraceId": {
	    "extendedData": "A537MA08001-00000260612616301023091110001"
	  },
	  "messageReasonCode": "1779",
	  "transactionType": "CIT_PAY",
	  "trn": "PDV",
	  "omnichannelId": "MA08001-00000260612616301023091110001",
	  "posDataCode": "100050J00100",
	  "installmentQty": "0",
	  "securityType": "3",
	  "cardId": "79f581da9753d3305b2321e44f76cc2c3a40061a242ebbacde682427a2209aea",
	  "OPERATION_CURRENCY": "840",
	  "status": "NOT_APPROVED"
	}
	

NOTA: i tassi di cambio mostrati e restituiti da questa API sono applicabili solo per i clienti Nexi. Per i clienti Intesa Sanpaolo i tassi di cambio applicati su ogni singola transazione vengono restituiti in altre modalità.

Flusso di pagamento

Il flusso standard di un pagamento multicurrency si articola nelle seguenti fasi:

• Non sono supportati i pagamenti multicurrency MIT recurring (MIT, Incremental, No Show, Delayed Charge). Quindi non è possibile supportare scenari di salvataggio carta e/o successive subscription in modalità multicurrency.
• Per i clienti integrati tramite Plug In sarà sufficiente seguire la guida di configurazione del plug in nelle sezioni dedicate per le piattaforme ecommerce. I plug in che supportano il multicurrency sono i seguenti: BigCommerce, WooCommerce, PrestaShop, Magento, OpenCart.

Parametri chiave

Parametri principali da includere nella richiesta di pagamento per abilitare la modalità multicurrency:

NOTA: per le valute prive di decimali (JPY, KRW, BHD, KWD, OMR), passare l'importo come intero senza moltiplicare per 100. Consultare le specifiche della singola valuta nella documentazione API.