WL SIPS DOCS

Release 22.4

aller directement au contenu

Rechercher par mots clés

  1. Moyens de paiement
  2. Wallets
  3. Intégration Masterpass

Intégration Masterpass

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Introduction

WL Sips est une solution de paiement de commerce électronique multicanale sécurisée conforme à la norme PCI DSS. Elle vous permet d’accepter et de gérer des transactions de paiement en prenant en compte les règles métier liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement en plusieurs fois…).

L’objectif du présent document est d’expliquer l'intégration du moyen de paiement Masterpass dans WL Sips.

À qui s’adresse ce document ?

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Masterpass sur votre site de commerce électronique.

Il comprend :

  • des informations fonctionnelles à votre attention ;
  • des instructions d'implémentation à destination de votre équipe technique.

Pour avoir une vue d’ensemble de la solution WL Sips, nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle
  • Guide de configuration des fonctionnalités

Comprendre les paiements Masterpass avec WL Sips

Principes généraux

Masterpass est un service de wallet, proposé par Mastercard, reliant les clients et les commerçants du monde entier.

Masterpass permet à vos clients d’effectuer des paiements en ligne sans devoir saisir les coordonnées de leurs cartes à chaque fois qu'ils procèdent au paiement.

Règles d’acceptation

Fonctionnalités disponibles
Canaux de paiement
Internet V Canal de paiement par défaut
MOTO X
Télécopie X
SVI X
Typologies de paiement
Paiement immédiat X
Paiement en fin de journée V Méthode par défaut
Paiement différé V Limité à 6 jours
Paiement à l'expédition V
Paiement en plusieurs fois X
Paiements par abonnement X
Paiement par fichier X
Paiement OneClick X
Gestion des devises
Acceptation multidevise V
Règlement en devise V
Caractéristiques du moyen de paiement Masterpass

Voici les règles appliquées au paiement Masterpass :

  • Masterpass n’est pas un moyen de paiement à part entière, mais plus précisément, une option de paiement, car les transactions créées à l’aide du wallet Masterpass sont des transactions identifiées avec les moyens de paiement Visa, Mastercard ou American Express. Par conséquent, les cartes American Express, Visa et MasterCard peuvent être enrôlées dans un wallet Masterpass ;
  • pour les paiements effectués par le biais du wallet Masterpass, le délai de capture des transactions est limité à six jours, tout comme dans le cas des transactions 3-D Secure ;
  • tous les contrôles anti-fraude sont pris en charge dans le cadre des paiements Masterpass ;
  • les éléments graphiques de la page de paiement Masterpass sont fondés sur les modèles offerts par le fournisseur du wallet et vous ne pouvez pas les changer. Il est possible d’utiliser le wallet Masterpass en langues anglaise, française ou espagnole.

Ouvrir votre contrat d'acceptation Masterpass

Afin de proposer le moyen de paiement Masterpass sur votre site Web, vous devez souscrire un contrat VAD auprès de Visa, Mastercard ou American Express. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Vous devrez également activer le 3-D Secure sur ces contrats VAD.

Effectuer un paiement Masterpass

WL Sips vous offre deux solutions pour intégrer le moyen de paiement Masterpass :

  • Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
  • Sips Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.

Les modes de remise disponibles pour une transaction Masterpass sont les suivants :

  • Mode annulation : mode par défaut, il permet de remiser la transaction à une date prédéfinie, appelée délai de capture. Lorsque ce délai de capture est atteint, la remise est automatiquement envoyée. Ce délai est paramétré via le champ captureDay, sa valeur par défaut est 0 (paiement en fin de journée).
  • Mode validation : vous devez valider la transaction pour déclencher la remise. Un délai de capture doit aussi être défini. Lorsque ce délai de capture est atteint ou dépassé, vous ne pourrez plus valider la transaction, celle-ci expirera donc automatiquement.

Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :


Description des status possibles pour une transaction Masterpass

