3-D Secure V2 parameters
Introduzione
Questo elenco contiene tutti i parametri 3-D Secure V2 rilevanti. È suddiviso in tre sezioni:
1. Parametri obbligatori
Se si utilizza la nostra pagina di pagamento Nexi Payengine Hosted Payment Page, cattureremo questi parametri per voi. Se si utilizza DirectLink, è necessario aggiungere questi parametri manualmente alla richiesta.
Parametri |
Nome / Descrizione |
Formato |
---|---|---|
browserAcceptHeader |
Il browser accetta intestazioni. Il contenuto esatto dell’HTTP accetta intestazioni come inviate al commerciante dal browser del titolare di carta di credito. |
Lunghezza: Variabile, massimo 2.048
|
browserColorDepth |
Profondità colore schermo browser. |
Tipo dati: Stringa
|
browserJavaEnabled |
Browser con abilitazione Java. Booleano che rappresenta la capacità del browser del titolare di carta di credito di eseguire Java. Il valore è restituito dalla proprietà di abilitazione Java del navigatore. |
Tipo dati: Booleano |
browserLanguage |
Lingua del browser. Valore che rappresenta la lingua del browser, come definita nel codice IETF BCP47. Restituito dalla proprietà della lingua del navigatore. (Esempio: en, fr, en-US, fr-ca) Non è case sensitive. |
Lunghezza: Variabile, 1-8 caratteri xx, xxx, xx-XX o xx-xxxx-xx. |
browserScreenHeight |
Altezza dello schermo del browser. Altezza totale dello schermo del titolare di carta di credito in pixel. Il valore è restituito dalla proprietà dell’altezza dello schermo. |
Tipo dati: Int |
browserScreenWidth |
Larghezza dello schermo del browser. Larghezza totale dello schermo del titolare di carta di credito in pixel. Il valore è restituito dalla proprietà |
Tipo dati: Int |
browserTimeZone |
Fuso orario del browser Differenza oraria tra l’orario UTC e |
Tipo dati: Int Tra -840 e 720 |
browserUserAgent |
User-agent del browser. Contenuto esatto dell’intestazione |
Lunghezza: Variabile, massimo 2.048
|
ACCEPTURL |
URL della pagina Web da mostrare al cliente quando il pagamento è stato autorizzato (o è in attesa di autorizzazione). |
AN Massimo 200 caratteri |
DECLINEURL |
URL al quale viene reindirizzato il cliente al raggiungimento del numero massimo di tentativi di autorizzazione falliti (10 per impostazione predefinita, sebbene il valore possa essere modificato nella pagina Technical Information, nella sezione "Payment retry" della scheda "Global transaction parameters"). |
AN Massimo 200 caratteri |
EXCEPTIONURL |
URL della pagina Web da mostrare al cliente se il risultato del pagamento è incerto. |
AN Massimo 200 caratteri |
LANGUAGE |
Lingue della pagina di pagamento attualmente disponibili per il compratore (titolare della carta di credito / titolare del conto). La lingua predefinita utilizzata se non è selezionato alcun valore lingua oppure una lingua non valida è: |
AN Il formato è "Lingua_Paese". Massimo 5 caratteri |
FLAG3D |
Valore fisso: ‘Y’ Indica il nostro sistema come eseguire un'identificazione 3-D Secure, se necessario. |
AN Massimo 1 caratteri |
CN |
Nome del titolare di carta di credito (cliente) |
Lunghezza: Variabile, massimo 35 |
Mpi.carteBancaire.Usecase |
Obbligatorio per Carte Bancaire Per tutte le modalità di integrazione Tipo di pagamento per il quale è richiesta l’autenticazione |
Lunghezza: 2 caratteri
|
REMOTE_ADDR |
Obbligatorio per Carte Bancaire Per richieste DirectLink browserIP. Indirizzo IP del cliente (solo per il modulo di |
212.23.45.96 |
If you process transactions for Visa, make sure to add the following mandatory parameters as well:
For all integration modes:
Mpi.WorkPhone.countryCode + Mpi.WorkPhone.subscriber
or
Mpi.MobilePhone.countryCode + Mpi.MobilePhone.subscriber
or
Mpi.HomePhone.countryCode + Mpi.HomePhone.subscriber
or
EMAIL
For DirectLink requests:
REMOTE_ADDR
2. Parametri consigliati
I principali schemi di carte di pagamento raccomandano vivamente di includerli, in quanto aumentano la possibilità di un flusso privo di attrito.
Parametri |
Nome / Descrizione | Formato |
---|---|---|
ECOM_BILLTO_POSTAL_CITY |
billAddrCity. Città di fatturazione |
Lunghezza: Variabile, massimo 25 |
ECOM_BILLTO_POSTAL_COUNTRYCODE |
billAddrCountry. Codice nazionale di fatturazione |
Lunghezza massima 2 |
ECOM_BILLTO_POSTAL_STREET_LINE1 |
billAddrLine1. Indirizzo di fatturazione, prima riga |
Lunghezza: Variabile, massimo 60 |
ECOM_BILLTO_POSTAL_STREET_LINE2 |
billAddrLine2. Indirizzo di fatturazione, seconda riga |
Lunghezza: Variabile, massimo 60 |
ECOM_BILLTO_POSTAL_POSTALCODE |
billAddrPostCode. Codice postale di fatturazione |
Lunghezza: Variabile, massimo 10 |
email. Indirizzo email del cliente. |
Lunghezza: Variabile, massimo 50 |
3. Parametri opzionali
Inoltre, è possibile inviare da questi tutti i parametri che si desidera. Più parametri si inviano, maggiore è la possibilità di un flusso privo di attrito.
Parametri |
Nome / Descrizione |
Formato |
---|---|---|
Mpi.threeDSRequestorChallengeIndicator |
Utilizzare questo parametro per richiedere l'esenzione di 3DS.
Indicatore verifica commerciante. Indica se una verifica è richiesta per questa transazione. Ad esempio:
|
Lunghezza: 2 caratteri
|
Mpi.merchantFraudRate |
Tasso di frode commerciale Tasso di frode commerciale nel SEE (tutte le frodi relative alle carte SEE divise per tutti i volumi delle carte SEE) calcolato secondo Standard tecnici normativi (RTS) PSD2. Assicurati di calcolare il tasso in base al regolamento dell’articolo 19 RTS PSD2, in quanto né MasterCard né noi convalideremo il punteggio. |
Lunghezza: massimo 2 caratteri
|
Mpi.secureCorporatePayment |
Pagamento aziendale sicuro Indica che sono stati utilizzati processi e procedure di pagamento dedicati e che si applica la potenziale esenzione di pagamento aziendale sicuro. |
Lunghezza: massimo 1 carattere
|
Mpi.cardholderAccountChangeIndicator |
Indicatore modifica account del titolare di carta di credito* Tempo trascorso dall’ultima modifica |
Lunghezza: 2 caratteri
|
Mpi.cardholderAccountDate |
Data account del titolare di carta di credito* Data in cui il titolare di carta di credito ha aperto l’account presso il commerciante. |
Lunghezza: 8 caratteri Tipo dati: Data Formato accettato: Formato data = AAAAMMGG |
Mpi.cardholderAccountPasswordChange |
Modifica password dell’account del titolare di carta di credito* Data in cui l’account del titolare di |
Lunghezza: 8 caratteri Tipo dati: Stringa Formato accettato: Formato data = AAAAMMGG |
Mpi.cardholderAccountPasswordChangeIndicator |
Indicatore modifica password dell’account del titolare di carta di credito* Indica il tempo trascorso dall’ultima |
Lunghezza: 2 caratteri
|
Mpi.numberOfPurchaseWithAccountInTheLastSixMonths |
Conteggio acquisti dell’account del titolare di carta di credito* Numero di acquisti effettuati con |
Tipo dati: Int Tra 0 e 999 |
Mpi.paymentAccountAge |
Età account di pagamento* Data in cui l’account di pagamento è |
Lunghezza: 8 caratteri Tipo dati: Data Formato accettato: Formato data = AAAAMMGG |
Mpi.paymentAccountAgeIndicator |
Indicatore età account di pagamento* Indica il periodo di tempo dalla |
Lunghezza: 2 caratteri
|
Mpi.provisionAttemptsInTheLast24Hours |
Numero di tentativi di provisioning giornalieri. Numero di tentativi di aggiunta carta |
Tipo dati: Int Tra 0 e 999 |
Mpi.shippingAddressUsage |
Utilizzo indirizzo di spedizione. Data in cui l’indirizzo di spedizione |
Lunghezza: 8 caratteri Tipo dati: Data Formato accettato: Formato data = AAAAMMGG |
Mpi.shippingAddressWasFirstUsed |
Indicatore utilizzo indirizzo di spedizione. Indica quando l’indirizzo di spedizione usato per questa transazione è stato usato per la prima volta presso il commerciante. |
Lunghezza: 2 caratteri
|
Mpi.shippingNameAndCardholderNameAreIdentical |
Indicatore nome di spedizione. Indica se il nome del titolare di carta |
Tipo dati: Booleano Valori accettati:
|
Mpi.suspiciousAccountActivityDetected |
Attività account sospetta. Indica se il commerciante ha riscontrato attività sospette (incluse |
Tipo dati: Booleano |
Mpi.transactionActivityInTheLast24Hours |
Numero di transazioni giornaliere. Numero di transazioni (completate e |
Tipo dati: Int Tra 0 e 999 |
Mpi.transactionActivityLastYear |
Numero di transazioni annuali. Numero di transazioni (completate e interrotte) per questo account del |
Tipo dati: Int Tra 0 e 999 |
Mpi.challengeWindowSize |
Dimensione finestra di richiesta. Dimensioni della finestra di richiesta |
Lunghezza: 2 caratteri
Se non si invia questo parametro, il valore predefinito è 05 = Full screen |
Mpi.HomePhone.countryCode |
Prefisso nazionale telefono fisso. Prefisso nazionale di un telefono fisso |
Tipo dati: Stringa Lunghezza: 3 caratteri ITU-E.164 country code |
Mpi.HomePhone.subscriber |
Telefono fisso. Telefono fisso (senza prefisso |
Tipo dati: Stringa Lunghezza: 0 e 15 |
Mpi.deliveryEmailAddress |
Indirizzo email di consegna. Per la consegna elettronica, l’indirizzo email a cui è stata inviata la merce. |
Lunghezza: massimo 254 caratteri Tipo dati: Stringa |
Mpi.deliveryTimeframe |
Tempo di consegna. Indica il tempo di consegna della merce. |
Lunghezza: 2 caratteri
|
Mpi.giftCardAmount |
Importo buono regalo. Per gli acquisti con carte prepagate o |
Lunghezza: massimo 15 caratteri Tipo dati: Int Tra 0 e 999999999999999 |
Mpi.giftCardCount |
Totale buoni regalo. Per carte prepagate o buoni regalo, |
Tipo dati: Int Tra 0 e 99 |
Mpi.giftCardCurrency |
Valuta buono regalo. Per l’acquisto con carte prepagate o |
Lunghezza: 3 caratteri Tipo dati: Stringa |
Mpi.preOrderDate |
Data di preordine. Per un acquisto preordinato, la data |
Lunghezza: 8 caratteri Tipo dati: Data Formato accettato: Formato data = AAAAMMGG |
Mpi.cardholderAccountAgeIndicator |
Indicatore età account del titolare di carta di credito* Tempo trascorso dalla creazione |
Lunghezza: 2 caratteri
|
Mpi.cardholderAccountChange |
Modifica account del titolare di carta Data in cui è stata effettuata l’ultima |
Lunghezza: 8 caratteri Tipo dati: Data Formato accettato: Formato data = AAAAMMGG |
Mpi.preOrderPurchaseIndicator |
Indicatore di preordine. Indica se il titolare della carta di |
Lunghezza: 2 caratteri Tipo dati: Stringa Valori accettati: • 01 = Merce disponibile • 02 = Disponibilità futura |
Mpi.reorderItemsIndicator |
Indicatore articoli di riordine. Indica se il titolare di carta di credito |
Lunghezza: 2 caratteri Tipo dati: Stringa Valori accettati: • 01 = Ordinato per la prima volta • 02 = Riordinato |
Mpi.shippingIndicator |
Indicatore di spedizione. Indica la modalità di spedizione |
Lunghezza: 2 caratteri
|
Mpi.MobilePhone.countryCode |
Prefisso nazionale telefono cellulare. Prefisso nazionale di un telefono |
Tipo dati: Stringa Lunghezza: 3 caratteri ITU-E.164 country code |
Mpi.MobilePhone.subscriber |
Telefono cellulare. Telefono cellulare (senza prefisso |
Tipo dati: Stringa Lunghezza: 0 e 15 |
Mpi.threeDSRequestorAuthenticationData |
Dati autenticazione commerciante. Dati che documentano e supportano Per esempio, per il metodo: |
Lunghezza: massimo 2.048 byte Tipo dati: Stringa Valore accettato: Qualsiasi |
Mpi.threeDSRequestorAuthenticationMethod |
Metodo autenticazione commerciante. Meccanismo utilizzato dal titolare |
Lunghezza: 2 caratteri
|
Mpi.threeDSRequestorAuthenticationTimestamp |
Marca temporale autenticazione commerciante. Data e ora in formato UTC |
Lunghezza: 14 caratteri Tipo dati: Data - Tempo Formato accettato: Formato data = AAAAMMGGHHMMSS |
Mpi.threeDSRequestorPriorAuthenticationData |
Dati autenticazione transazione precedente del commerciante. Dati che documentano e supportano |
Lunghezza: massimo 2.048 byte Formato: Qualsiasi |
Mpi.threeDSRequestorPriorAuthenticationMethod |
Metodo autenticazione transazione Meccanismo utilizzato dal titolare |
Lunghezza: 2 caratteri
|
Mpi.threeDSRequestorPriorAuthenticationTimestamp |
Marca temporale autenticazione Data e ora in formato UTC |
Lunghezza: 14 caratteri Tipo dati: Data - Tempo Formato accettato: Formato data = AAAAMMGGHHMMSS |
Mpi.threeDSRequestorPriorReference |
Riferimento transazione precedente del commerciante. Questo elemento dati fornisce |
Lunghezza: 36 caratteri Tipo dati: Stringa Valore accettato: Questo elemento dati contiene un ID di transazione ACS per una transazione autenticata precedentemente (per esempio, la prima transazione ricorrente autenticata con il titolare della carta di credito). |
Mpi.transactionType |
Tipo transazione. Identifica il tipo di transazione in |
Lunghezza: 2 caratteri
• 01 = Acquisto di beni o servizi |
Mpi.WorkPhone.countryCode |
Prefisso nazionale telefono aziendale. Prefisso nazionale di un telefono |
Tipo dati: Stringa Lunghezza: 3 caratteri ITU-E.164 country code |
Mpi.WorkPhone.subscriber |
Telefono aziendale. Telefono utilizzato ai fini lavorativi |
Tipo dati: Stringa Lunghezza: 0 e 15 |
TP | Per modificare il layout della pagina "order_A3DS", è possibile inviare un URL/nome di modello con questo parametro. (vedere e-Commerce: Modello dinamico). | N/A |
WIN3DS | Un modo per mostrare al cliente la pagina di identificazione. Valori possibili:
|
AN Massimo 6 caratteri |
ADDRMATCH |
addrMatch. Indica se l’indirizzo di fatturazione e l’indirizzo 1 = sì |
Lunghezza: 1 carattere Valori accettati: · 1 = sì · 0 = no |
TRXDATE |
purchaseDate. Data della transazione. |
MM/GG/AA |
ECOM_SHIPTO_POSTAL_CITY |
shipAddrCity. Città di spedizione |
Lunghezza: Variabile, massimo 40 |
ECOM_SHIPTO_POSTAL_STREET_LINE1 |
shipAddrLine1. Indirizzo di spedizione, prima riga |
Lunghezza: Variabile, massimo 35 |
ECOM_SHIPTO_POSTAL_STREET_LINE2 |
shipAddrLine2. Indirizzo di spedizione, seconda riga |
Lunghezza: Variabile, massimo 35 |
ECOM_SHIPTO_POSTAL_POSTALCODE |
shipAddrPostCode. Codice postale di spedizione |
Lunghezza: Variabile, massimo 10 |
ECOM_SHIPTO_POSTAL_COUNTRYCODE |
shipAddrCountry. Codice nazionale di spedizione |
Lunghezza massima 2 |
Mpi.carteBancaire.AcquirerExemption |
Richiesta di applicazione dell’esenzione RTS Acquirer Transaction Risk Analysis |
Tipo di dati: booleano Valori accettati: true false |
Mpi.carteBancaire.MerchantScore |
Punteggio calcolato per questa transazione |
Tipo di dati: int Valori accettati: punteggio fornito dal commerciante a DS se disponibile, ossia: = any value e.g. "data" : {"value" : "Method 023 : A+"} |
Mpi.carteBancaire.NumberOfItems |
Numero di articoli dell’ordine corrente |
Tipo di dati: int Valori accettati: tra 00 e 99 (99 per articoli >= 99) |
Mpi.carteBancaire.Usecase |
Tipo di pagamento per il quale è richiesta l’autenticazione |
Lunghezza: 2 caratteri
|