Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Un token di rete (noto anche come token del circuito della carta di credito) è un token generato da provider di servizi di tokenizzazione di rete come Mastercard Digital Enablement Service (MDES), in cambio del numero di conto principale (PAN) del pagante. L'esercente o il provider di servizi di pagamento (per conto dell'esercente) possono richiedere la tokenizzazione dei PAN degli conti esistenti in archivio e la sostituzione di ogni PAN con un token di rete univoco. Tenere presente che ciò è soggetto alla partecipazione dell'issuer al servizio di tokenizzazione di rete e agli intervalli di conti della carta abilitati. Questi token possono quindi essere utilizzati per transazioni di e-commerce e in-app simili ai PAN dei conti.
Il Mastercard Gateway attualmente supporta l'elaborazione di token di rete ottenuti dai seguenti provider di servizi di tokenizzazione di rete:
È possibile utilizzare i token di rete tramite il Mastercard Gateway in due modi:
Quando si esegue l'integrazione direttamente con il provider di servizi token di rete, è necessario ottenere i dettagli del token dal provider e fornire questi dettagli al gateway su una richiesta Authorization/Pay per elaborare i pagamenti.
Oltre ai campi standard, per elaborare un pagamento utilizzando i token di rete generati dai provider di servizi di tokenizzazione della rete, fornire i campi indicati di seguito nella richiesta Authorization/Pay.
sourceOfFunds.type=SCHEME_TOKEN
: consente al gateway di identificare la provenienza dei fondi fornita nella richiesta come token della rete. MDES, VTS e AETS sono supportati rispettivamente da DirectAPI v51, v53, v57.sourceOfFunds.provided.card.number
: Il token di rete. Fornire il valore per il "Token PAN" MDES o il "Token" VTS o il "Token" AETS.
sourceOfFunds.provided.card.storedOnFile
=STORED
nella richiesta. Per ulteriori informazioni, vedere Transazioni avviate da titolari di carta e esercenti. sourceOfFunds.provided.card.expiry
: Scadenza dei token di rete. sourceOfFunds.provided.card.devicePayment.3DSecure.onlinePaymentCryptogram
: Utilizzare il valore direttamente dalle credenziali della transazione decrittografate. Fornire il crittogramma MDES UCAF (de48se43Data) o il crittogramma VTS TAVV.sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator
: L'indicatore transazione di e-commerce (ECI) emesso dal servizio di tokenizzazione. Questo campo è obbligatorio per i token di rete ottenuti da VTS. sourceOfFunds.provided.card.securityCode
: Il codice di verifica del token se emesso dal servizio di tokenizzazione. Fornisci il codice di verifica del token dinamico MDES (DTVC) o il valore di verifica del token dinamico VTS (DTVV) o la credenziale di pagamento dinamico AETS (DCSC).transaction.source
: Impostarlo su "INTERNET" o "MERCHANT" a seconda che si tratti di una transazione avviata dal titolare della carta o dall'esercente.Quando viene fornito un token di rete nella richiesta Authorization/Pay, la risposta Retrieve Transaction restituisce quanto segue:
Se l'acquirer restituisce un FPAN:
Se l'acquirer non restituisce un FPAN:
Il gateway fornisce supporto per agire come richiedente del token per conto dell'esercente. Se l'esercente è abilitato per la tokenizzazione gateway, il provider di servizi di pagamento può anche abilitare e configurare la tokenizzazione di rete sul profilo dell'esercente. Se abilitata, qualsiasi richiesta al gateway per un token gateway proverà anche a generare un token di rete corrispondente per gli schemi abilitati, se supportato dall'issuer della carta. La richiesta Authorization/Pay utilizzerà il token di rete se disponibile, altrimenti utilizzerà il FPAN (Funding PAN) archiviato associato al token del gateway.
Il gateway proverà inoltre ad effettuare la tokenizzazione della rete per tutte le carte applicabili già memorizzate nell'archivio dei token del gateway.
Quando si elimina un token del gateway, il token di rete corrispondente viene automaticamente eliminato sul servizio di tokenizzazione.
È importante notare che se la carta viene aggiornata dall'issuer, ad esempio nel caso di carte scadute, perse o rubate, i dettagli FPAN esistenti associati al token del gateway vengono contrassegnati come non validi. Nel caso in cui sia necessario utilizzare un FPAN nella richiesta di pagamento perché il token di rete non è disponibile, il gateway rifiuta la richiesta. Viene ricevuto un messaggio di errore "Il token fornito nella richiesta è contrassegnato come non valido. I dati della carta associati al token devono essere aggiornati prima di poter essere utilizzati, perché l'acquirer ha informato il gateway che non sono più validi."
Per mantenere aggiornati i dati, è possibile recuperare i dettagli FPAN mascherati dell'FPAN aggiornato dalla risposta della transazione in cui il token di rete è stato utilizzato nel pagamento.
Quando viene fornito un token di rete nella richiesta Authorization/Pay, la risposta Retrieve Transaction restituisce quanto segue:
Il gateway può elaborare i token di rete nella richiesta di avvio dell'autenticazione. Per ulteriori informazioni, vedere Initiate Authentication.
Se è stato utilizzato un token di rete per autenticare il pagante esternamente, è possibile passare informazioni sull'autenticazione nel gruppo di parametri authentication
dell'operazione Pay o Authorize. Per ulteriori informazioni, vedere Invio di un'operazione di pagamento pre-autenticata.
Il gateway consente di utilizzare i token di rete memorizzati su file per eseguire transazioni avviate da titolari di carta e esercenti.
Per un ordine o una transazione in cui è stato utilizzato un token di rete, il campo "Provider di token esterno" viene visualizzato nella pagina Dettagli ordine e transazione in Amministrazione dell'esercente. Questo campo può riportare Mastercard (MDES) o Visa (VTS).
È possibile verificare l'integrazione con il gateway in fase di produzione utilizzando il profilo esercente di prova e un token di rete supportato (vedere la tabella di seguito).
Provider di token | Token | Scadenza del token |
Crittogramma | Indicatore ECI |
---|---|---|---|---|
MDES | 5204 2477 5000 1497 | 11/22 | <any> | - |
VTS | 4111 1111 1111 1111 | 06/29 | <any> | 05 |
AETS | 3456 7890 1234 564 | 05/21 | <any> | - |
Se lo stato delle transazioni è APPROVED o DECLINED significa che il gateway è stato in grado di elaborare correttamente le transazioni di prova.