En mode validation (captureMode = VALIDATION), si la transaction est acceptée, la transaction passe en status TO_VALIDATE. En mode annulation (captureMode = AUTHOR_CAPTURE), si la transaction est acceptée, la transaction passe en statut TO_CAPTURE. Quel que soit le mode de capture, si la transaction est refusée (responseCode différent de 00), elle passe en statut REFUSED. Et si la transaction est abandonnée (responseCode égal à 17), elle passe en statut ABORTED.

Effectuer un paiement Masterpass avec Sips Paypage

La cinématique de paiement pour Sips Paypage est décrite ci-dessous :


Étapes d'un paiement Masterpass via Paypage

1) Le client procède au paiement. 2) Il est redirigé vers la page de sélection du moyen de paiement hébergée chez WL Sips, il sélectionne Masterpass et saisit son numéro de carte. 3) Il est redirigé vers la page Masterpass où il s'authentifie. 4) Il est redirigé sur une page WL Sips. 5) S'il clique sur le bouton de retour à la boutique, il est redirigé vers votre site Web ce qui délenche l'envoi de la réponse manuelle. 6) WL Sips envoie une réponse automatique.
Paramétrer la requête de paiement

Le champ suivant a un comportement particulier :

Nom du champ Remarques / règles
authenticationDataissuer​​WalletAuth​Policycheck3DS Vous permet de passer outre l’authentification 3-D Secure.
Analyser la réponse

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
holderAuthentProgram = MASTERPASS ou 3DS
panEntryMode = WALLET
paymentMeanBrand = carte utilisée dans le wallet (VISA, MASTERCARD, CB ou autre)
paymentMeanType = CARD
walletType = MASTERPASS
 Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le document Dictionnaire des données). L’autorisation est refusée pour un motif non lié à la fraude.
Si vous n’avez pas opté pour l’option « nouvelle tentative de paiement » (pour plus de détails veuillez consulter le Guide de configuration des fonctionnalités), vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus nombre max essais atteint responseCode = 75 Le client a fait plusieurs tentatives qui ont toutes échoué.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Effectuer un paiement Masterpass avec Sips Office

Le processus de paiement pour Sips Office est décrit ci-dessous :


Étapes d'un paiement Masterpass via Office

1) Le client procède au paiement directement sur votre site Web. 2) Vous initialisez le paiement auprès de WL Sips (PaymentProviderInitialize). 3) Vous redirigez le client vers les pages d'identification et de paiement Masterpass (redirectionUrl). 4) Le client est ensuite redirigé vers votre site Web (merchantReturnUrl). 5) Vous finalisez le paiement auprès de WL Sips (PaymentProviderFinalize). 6) Vous affichez le résultat du paiement à votre client.
Initialiser un paiement (paymentProviderInitialize)

L’initialisation d’un paiement Masterpass est effectuée en appelant la méthode paymentProviderInitialize.

Requête d’initialisation du paiement

Vous devez valoriser les champs spécifiques suivants dans la requête d'initialisation pour un paiement Masterpass :

Nom du champ Remarques / règles
paymentMeanBrand Doit être valorisé avec MASTERPASS.
authenticationData.issuerWalletAuthPolicy.check3DS Vous permet de passer outre l’authentification 3-D.
Réponse d’initialisation du paiement

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Initialisation de paiement acceptée acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
messageVersion = version du message récupérée en réponse à l’initialisation du paiement.
paymentMeanBrand = VISA, MASTERCARD ou AMEX.
redirectionData = données de redirection récupérées en réponse à l’initialisation du paiement.
redirectionUrl = URL intent
 Redirigez le client vers redirectionUrl.
Initialisation de paiement rejetée Consultez le champ errorFieldName, puis corrigez la requête.
En cas d’erreur persistante, contactez l'assistance technique.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Rediriger le client vers le site Web de Masterpass

Le client doit être redirigé vers l’URL redirectionUrl fournie en réponse de la méthode paymentProviderInitialize. Cette redirection consiste à effectuer un appel POST sur l’URL redirectionUrl obtenue dans la réponse à l’initialisation de paiement. Les paramètres POST à transmettre sont redirectionData et messageVersion obtenus également dans la réponse à l’initialisation de paiement.

