Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
In questa sezione vengono forniti suggerimenti e soluzioni per i problemi che possono verificarsi con l'integrazione.
Dipende dall'istituto finanziario che ha emesso la carta di credito al pagante. Ogni issuer della carta definisce il periodo di validità dell'autorizzazione, in cui vengono trattenuti i fondi sul conto del pagante, in attesa dell'arrivo della transazione di acquisizione. In genere si tratta di 5-8 giorni di elaborazione prima che l'autorizzazione venga eliminata dal conto del pagante e al pagante venga nuovamente concesso l'accesso ai fondi.
Per individuare gli errori di validazione, è possibile utilizzare i seguenti campi:
Il campo error.explanation [REST][NVP] conterrà testo di errore in chiaro che fornisce ulteriori dettagli sull'errore, come la lunghezza minima o prevista e così via. Non analizzare queste informazioni, in quanto non è possibile garantire il formato per questo testo.
A differenza di DirectAPI, che restituisce enumerazioni, le integrazioni con Payment Client e Virtual Payment Client restituiscono codici di risposta. Le tabelle riportate di seguito mostrano la mappatura tra i due tipi di risposta restituiti da Mastercard Gateway.
Payment Client/Virtual Payment Client | DirectAPI | ||
---|---|---|---|
Codice di risposta | Descrizione | response.gatewayCode |
Descrizione |
0 | Transazione riuscita | APPROVED |
Transazione approvata |
1 | Non è stato possibile elaborare la transazione | UNSPECIFIED_FAILURE |
Non è stato possibile elaborare la transazione |
2 | Transazione rifiutata - Contattare la banca emittente | DECLINED |
L'operazione richiesta non è andata a buon fine. Ad esempio, un pagamento è stato rifiutato dall'issuer o l'autenticazione del pagante non è stata completata correttamente. |
3 | Transazione rifiutata - Nessuna risposta dalla banca | TIMED_OUT |
Risposta fuori tempo massimo |
4 | Transazione rifiutata - Carta scaduta | EXPIRED_CARD |
Transazione rifiutata per carta scaduta |
5 | Transazione rifiutata - Credito insufficiente | INSUFFICIENT_FUNDS |
Transazione rifiutata per copertura insufficiente |
6 | Transazione rifiutata - Errore di sistema della banca | ACQUIRER_SYSTEM_ERROR | Si è verificato un errore di sistema dell'acquirer durante l'elaborazione della transazione |
7 | Errore di elaborazione del server di pagamento. Generalmente causato da dati di input non validi, come il numero di una carta di credito. Si possono verificare anche errori di elaborazione. | SYSTEM_ERROR |
Si è verificato un errore di sistema interno durante l'elaborazione della transazione |
8 | Transazione rifiutata - Tipo di transazione non supportato | NOT_SUPPORTED |
Tipo di transazione non supportato |
9 | Transazione rifiutata dalla banca (non contattare la banca) | DECLINED_DO_NOT_CONTACT |
Transazione rifiutata - non contattare l'issuer |
A | Transazione interrotta | ABORTED |
Transazione interrotta dal titolare della carta di credito |
B | Transazione bloccata - Restituito quando: -Il livello di sicurezza della verifica ha un valore "07", - L'esercente ha abilitato il blocco 3D Secure, - Il risultato generale della stima del rischio restituisce "Rifiuta" o "Rifiutato dal sistema" |
BLOCKED |
Transazione bloccata a causa delle regole di blocco Rischio o 3D Secure |
C | Transazione annullata | CANCELLED |
Transazione annullata dal titolare della carta di credito |
D | Transazione con pagamento differito | DEFERRED_TRANSACTION_RECEIVED |
Transazione con pagamento differito ricevuta e in attesa di elaborazione |
E | Transazione rifiutata - Fare riferimento all'issuer della carta | REFERRED |
Transazione rifiutata - Fare riferimento all'issuer della carta |
F | Autenticazione 3D Secure non riuscita | AUTHENTICATION_FAILED |
Autenticazione 3D Secure non riuscita |
I | Codice di sicurezza della carta non riuscito | INVALID_CSC |
Codice di sicurezza della carta non valido |
L | Transazione di acquisto bloccata. Indica che sta avendo luogo un'altra transazione che utilizza lo stesso numero di transazione di acquisto. | LOCK_FAILURE |
Ordine bloccato - è in corso un'altra transazione per questo ordine |
M | Transazione inviata (la transazione è stata indirizzata all'acquirer, ma il server di pagamento non l'ha ancora ricevuta per completare la transazione) | SUBMITTED |
Transazione inviata - Non è stata ancora ricevuta la risposta |
N | Titolare della carta di credito non registrato in 3D Secure (solo autenticazione) | NOT_ENROLLED_3D_SECURE |
Titolare della carta di credito non registrato in 3D Secure |
P | La transazione è in sospeso | PENDING |
La transazione è in sospeso |
R | Limite di tentativi superato, transazione non elaborata | EXCEEDED_RETRY_LIMIT |
Superato il limite di tentativi di transazione |
S | Transazione rifiutata - Batch duplicato | DUPLICATE_BATCH |
Transazione rifiutata a causa del batch duplicato |
T | Verifica indirizzo non riuscita | DECLINED_AVS |
Transazione rifiutata per verifica indirizzo |
U | Codice di sicurezza della carta non riuscito | DECLINED_CSC |
Transazione rifiutata a causa del codice di sicurezza della carta |
V | Verifica indirizzo e codice di sicurezza della carta non riusciti | DECLINED_AVS_CSC |
Transazione rifiutata per verifica indirizzo e codice di sicurezza della carta |
W | Transazione rifiutata - Piano di pagamento non supportato. | DECLINED_PAYMENT_PLAN |
Transazione rifiutata per piano di pagamento |
X | Trasferimento fondi in sospeso approvato - Approvato da un sistema di trasferimento fondi batch ma ancora in attesa di ulteriori dettagli dall'acquirer. | APPROVED_PENDING_SETTLEMENT |
Transazione approvata - trasferimento fondi batch in sospeso |
? | Risposta sconosciuta | UNKNOWN |
Risposta sconosciuta |
Payment Client/Virtual Payment Client | DirectAPI | ||
---|---|---|---|
Codice di risposta | Descrizione | response.cardholderVerification.avs.gatewayCode |
Descrizione |
X | Corrispondenza esatta – indirizzo e codice di avviamento postale/CAP a 9 cifre | ADDRESS_ZIP_MATCH |
Corrispondenza tra indirizzo e il codice di avviamento postale/CAP |
Y | Corrispondenza esatta – indirizzo e codice di avviamento postale/CAP a 5 cifre | ||
D | Corrispondenza tra indirizzo e codice postale per la transazione internazionale. | ||
M | Corrispondenza tra indirizzo e codice postale per la transazione internazionale. | ||
F | Indirizzo e codice di avviamento postale corrispondono. Vale solo per il regno Unito. | ||
W | Codice di avviamento postale/CAP a 9 cifre corrispondente, indirizzo non corrispondente | ZIP_MATCH |
CAP/codice postale corrispondente. Indirizzo non corrispondente |
P | Corrispondenza dei codici postali per la transazione internazionale ma mancata verifica dell'indirizzo a causa di formati incompatibili. | ||
Z | Codice di avviamento postale/CAP a 5 cifre corrispondente, indirizzo non corrispondente | ||
A | Corrisponde solo l'indirizzo | ADDRESS_MATCH |
Indirizzo corrispondente |
B | Corrispondenza dell'indirizzo per la transazione internazionale. Mancata verifica del codice postale a causa di formati incompatibili. | ||
S | Servizio attualmente non supportato. | SERVICE_NOT_SUPPORTED |
Servizio attualmente non supportato dall'acquirer o dall'esercente |
G | Transazione internazionale, informazioni sull'indirizzo non disponibili. | NOT_VERIFIED |
Impossibile verificare il servizio di verifica indirizzo per una transazione internazionale |
C | Indirizzo e codice postale non verificati per la transazione internazionale a causa di formati incompatibili. | ||
I | Solo Visa. Informazioni indirizzo non verificate per la transazione internazionale. | ||
R | Il sistema dell'issuer non è disponibile. Riprovare. | SERVICE_NOT_AVAILABLE_RETRY |
Il sistema dell'issuer non è disponibile. È possibile riprovare |
U | Indirizzo non disponibile, nessun dato fornito dall'issuer. | NOT_AVAILABLE |
Nessun dato disponibile dall'issuer o dati AVS non supportati per la transazione |
E | Ordine non pervenuto tramite posta o telefono. | ||
N | Indirizzo e CAP/codice di avviamento postale non corrispondenti | NO_MATCH |
Nessuna corrispondenza |
0 (Zero) | AVS non richiesto. (Utilizzato da VisaII) | NOT_REQUESTED |
AVS non richiesto |
K | Corrisponde solo il nome del titolare della carta di credito. | NAME_MATCH |
Il nome del titolare della carta di credito corrisponde |
O | Il titolare della carta e l'indirizzo corrispondono | NAME_ADDRESS_MATCH |
Il titolare della carta e l'indirizzo corrispondevano |
L | Il nome del titolare della carta e il codice di avviamento postale/CAP corrispondono | NAME_ZIP_MATCH |
Il nome del titolare della carta e il codice di avviamento postale/CAP corrispondevano |
Payment Client/Virtual Payment Client | DirectAPI | ||
---|---|---|---|
Codice di risposta | Descrizione | response.cardSecurityCode.gatewayCode |
Descrizione |
M | CSC valido o corrispondente | MATCHED |
Valido o corrispondente |
S | L'esercente indica che il CSC non è presente sulla carta | NOT_PRESENT |
L'esercente indica che il CSC non è presente sulla carta |
P | CSC non elaborato | NOT_PROCESSED |
Non elaborato |
U | L'issuer della carta non è registrato e/o certificato | NOT_SUPPPORTED |
L'issuer della carta non è registrato e/o certificato |
N | Codice non valido o non corrispondente | NO_MATCH |
Non valido o non corrispondente. |
Sì, è possibile inviare di nuovo la richiesta con gli stessi dettagli in quanto il gateway supporta operazioni idempotenti. Le operazioni idempotenti producono lo stesso risultato se richiamate ripetutamente. Se il gateway ha già ricevuto la richiesta, restituirà la risposta originale, in caso contrario elaborerà la richiesta e restituirà la risposta.
Di solito, è possibile abbinare le richieste alle risposte utilizzando i campi order.id
e transaction.id
forniti nelle richieste e restituiti nelle risposte. Tuttavia, se la propria applicazione non supporta un modello di integrazione sincrono o l'origine e la destinazione per una richiesta differiscono, è possibile utilizzare il campo correlationId
per identificare la richiesta e la risposta corrispondente. correlationId
è un identificativo transitorio, il cui valore non persiste nel gateway e viene restituito nella risposta alla richiesta. È possibile utilizzare il correlationId
con tutte le richieste di DirectAPI.
No merchant acquirer link
per un acquirer per il quale sono configurato?Contattare il your payment service provider per verificare che il collegamento all'acquirer dell'esercente sul gateway sia configurato per le combinazioni tipo di carta-valuta richieste.
Merchant Administration è un'interfaccia Web che consente agli esercenti di visualizzare e gestire facilmente i loro ordini. Gli esercenti possono ricercare e visualizzare i dettagli di ordini e transazioni, scaricare i report CSV, controllare i risultati di 3D Secure, impostare il controllo dei rischi, creare manualmente gli ordini, gestire i rimborsi e molto altro. Fare riferimento a Guida per l'utente Merchant Administration per maggiori dettagli.
Gli esercenti devono essere registrati sul gateway e il loro profilo deve essere stato configurato correttamente per accedere a Merchant Administration