Masterpass
Masterpass est un service permettant aux payeurs de stocker, gérer et partager en toute sécurité leurs informations de paiement, de livraison et d'adresse de facturation pour les sites Web et les applications mobiles avec lesquels ils effectuent des transactions. Cela est utile si vous souhaitez améliorer l'expérience de paiement pour le payeur et également réduire les coûts liés à la conformité PCI, car le fournisseur du portefeuille sécurise et protège les informations du payeur.
Conditions préalables
Pour utiliser Masterpass via Mastercard Gateway, votre fournisseur de services de paiement doit disposer de votre profil de commerçant enregistré dans Masterpass. Une fois votre inscription réussie, un identifiant de paiement vous sera fourni, que votre fournisseur de services de paiement utilisera pour vous activer et vous configurer pour Masterpass.
Masterpass Standard Checkout
Masterpass Standard Checkout permet au payeur d'interagir avec son portefeuille numérique Masterpass sans avoir à quitter votre page Web. L'interaction est rendue dans une lightbox, affichée par-dessus votre page de paiement.
Le diagramme ci-dessous présente un exemple de flux de paiement pour le site de votre magasin et Masterpass.
- Un payeur navigue sur le site de votre magasin, sélectionne un ou plusieurs produits et clique sur PAYER AVEC Masterpass sur la page de paiement.
- Dans la lightbox Masterpass, affichée par-dessus le site de votre magasin, le payeur :
- Se connecte à son portefeuille Masterpass.
- Sélectionne une carte pour paiement.
- Sélectionne une adresse de livraison ou en ajoute une nouvelle.
- Clique sur un bouton pour confirmer ses choix et ferme la lightbox Masterpass.
- Sur le site de votre magasin, le payeur finalise les achats et vous affichez le récapitulatif/le reçu de la commande.
Demander une interaction Masterpass Standard Checkout
Si vous disposez d'une intégration Hosted Checkout, Masterpass est automatiquement disponible sur la page de paiement une fois que vous l'avez activé.
Pour bénéficier d'un contrôle total sur l'interaction la lightbox Masterpass sur votre page de paiement, vous pouvez choisir cette option pour appeler la lightbox vous-même.
<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>
- Exécutez une opération
Create Sessionafin d'obtenir un ID de session.Référence de l'API Create Session (Créer une session)[REST][NVP]
- Utilisez l'ID de session de la réponse
Create Session(Créer une session) dans une opérationOpen Wallet(Ouvrir le portefeuille) afin d'obtenir les données requises pour appeler la lightbox Masterpass. Vous devez indiquer les informations suivantes dans l'opérationOpen Wallet(Ouvrir le portefeuille) :
order.walletProvider: définissez ce champ avec la valeurMASTERPASS_ONLINE.order.amount: le montant de la commande.order.currency: La devise dans laquelle est payée la commande.wallet.masterpass.originUrl: L'URL de la page ayant appelé la lightbox Masterpass.
Référence de l'API Open Wallet (Ouvrir le portefeuille) [REST][NVP]
- Référencez la bibliothèque client JavaScript
MasterPass.client.jssur votre page de paiement.- Pour les tests :
https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js. - Pour les transactions en direct :
https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
- Pour les tests :
-
Lorsque le payeur clique sur PAYER AVEC Masterpass, appelez la lightbox Masterpass en utilisant les paramètres suivants de la réponse
Open Wallet(Ouvrir le portefeuille).wallet.masterpass.requestTokenwallet.masterpass.merchantCheckoutIdwallet.masterpass.allowedCardTypes
Vous devez indiquer une URL de rappel et/ou des méthodes de rappel afin de gérer la réponse de l'interaction de la lightbox Masterpass. Pour plus d'informations sur la gestion des rappels, voir la documentation Masterpass.
-
Extrayez les paramètres suivants de l'URL de rappel ou d'une méthode de rappel ayant réussi (renvoyés uniquement si l'interaction de la lightbox Masterpass a réussi) et transmettez-les à votre serveur Web.
oauth_tokenoauth_verifiercheckout_resource_url
- Exécutez une opération
Update Session From Wallet(Mettre à jour la session à partir du portefeuille) afin d'obtenir de Masterpass les détails de paiement et de livraison du payeur. Vous devez indiquer les paramètres suivants dans cette opération.
- ID session : Identificateur de la session de paiement renvoyé par l'opération
Create Session(Créer une session). order.walletProvider: Définissez ce champ avec la valeurMASTERPASS_ONLINE.wallet.masterpass.oauthToken: leoauth_tokenextrait du rappel.wallet.masterpass.oauthVerifier: leoauth_verifierextrait du rappel.wallet.masterpass.checkoutUrl: lecheckout_resource_urlextrait du rappel.
En cas de succès, la session renvoyée contient les détails du paiement de l'interaction Masterpass.
Si l'interaction entre le payeur et Masterpass comporte une authentification 3-D Secure, les résultats de l'authentification 3DS sont ajoutés à la session et renvoyés dans la réponseUpdate Session From Wallet(Mettre à jour la session à partir du portefeuille). Voir Advanced Checkout.Référence de l'API Mettre à jour la session à partir du portefeuille [REST][NVP]
- ID session : Identificateur de la session de paiement renvoyé par l'opération
- Utilisez la session renvoyée pour présenter une page de confirmation de commande ou pour soumettre un paiement à Mastercard Gateway. Voir Exécution d'une opération au moyen de la session.
Exigences de la marque Masterpass pour le site de votre magasin
Vous devez respecter les exigences de marque de l'interface utilisateur Masterpass lorsque vous présentez Masterpass comme option à vos payeurs sur votre site Web. Pour des directives sur la manière de présenter les éléments d'interface sur vos pages de paiement, consultez Marque Masterpass.
Couplage Masterpass
Le couplage Masterpass correspond au traitement d'association du compte de portefeuille Masterpass avec votre compte sur le site de votre magasin/votre application. Pour plus d'informations, voir Couplage Masterpass.
Advanced Checkout
Si vous avez configuré les services d'authentification du payeur Advanced Checkout avec Masterpass, l'authentification 3-D Secure (3DS) sera facilitée par le MPI Masterpass.
Les résultats de l'authentification 3DS seront ajoutés à la session et renvoyés dans la réponse Update Session From Wallet. Il est recommandé que l'intégration vérifie les résultats 3DS dans la session avant de poursuivre et de soumettre le paiement à Mastercard Gateway.
Test de votre intégration
Si votre ID de commerçant est préfixé par « TEST », les demandes sont acheminées vers le Sandbox Masterpass.
À des fins de test, assurez-vous que les références à la bibliothèque MasterPass.client.js sont définies avec la valeur https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
Pour réaliser un test complet de votre intégration Masterpass, notamment l'intégration 3DS, ajoutez les cartes de test suivantes au portefeuille de votre payeur dans l'espace d'essai Masterpass. Vous pouvez indiquer une date d'expiration ou un CSC.
| Cartes de test | Numéro de carte | Inscrit 3D Secure |
|---|---|---|
Mastercard |
5506900140100305 | O |
| 5506900140100107 | O | |
| 5506900140100503 | N | |
Visa |
4440000009900010 | O |
| 4440000042200014 | O | |
| 4440000042200022 | N | |
American Express |
340000099900036 | O |
| 340000099900028 | O | |
| 340000099900044 | O | |
| 340000099900051 | N | |
Diners Club |
30599900026332 | O |
| 30599900026340 | N | |
| Discover | 6011100099900534 | - |
| 6011100099900013 | - |
Questions fréquentes
Si le portefeuille Masterpass du payeur n'est pas couplé avec votre activité, Mastercard Gateway extrait les types de carte pris en charge à partir de votre configuration de commerçant et s'assure que seuls ces types de carte sont disponibles pour sélection dans Masterpass.
Si le portefeuille Masterpass du payeur est couplé avec votre activité, les types de carte sont extraits du portefeuille Masterpass du payeur.