A la fin de la cinématique de paiement, le client est redirigé sur l’URL fournie dans la requête d’initialisation, merchantReturnUrl. Les champs suivants sont transmis en POST et doivent être récupérés pour finaliser le paiement:

Nom du champ Remarques / règles
responseCode Code réponse du processus de redirection
redirectionData Données de redirection récupérées en réponse à l’initialisation du paiement.
messageVersion Version du message récupérée en réponse à l’initialisation du paiement.
amount Montant de la transaction en centimes
merchantId Identifiant de la boutique
transactionReference Référence de la transaction
transactionId Identifiant de la transaction
transactionDate Date de la transaction
Finaliser un paiement (PaymentProviderFinalize)

Cette dernière étape vous permet d’obtenir le statut du paiement. Les paramètres obtenus lors de la redirection après la cinématique de paiement sur le site Web Masterpass sont à transmettre lors de cet appel. La méthode utilisée pour finaliser un paiement est paymentProviderFinalize.

Tip: vous pouvez, en réponse à votre requête paymentProviderFinalize, obtenir un code 24 « Opération impossible ». Ce code signifie que cette requête a déjà été envoyée et traitée pour la transaction concernée. Si vous ne pouvez identifier ce traitement, nous vous invitons à utiliser la fonction GetTransactionData du service diagnostic : cette opération permet de récupérer des informations relatives à une transaction créée préalablement à l'aide de WL Sips.
Requête de finalisation du paiement

Vous devez valoriser les champs spécifiques suivants dans la requête de finalisation pour un paiement Masterpass.

Nom du champ Remarques / règles
redirectionData Données de redirection récupérées au retour du client vers votre site Web (voir Rediriger le client vers le site Web de Masterpass).
messageVersion Version du message récupérée au retour du client vers votre site Web (voir Rediriger le client vers le site Web de Masterpass).
Réponse de finalisation du paiement

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
holderAuthentMethod = (voir le Dictionnaire des données).
holderAuthentProgram = (voir le Dictionnaire des données).
holderAuthentStatus = (voir le Dictionnaire des données).
panEntryMode = mode de saisie de PAN
paymentMeanBrand = VISA, MASTERCARD ou AMEX.
transactionStatus = (voir le Dictionnaire des données).
walletType = fournisseur du wallet.
 Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus Soft Decline acquirerResponseCode = A1 L’acquéreur a refusé le paiement car il n’y a pas eu d'authentification 3-D Secure.
Veuillez retenter le paiement en activant l'authentification 3-D Secure.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Gérer vos transactions Masterpass

Opérations de caisse disponibles

Les opérations suivantes sont disponibles sur les transactions Masterpass :

Gestion de caisse
Annulation V Annulation possible sur le montant partiel de la transaction.
Validation V Validation possible sur le montant partiel de la transaction.
Remboursement V Remboursement possible sur le montant partiel de la transaction.
Duplication V
Recyclage X
Crédit X

Le diagramme ci-dessous vous permet de savoir quelle opération de gestion de caisse est disponible lorsqu’une transaction est dans un état donné :


Schéma trop complexe à décrire, merci de contacter le support sips@worldline.com

Consulter vos transactions Masterpass

Journaux

Les journaux mis à disposition par WL Sips vous permettent d’avoir une vision exhaustive et consolidée de vos transactions, opérations de caisse, situation comptable et impayés. Vous pouvez utiliser ces informations pour enrichir votre système d’information.

La disponibilité des transactions Masterpass pour chaque type de journal est récapitulée dans le tableau ci-dessous :

Disponibilité des journaux
Journal des transactions V
Journal des opérations V
Journal de rapprochement des transactions V
Journal de rapprochement des impayés V
Note: pour les transactions Masterpass, le champ paymentMeanBrand est renseigné avec la valeur MASTERPASS.

Sips Office Extranet

Vous pouvez consulter vos transactions Masterpass et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.



Retourner en haut de page Besoin d'aide ?

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres