Integrazione Masterpass
- Flusso di checkout standard
- Interazione di checkout standard richiesta
- Requisiti di branding
- Pairing Masterpass
- Masterpass Connected Checkout
- Masterpass Express Checkout
- Masterpass Advanced Checkout
- Test dell'integrazione
Masterpass
Masterpass è un servizio che consente ai paganti di archiviare, gestire e condividere in modo sicuro le proprie informazioni di pagamento, nonché le informazioni su indirizzo di spedizione e fatturazione, con i siti Web e le app mobile con cui eseguono transazioni. Questa opportunità è utile se si desidera migliorare l'esperienza di checkout del pagante, nonché ridurre i costi di conformità PCI, dal momento che il provider del wallet garantisce l'archiviazione sicura delle informazioni del pagante.
Prerequisiti
Per poter utilizzare Masterpass mediante Mastercard Gateway, è necessario che il provider di servizi di pagamento abbia inserito il profilo esercente in Masterpass. Una volta inserito, l'esercente riceverà l'identificativo di checkout che il provider di servizi di pagamento dovrà utilizzare per abilitare e configurare l'esercente per Masterpass.
Masterpass Standard Checkout
Masterpass Standard Checkout consente al pagante di interagire con il proprio wallet digitale Masterpass senza lasciare la pagina Web dell'esercente. L'interazione viene visualizzata in una lightbox in alto nella pagina di checkout.
Il diagramma di seguito mostra un flusso di checkout di esempio per il sito Web dell'esercente e Masterpass.
- Un pagante esplora il sito Web dell'esercente, seleziona uno o più prodotti e fa clic su ACQUISTA CON Masterpass nella pagina del checkout.
- Nella lightbox Masterpass, visualizzata in alto nel sito Web dell'esercente, il pagante:
- Accede al proprio wallet Masterpass.
- Seleziona una carta di credito per il pagamento.
- Seleziona un indirizzo di spedizione o ne aggiunge uno nuovo.
- Fa clic su un pulsante per confermare le selezioni e chiude la lightbox Masterpass.
- Nel sito Web dell'esercente il pagante finalizza l'acquisto e l'esercente visualizza la ricevuta/il riepilogo dell'ordine.
Richiesta di un'interazione Masterpass Standard Checkout
Se esiste già un'integrazione Hosted Checkout, Masterpass sarà automaticamente disponibile dopo che questa sarà stata abilitata.
Se si desidera avere il controllo completo sull'interazione della lightbox Masterpass sulla propria pagina di pagamento, è possibile scegliere questa opzione per richiamare personalmente la lightbox.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script> <script type="text/javascript"> // INITIALIZE and INVOKE THE MASTERPASS LIGHTBOX MasterPass.client.checkout({ "version":"v6", "successCallback": onSuccessfulCheckout, "cancelCallback": onCancel, "failureCallback": onFailure, // USE PARAMETERS FROM THE OPEN WALLET RESPONSE "requestToken": "<wallet.masterpass.requestToken>", "merchantCheckoutId": "<wallet.masterpass.merchantCheckoutId>", "allowedCardTypes": "<wallet.masterpass.allowedCardTypes>" }); // RETRIEVE PARAMETERS FROM THE LIGHTBOX INTERACTION function onSuccessfulCheckout(data) { document.getElementById('oauthToken').value=data.oauth_token; document.getElementById('oauthVerifier').value=data.oauth_verifier; document.getElementById('checkoutUrl').value=data.checkout_resource_url; } function onCancel() { // do something to tell you the cardholder cancelled } function onFailure() { // do something to tell you things have gone wrong } </script>
- Eseguire un'operazione
Create Session
per ottenere un ID di sessione. - Utilizzare l'ID di sessione della risposta
Create Session
in un'operazioneOpen Wallet
per ottenere i dati richiesti per richiamare la lightbox Masterpass. È necessario specificare le seguenti informazioni nell'operazioneOpen Wallet
:
order.walletProvider
: Impostarlo suMASTERPASS_ONLINE
.order.amount
: Importo dell'ordine.order.currency
: Valuta di pagamento dell'ordine.wallet.masterpass.originUrl
: URL della pagina che ha richiamato la lightbox Masterpass.
- Fare riferimento alla libreria JavaScript lato client
MasterPass.client.js
nella pagina di pagamento.- Per il test:
https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js
. - Per le transazioni attive:
https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js
.
- Per il test:
-
Quando il pagante fa clic su ACQUISTA CON Masterpass, richiamare la lightbox Masterpass utilizzando i seguenti parametri restituiti dalla risposta
Open Wallet
.wallet.masterpass.requestToken
wallet.masterpass.merchantCheckoutId
wallet.masterpass.allowedCardTypes
È necessario fornire un URL callback e/o anche metodi callback per gestire la risposta restituita dall'interazione della lightbox Masterpass. Per ulteriori informazioni sulla gestione dei callback, vedere la Documentazione Masterpass.
-
Recuperare i seguenti parametri restituiti (solo se l'interazione della lightbox Masterpass ha avuto esito positivo) dall'URL callback o dal metodo callback eseguito correttamente e passarli al server Web:
oauth_token
oauth_verifier
checkout_resource_url
- Eseguire un'operazione
Update Session From Wallet
per ottenere i dettagli di pagamento e di spedizione del pagante da Masterpass. È necessario specificare i seguenti parametri in questa operazione.
- ID di sessione: L'identificativo per il pagamento restituito dall'operazione
Create Session
. order.walletProvider
: Impostarlo suMASTERPASS_ONLINE
.wallet.masterpass.oauthToken
: Iloauth_token
recuperato dal callback.wallet.masterpass.oauthVerifier
: Iloauth_verifier
recuperato dal callback.wallet.masterpass.checkoutUrl
: Ilcheckout_resource_url
recuperato dal callback.
Se riesce, la sessione restituita conterrà i dettagli di pagamento del pagante dall'interazione Masterpass.
Se l'interazione del pagante Masterpass include l'autenticazione 3 D Secure, i risultati dell'autenticazione 3DS vengono aggiunti alla sessione e restituiti nella rispostaUpdate Session From Wallet
. vedere Advanced Checkout.Riferimento API per l'aggiornamento della sessione dal wallet [REST][NVP]
- ID di sessione: L'identificativo per il pagamento restituito dall'operazione
- Utilizzare la sessione restituita per presentare una pagina di conferma ordine o inviare un pagamento a Mastercard Gateway. Vedere Eseguire un'operazione usando la sessione.
Requisiti del marchio Masterpass per il sito Web dell'esercente
Quando si propone Masterpass come opzione di pagamento ai paganti nel proprio sito Web, è necessario soddisfare i requisiti del marchio dell'interfaccia utente di Masterpass. Per indicazioni su come presentare gli elementi dell'interfaccia utente nelle pagine di checkout, vedere Marchio Masterpass.
Pairing Masterpass
Il pairing Masterpass consiste nel collegare il conto del wallet Masterpass di un pagante con il relativo account dell'app o del sito Web dell'esercente. Per ulteriori informazioni, vedere Pairing Masterpass.
vedere Advanced Checkout
Se sono stati configurati i servizi di autenticazione del pagante Advanced Checkout con Masterpass, l'autenticazione 3 D Secure (3DS) sarà facilitata dall'MPI di Masterpass.
I risultati dell'autenticazione 3DS verranno aggiunti alla sessione e restituiti nella risposta Update Session From Wallet
. È consigliabile che l'integrazione verifichi i risultati 3DS nella sessione prima di procedere con l'invio del pagamento a Mastercard Gateway.
Test dell'integrazione
Se l'ID esercente è preceduto dal prefisso "TEST", le richieste vengono instradate all'ambiente di test Masterpass.
A scopo di test, verificare che i riferimenti alla libreria MasterPass.client.js
siano impostati su https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js
.
Per eseguire un test end-to-end dell'integrazione Masterpass comprendente l'interazione 3DS, aggiungere le seguenti carte di test al wallet del pagante nell'ambiente di test Masterpass. È possibile fornire la data di scadenza o il CSC.
Carte di test | Numero della carta | Registrato con 3D Secure |
---|---|---|
Mastercard |
5506900140100305 | Y |
5506900140100107 | Y | |
5506900140100503 | N | |
Visa |
4440000009900010 | Y |
4440000042200014 | Y | |
4440000042200022 | N | |
American Express |
340000099900036 | Y |
340000099900028 | Y | |
340000099900044 | Y | |
340000099900051 | N | |
Diners Club |
30599900026332 | Y |
30599900026340 | N | |
Discover | 6011100099900534 | - |
6011100099900013 | - |
Domande frequenti
Se per il wallet Masterpass del pagante non è stato eseguito il pairing con la propria azienda, Mastercard Gateway recupera i tipi di carta supportati dalla configurazione dell'esercente e garantisce che in Masterpass siano disponibili per la selezione solo questi tipi di carta.
Se per il wallet Masterpass del pagante è stato eseguito il pairing con la propria azienda, i tipi di carta di credito vengono recuperati dal wallet Masterpass del pagante.