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 Visa Checkout dans WL Sips.
À qui s’adresse ce document ?
Ce document a pour objectif de vous aider à implémenter le moyen de paiement Visa Checkout 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 Visa Checkout avec WL Sips
Principes généraux
Visa Checkout est un wallet en ligne proposé par Visa, permettant de stocker virtuellement des cartes Visa, Mastercard et American Express et de les utiliser lors des paiements sur WL Sips sans avoir à les ressaisir.
Pour proposer ce moyen de paiement, il est nécessaire de créer un compte Visa Checkout (Merci de vous référer au paragraphe Créer son compte Visa Checkout). Il est aussi nécessaire d'avoir un contrat d'acceptation pour les moyens de paiement éligibles (au moins pour un des 3 moyens de paiement, Visa, Mastercard ou American Express).
Pour payer avec Visa Checkout, le client doit posséder un compte Visa Checkout avec des moyens de paiement enregistrés. Pendant le paiement, après avoir sélectionné Visa Checkout, le client doit s'identifier et choisir l'un des moyens de paiement enregistrés sur son compte. S’il n'a pas de compte Visa Checkout, il peut en créer un au cours du processus de paiement.
Le wallet Visa Checkout permet de gérer différentes informations, mais seules celles relatives au moyen de paiement sélectionné par le client sont utilisées par WL Sips.
Paiement Visa Checkout 3-D Secure
Visa Checkout est compatible avec 3-D Secure. Une fois sélectionné un moyen de paiement dans le wallet Visa Checkout, la transaction peut permettre l'authentification du paiement via 3-D Secure, si le moyen de paiement et la configuration de votre boutique le permettent.
3-D Secure se configure normalement comme pour les moyens de paiement éligibles, sans particularité pour Visa Checkout.
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 | |
| Moyens de paiement | ||
| Visa | V | Les cartes co-badgées (par exemple CB/Visa) seront traitées comme des cartes Visa. |
| Mastercard | V | Les cartes co-badgées (par exemple CB/Mastercard) seront traitées comme des cartes Mastercard. |
| American Express | V | |
| Diners | X | Ce moyen de paiement peut être ajouté à un wallet Visa Checkout mais ne peut être utilisé avec WL Sips. |
| Typologies de paiement | ||
|---|---|---|
| Paiement immédiat | V | |
| Paiement en fin de journée | V | |
| Paiement différé | V | |
| Paiement à l'expédition | V | |
| Paiement en plusieurs fois | X | |
| Paiement par abonnement | X | |
| Paiements par fichier | X | |
| Paiement OneClick | X | |
| Gestion des devises | ||
|---|---|---|
| Acceptation multidevise | V | |
| Règlement en devise | V | |
Demande d'autorisation
Les autorisations effectuées avec des moyens de paiement enregistrés dans un wallet Visa Checkout respectent les règles standard des autorisations effectuées avec ces moyens de paiement (même durée de validité par exemple).
Lightbox Visa Checkout
Visa Checkout se caractérise par un bouton (fourni par Visa) déclenchant l'affichage de la fenêtre pop-in du wallet appelée Lightbox Visa Checkout.
Sips Paypage intègre le bouton Visa Checkout directement parmi les moyens de paiement (lorsque Visa Checkout est éligible pour une transaction). Dans ce cas vous n'avez aucun développement à faire.
Mais vous pouvez aussi intégrer le bouton Visa Checkout sur les pages de votre site Web ou de votre application mobile, dans 3 cas :
- vous souhaitez proposer la sélection de Visa Checkout avant que Sips Paypage ne propose les autres moyens de paiement ;
- vous utilisez Sips Office pour gérer les paiements depuis votre site Web commerçant et gérez donc au sein de ce dernier la saisie des informations de paiement ;
- vous utilisez Sips In-App pour gérer les paiements depuis votre application mobile et gérez donc au sein de cette dernière la saisie des informations de paiement.
Dans ces 3 derniers cas vous devez respecter les règles d'intégration de Visa Checkout telles que Visa les définit dans sa documentation accessible ici :
https://developer.visa.com/capabilities/visa_checkout/docs
Exemple de Lightbox Visa Checkout (à titre indicatif, car Visa peut modifier l'allure de celle-ci au fil des évolutions) :
Principe d’intégration
Le bouton Visa Checkout s'intègre grâce à du code Javascript exploitant des ressources (Javascript et images) hébergées par Visa.
La documentation Visa indique comment procéder pour intégrer le bouton, et traiter l'affichage du wallet et surtout ses réponses. En cas de bon déroulement de la sélection du moyen de paiement par le client, votre application reçoit de Visa une donnée appelée Visa Checkout CallID (ou simplement CallID) qui doit être transmise à WL Sips pour qu'il retrouve les données du moyen de paiement choisi, et finalise la transaction.
L'allure du bouton Visa Checkout ou de la fenêtre pop-in du wallet est paramétrable de deux manières :
- lors de l'appel au code Javascript de Visa, surchargeant le paramétrage par défaut (Merci de vous référer à la documentation Visa) ;
- directement dans votre profil Visa Checkout pour définir votre paramétrage par défaut (profil accessible une fois votre compte Visa Checkout créé. Merci de vous référer au paragraphe Paramétrer son compte Visa Checkout).
Les ressources Visa Checkout hébergées par Visa peuvent évoluer selon les besoins identifiés par Visa, sous la seule responsabilité de Visa. Toutefois Visa annonce que ces évolutions seront compatibles avec les précédentes versions.
La documentation Visa présente toutes les recommandations d'intégration du bouton Visa Checkout et d'utilisation de logo Visa Checkout.
Compatibilité avec les navigateurs
Le bouton et le wallet Visa Checkout sont compatibles avec des versions spécifiques de navigateurs. Les informations relatives à ces compatibilités sont décrites dans la documentation Visa.
Règles de sécurité
L'utilisation des ressources Visa Checkout hébergées par Visa, et de manière plus globale l'utilisation de Visa Checkout avec l'intégration du bouton Visa Checkout sur votre site Web commerçant ou dans vos applications mobiles amène quelques questions de sécurité.
Accès aux données de paiement
La configuration standard de votre compte Visa Checkout créé pour WL Sips (Merci de vous référer au paragraphe S’enrôler à Visa Checkout) est telle que votre site Web ou votre application mobile n'a jamais besoin de gérer des données de paiement protégées par la règlementation PCI-DSS (notamment pas de numéro de carte).
Le wallet Visa Checkout est succeptible de fournir des données personnelles des clients (par exemple adresse ou date de naissance), dans le cas où le bouton Visa Checkout est directement intégré sur votre site marchand ou dans votre application mobile. Il est alors de votre ressort de garantir la bonne application des règlementations concernant ces données (notamment la RGPD).
Sécurisation du code
Pour éviter tout piratage lors de l'utilisation de Visa Checkout, Visa indique une série de mesures de sécurité à respecter lors de l'intégration du bouton (et de la fenêtre pop-in du wallet) Visa Checkout. Elles sont toutes indiquées dans le document PDF Visa Checkout Integration Guide fourni par Visa sur son site Web (Dans sa version 5.8, merci de vous référer à l'annexe C Clickjacking Prevention Steps).
Créer votre compte Visa Checkout
Afin d'utiliser le wallet Visa Checkout sur votre site Web, vous devez posséder un compte Visa Checkout. Il est créé automatiquement à partir des données d'inscription à WL Sips.
S’enrôler à Visa Checkout
Pour vous enrôler à Visa Checkout et créer votre compte, vous devez en faire la demande auprès de l'Assistance Client, qui vous demandera peut-être quelques informations complémentaires (si elles n'ont pas déjà été renseignées lors de votre inscription à WL Sips) :
- merchant ID WL Sips ;
- numéro de TVA intracommunautaire ;
- nom, Prénom et adresse e-mail d'un contact principal ;
- nom et URL de votre site marchand.
Ces données sont transmises par Worldline à Visa et alimentent le profil de votre compte Visa Checkout.
Vous recevez ensuite de la part de Visa un courrier électronique vous indiquant la création de votre compte et vous proposant de définir votre mot de passe. Ceci est nécessaire dans le cas où vous souhaiteriez :
- intégrer le bouton Visa Checkout sur les pages de votre site de commerce électronique ou sur votre application mobile ;
- configurer vous-même l'affichage du wallet Visa Checkout ;
- modifier les données vous concernant enregistrées auprès de Visa.
Paramétrer son compte Visa Checkout
Sur votre compte Visa Checkout, vous pouvez :
- modifier vos données personnelles ;
- configurer le wallet Visa Checkout (en créant un ou plusieurs profils) ;
- récupérer votre API Key et votre Shared Secret (nécessaire si vous voulez installer un bouton Visa Checkout sur votre site de e-commerce ou dans votre application mobile).
Dans votre compte Visa Checkout, sélectionner votre projet :
Vous arrivez ensuite sur la page de gestion Visa Checkout, avec le menu à droite qui donne accès :
- à vos données personnelles via le lien « Users » ;
- à vos profils de configuration du wallet Visa Checkout via le lien « Configuration » ;
- à vos API Key et Shared Secret via le lien « Credentials ».
Pour une bonne utilisation du portail de Visa Checkout, merci de voius référer à la documentation de Visa.
Ajouter le compte Visa Checkout sur WL Sips
Une fois que votre compte Visa Checkout est créé, vous pouvez contacter l’assistance technique pour lui demander d'activer (ou plus tard de désactiver) le wallet Visa Checkout.
La demande d'activation peut être faite en même temps que la demande d'enrôlement.
Effectuer un paiement Visa Checkout
WL Sips vous offre trois solutions pour intégrer le wallet Visa Checkout :
- 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.
- Sips In-App qui vous permet d'appeler WL Sips depuis votre application mobile, en mode serveur à serveur.
Le bouton Visa Checkout est dans certains cas affiché par WL Sips et dans d'autres intégré sur vos pages ou dans votre application mobile :
- Sips Office et Sips In-App : vous devez obligatoirement intégrer le bouton Visa Checkout à vos pages.
- Sips Paypage :
- vous pouvez laisser WL Sips gérer l'affichage du bouton Visa Checkout, exactement comme les logos des autres wallet et moyens de paiement (on parle d'un paiement Visa Checkout standard).
- vous pouvez afficher le bouton Visa Checkout avant l'appel à WL Sips et forcer Sips à utiliser Visa Checkout pour le paiement (on parle alors d'un paiement Visa Checkout avancé).
Si vous intégrez le bouton Visa Checkout à vos pages, il vous faut récupérer la donnée CallID une fois que le client a sélectionné son moyen de paiement dans le wallet Visa Checkout (lui aussi affiché sur votre page), et transmettre cette données dans la requête envoyée à WL Sips.
Merci de vous référer à la documentation de Visa pour voir comment obtenir cette donnée CallID.
Effectuer un paiement Visa Checkout standard avec Sips Paypage
La cinématique de paiement standard pour Sips Paypage est décrit ci-dessous :
Paramétrer la requête de paiement standard
Le champ suivant est utilisé dans le cas d'un paiement Visa Checkout standard et potentiellement transmis à Visa pour paramétrer l'affichage du wallet Visa Checkout :
| Nom du champ | Remarque / règles |
|---|---|
| customerLanguage | Permet de choisir la langue utilisée sur les pages WL Sips et dans le wallet Visa Checkout. |
Analyser la réponse
Le tableau suivant récapitule les différents cas de réponses possibles selon les événements d'utilisation du wallet Visa Checkout en mode standard :
| État | Champs de la réponse | Action à réaliser |
|---|---|---|
| Paiement accepté | responseCode = 00 acquirerResponseCode = 00 |
Vous pouvez livrer la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus bancaire acquéreur | responseCode = 05 |
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. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus carte incorrecte | responseCode = 12 |
Les données de la carte sélectionnée dans le wallet Visa Checkout ne sont pas correctes. |
| Refus fraude acquéreur | responseCode = 34 |
Autorisation refusée pour cause de fraude. Ne livrez pas la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus nombre max essais atteint | responseCode = 75 |
Le client a fait plusieurs tentatives qui ont toutes échouées. Ceci inclut les essais avec Visa Checkout. |
| Refus suite problème technique | responseCode = 90, 99 acquirerResponseCode = 90 à 98 |
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. Ceci inclut les cas d'erreur de connexion avec les services Visa en charge du wallet Visa Checkout. |
Le tableau suivant liste les données prenant des valeurs spécifiques dans la réponse renvoyée par WL Sips lors d'un paiement Visa Checkout :
| Champs de la réponse | Valeur |
|---|---|
| walletType | VISACHECKOUT |
| panEntryMode | WALLET |
| paymentMeanBrand | Toujours valorisé à VISACHECKOUT. |
| paymentMeanType | Toujours valorisé à WALLET. |
| issuerWalletInformation | Valeur du CallID Visa Checkout (permet d'identifier la transaction auprès de de Visa) |
Gérer les refus
Cette fonctionnalité vous permet d’augmenter votre taux de conversion dans le cas de paiement refusé car elle évite que le client revienne sur votre site puis relance à nouveau tout le processus de paiement.
Effectuer un paiement Visa Checkout avancé avec Sips Paypage
Le processus de paiement avancé pour Sips Paypage est décrit ci-dessous :
Intégrer le bouton Visa Checkout
Vous devez intégrer le bouton Visa Checkout en suivant les préconisations de Visa (cf. §Lightbox Visa Checkout).
Parmi les informations récupérées sur votre site après la sélection d'un moyen de paiement dans le wallet Visa Checkout par votre client, il y a la donnée CallID qui référence le dit-moyen de paiement. C'est cette donnée que vous devez fournir ensuite dans la requête de paiement à WL Sips.
Vous pouvez aussi récupérer d'autres informations, comme la marque du moyen de paiement sélectionné par le client (VISA, MASTERCARD ou AMEX).
Paramétrer la requête de paiement avancé
Le champ suivant est utilisé dans le cas d'un paiement Visa Checkout avancé :
| Nom du champ | Remarque / règles |
|---|---|
| visaCheckoutCallID | Contient la valeur du CallID Visa Checkout obtenu après déclenchement du bouton Visa Checkout et retour de la Lightbox Visa Checkout. |
Analyser la réponse
Le tableau suivant récapitule les différents cas de réponses possibles selon les événements d'utilisation du wallet Visa Checkout en mode standard :
| État | Champs de la réponse | Action à réaliser |
|---|---|---|
| Paiement accepté | responseCode = 00 acquirerResponseCode = 00 |
Vous pouvez livrer la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus bancaire acquéreur | responseCode = 05 |
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. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus carte incorrecte | responseCode = 12 |
Les données de la carte sélectionnée dans le wallet Visa Checkout ne sont pas correctes. |
| Refus fraude acquéreur | responseCode = 34 |
Autorisation refusée pour cause de fraude. Ne livrez pas la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus nombre max essais atteint | responseCode = 75 |
Le client a fait plusieurs tentatives qui ont toutes échouées. Ceci inclut les essais avec Visa Checkout. |
| Refus suite problème technique | responseCode = 90, 99 acquirerResponseCode = 90 à 98 |
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. Ceci inclut les cas d'erreur de connexion avec les services Visa en charge du wallet Visa Checkout. |
Le tableau suivant liste les données prenant des valeurs spécifiques dans la réponse renvoyée par WL Sips lors d'un paiement Visa Checkout :
| Champs de la réponse | Valeur |
|---|---|
| walletType | VISACHECKOUT |
| panEntryMode | WALLET |
| paymentMeanBrand | Toujours valorisé à VISACHECKOUT. |
| paymentMeanType | Toujours valorisé à WALLET. |
| issuerWalletInformation | Valeur du CallID Visa Checkout (permet d'identifier la transaction auprès de de Visa) |
Gérer les refus
Cette fonctionnalité vous permet d’augmenter votre taux de conversion dans le cas de paiement refusé car elle évite que le client revienne sur votre site puis relance à nouveau tout le processus de paiement.
Effectuer un paiement Visa Checkout avec Sips Office
Le processus de paiement pour Sips Office est décrit ci-dessous :
Intégrer le bouton Visa Checkout
Vous devez intégrer le bouton Visa Checkout en suivant les préconisations de Visa (cf. §Lightbox Visa Checkout).
Parmi les informations récupérées sur votre site après la sélection d'un moyen de paiement dans le wallet Visa Checkout par votre client, il y a la donnée CallID qui référence le dit-moyen de paiement. C'est cette donnée que vous devez fournir ensuite dans la requête de paiement à WL Sips.
Vous pouvez aussi récupérer d'autres informations, comme la marque du moyen de paiement sélectionné par le client (VISA, MASTERCARD ou AMEX).
Paramétrer la requête de paiement
Pour effectuer un paiement avec Sips Office, vous devez utiliser la méthode cardOrder.
Dans le cas d’un paiement non sécurisé par 3-D Secure, les champs suivants doivent être renseignés :
| Nom du champ | Remarques / règles |
|---|---|
| CardNumber | Doit contenir la valeur du CallID obtenu du wallet Visa Checkout |
| cardCSCValue | Obligatoire dans certains pays (3 positions pour une carte VISA ou MASTERCARD, 4 positions pour une carte AMEX). |
| paymentMeanBrand | Doit être valorisé avec VISACHECKOUT. |
Analyser la réponse
Le tableau suivant récapitule les différents cas de réponses possibles selon les événements d'utilisation du wallet Visa Checkout en mode standard :
| État | Champs de la réponse | Action à réaliser |
|---|---|---|
| Paiement accepté | responseCode = 00 acquirerResponseCode = 00 |
Vous pouvez livrer la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus bancaire acquéreur | responseCode = 05 |
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. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus carte incorrecte | responseCode = 12 |
Les données de la carte sélectionnée dans le wallet Visa Checkout ne sont pas correctes. |
| Refus fraude acquéreur | responseCode = 34 |
Autorisation refusée pour cause de fraude. Ne livrez pas la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus suite problème technique | responseCode = 90, 99 acquirerResponseCode = 90 à 98 |
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. Ceci inclut les cas d'erreur de connexion avec les services Visa en charge du wallet Visa Checkout. |
Le tableau suivant liste les données prenant des valeurs spécifiques dans la réponse renvoyée par WL Sips lors d'un paiement Visa Checkout :
| Champs de la réponse | Valeur |
|---|---|
| walletType | VISACHECKOUT |
| panEntryMode | WALLET |
| paymentMeanBrand | Libellé du moyen de paiement choisi dans le wallet Visa Checkout (VISA, MASTERCARD ou AMEX) |
| issuerWalletInformation | Valeur du CallID Visa Checkout (permet d'identifier la transaction auprès de de Visa) |
Effectuer un paiement 3-D Secure Visa Checkout avec Sips Office
Le processus de paiement 3-D Secure pour Sips Office est décrit ci-dessous :
Intégrer le bouton Visa Checkout
Vous devez intégrer le bouton Visa Checkout en suivant les préconisations de Visa (cf. §Lightbox Visa Checkout).
Parmi les informations récupérées sur votre site après la sélection d'un moyen de paiement dans le wallet Visa Checkout par votre client, il y a la donnée CallID qui référence le dit-moyen de paiement. C'est cette donnée que vous devez fournir ensuite dans la requête de paiement à WL Sips.
Vous pouvez aussi récupérer d'autres informations, comme la marque du moyen de paiement sélectionné par le client (VISA, MASTERCARD ou AMEX).
Paramétrer la requête de paiement
Pour effectuer un paiement 3-D Secure avec Sips Office, vous devez utiliser la méthode cardCheckEnrollment en premier pour initier l'authentification du paiement, puis la méthode cardValidateAuthenticationAndOrder pour valider l'authentification du paiement et effectuer l'autorisation. C'est la réponse à cette dernière qui contient les informations relatives à Visa Checkout.
Dans le cas d’un paiement sécurisé par 3-D Secure, les champs suivants doivent être renseignés dans la méthode cardOrder en plus des champs habituels :
| Nom du champ | Remarques/règles |
|---|---|
| CardNumber | Doit contenir la valeur du CallID obtenu du wallet Visa Checkout |
| paymentMeanBrand | VISACHECKOUT |
| cardCSCValue | Obligatoire dans certains pays (3 positions pour une carte VISA ou MASTERCARD, 4 positions pour une carte AMEX). |
La méthode cardValidateAuthenticationAndOrder s'utilise sans modification par rapport à d'habitude (référez-vous au guide d'utilisation de Sips Office).
Analyser la réponse
Le tableau suivant récapitule les différents cas de réponses possibles selon les événements d'utilisation du wallet Visa Checkout en mode standard :
| État | Champs de la réponse | Action à réaliser |
|---|---|---|
| Paiement accepté | responseCode = 00 acquirerResponseCode = 00 |
Vous pouvez livrer la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus bancaire acquéreur | responseCode = 05 |
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. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus carte incorrecte | responseCode = 12 |
Les données de la carte sélectionnée dans le wallet Visa Checkout ne sont pas correctes. |
| Refus fraude acquéreur | responseCode = 34 |
Autorisation refusée pour cause de fraude. Ne livrez pas la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus suite problème technique | responseCode = 90, 99 acquirerResponseCode = 90 à 98 |
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. Ceci inclut les cas d'erreur de connexion avec les services Visa en charge du wallet Visa Checkout. |
Le tableau suivant liste les données prenant des valeurs spécifiques dans la réponse renvoyée par WL Sips lors d'un paiement Visa Checkout :
| Champs de la réponse | Valeur |
|---|---|
| walletType | VISACHECKOUT |
| panEntryMode | WALLET |
| paymentMeanBrand | Libellé du moyen de paiement choisi dans le wallet Visa Checkout (VISA, MASTERCARD ou AMEX) |
| issuerWalletInformation | Valeur du CallID Visa Checkout (permet d'identifier la transaction auprès de de Visa) |
Effectuer un paiement Visa Checkout avec Sips In-App
Le processus de paiement pour Sips In-App est décrit ci-dessous :
Intégrer le bouton Visa Checkout
Vous devez intégrer le bouton Visa Checkout en suivant les préconisations de Visa (cf. §Lightbox Visa Checkout).
Parmi les informations récupérées sur votre site après la sélection d'un moyen de paiement dans le wallet Visa Checkout par votre client, il y a la donnée CallID qui référence le dit-moyen de paiement. C'est cette donnée que vous devez fournir ensuite dans la requête de paiement à WL Sips.
Vous pouvez aussi récupérer d'autres informations, comme la marque du moyen de paiement sélectionné par le client (VISA, MASTERCARD ou AMEX).
Paramétrer la requête de paiement
Pour effectuer un paiement avec Sips In-App, vous devez utiliser la méthode cardOrder.
Dans le cas d’un paiement non sécurisé par 3-D Secure, les champs suivants doivent être renseignés :
| Nom du champ | Remarques / règles |
|---|---|
| CardNumber | Doit contenir la valeur du CallID obtenu du wallet Visa Checkout |
| paymentMeanBrand | VISACHECKOUT |
| cardCSCValue | Obligatoire dans certains pays (3 positions pour une carte VISA ou MASTERCARD, 4 positions pour une carte AMEX). |
Analyser la réponse
Le tableau suivant récapitule les différents cas de réponses possibles selon les événements d'utilisation du wallet Visa Checkout en mode standard :
| État | Champs de la réponse | Action à réaliser |
|---|---|---|
| Paiement accepté | responseCode = 00 acquirerResponseCode = 00 |
Vous pouvez livrer la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus bancaire acquéreur | responseCode = 05 acquirerResponseCode = XX |
L’autorisation est refusée pour un motif non lié à la fraude. Vous pouvez proposer à votre client de payer avec autre moyen de paiement en générant une nouvelle requête. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus carte incorrecte | responseCode = 12 acquirerResponseCode = XX |
Les données de la carte sélectionnée dans le wallet Visa Checkout ne sont pas correctes. |
| Refus fraude acquéreur | responseCode = 34 acquirerResponseCode = XX |
Autorisation refusée pour cause de fraude. Ne livrez pas la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus suite problème technique | responseCode = 90, 99 acquirerResponseCode = 90 à 98 |
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. Ceci inclut les cas d'erreur de connexion avec les services Visa en charge du wallet Visa Checkout. |
Le tableau suivant liste les données prenant des valeurs spécifiques dans la réponse renvoyée par WL Sips lors d'un paiement Visa Checkout :
| Champs de la réponse | Valeur |
|---|---|
| walletType | VISACHECKOUT |
| panEntryMode | WALLET |
| paymentMeanBrand | Libellé du moyen de paiement choisi dans le wallet Visa Checkout (VISA, MASTERCARD ou AMEX) |
| issuerWalletInformation | Valeur du CallID Visa Checkout (permet d'identifier la transaction auprès de de Visa) |
Effectuer un paiement 3-D Secure Visa Checkout avec Sips In-App
Le processus de paiement 3-D Secure pour Sips In-App est décrit ci-dessous :
Intégrer le bouton Visa Checkout
Vous devez intégrer le bouton Visa Checkout en suivant les préconisations de Visa (cf. §Lightbox Visa Checkout).
Parmi les informations récupérées sur votre site après la sélection d'un moyen de paiement dans le wallet Visa Checkout par votre client, il y a la donnée CallID qui référence le dit-moyen de paiement. C'est cette donnée que vous devez fournir ensuite dans la requête de paiement à WL Sips.
Vous pouvez aussi récupérer d'autres informations, comme la marque du moyen de paiement sélectionné par le client (VISA, MASTERCARD ou AMEX).
Paramétrer la requête de paiement
Pour effectuer un paiement 3-D Secure avec Sips In-App, vous devez utiliser la méthode cardCheckEnrollment en premier pour initier l'authentification du paiement, puis la méthode cardValidateAuthenticationAndOrder pour valider l'authentification du paiement et effectuer l'autorisation. C'est la réponse à cette dernière qui contient les informations relatives à Visa Checkout.
Dans le cas d’un paiement sécurisé par 3-D Secure, les champs suivants doivent être renseignés dans la méthode cardOrder en plus des champs habituels :
| Nom du champ | Remarques / règles |
|---|---|
| CardNumber | Doit contenir la valeur du CallID obtenu du wallet Visa Checkout |
| paymentMeanBrand | VISACHECKOUT |
| cardCSCValue | Obligatoire dans certains pays (3 positions pour une carte VISA ou MASTERCARD, 4 positions pour une carte AMEX). |
La méthode cardValidateAuthenticationAndOrder s'utilise sans modification par rapport à d'habitude (référez-vous au guide d'utilisation de Sips In-App).
Analyser la réponse
Le tableau suivant récapitule les différents cas de réponses possibles selon les événements d'utilisation du wallet Visa Checkout en mode standard :
| État | Champs de la réponse | Action à réaliser |
|---|---|---|
| Paiement accepté | responseCode = 00 acquirerResponseCode = 00 |
Vous pouvez livrer la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus bancaire acquéreur | responseCode = 05 acquirerResponseCode = XX |
L’autorisation est refusée pour un motif non lié à la fraude. Vous pouvez proposer à votre client de payer avec autre moyen de paiement en générant une nouvelle requête. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus carte incorrecte | responseCode = 12 acquirerResponseCode = XX |
Les données de la carte sélectionnée dans le wallet Visa Checkout ne sont pas correctes. |
| Refus fraude acquéreur | responseCode = 34 acquirerResponseCode = XX |
Autorisation refusée pour cause de fraude. Ne livrez pas la commande. Ceci ne diffère pas d'un paiement sans Visa Checkout. |
| Refus suite problème technique | responseCode = 90, 99 acquirerResponseCode = 90 à 98 |
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. Ceci inclut les cas d'erreur de connexion avec les services Visa en charge du wallet Visa Checkout. |
Le tableau suivant liste les données prenant des valeurs spécifiques dans la réponse renvoyée par WL Sips lors d'un paiement Visa Checkout :
| Champs de la réponse | Valeur |
|---|---|
| walletType | VISACHECKOUT |
| panEntryMode | WALLET |
| paymentMeanBrand | Libellé du moyen de paiement choisi dans le wallet Visa Checkout (VISA, MASTERCARD ou AMEX) |
| issuerWalletInformation | Valeur du CallID Visa Checkout (permet d'identifier la transaction auprès de de Visa) |
Gérer vos transactions Visa Checkout
Opérations de caisse disponibles
Les opérations suivantes sont disponibles sur les transactions Visa Checkout. Ce sont celles disponibles pour les transactions effectuées habituellement avec les moyens de paiement supportés par Visa Checkout et WL Sips (Visa, Mastercard et American Express), avec de légères différences de comportement :
| Gestion de caisse | ||
|---|---|---|
| Annulation | V | WL Sips n'informe pas Visa de l'annulation de la
transaction (l'annulation a bien lieu). |
| Validation | V | WL Sips n'informe pas Visa de la validation de la
transaction (la validation a bien lieu). |
| Remboursement | V | WL Sips n'informe pas
Visa du remboursement de la transaction (le remboursement a bien
lieu). |
| Duplication | V | La duplication d'une transaction Visa Checkout est
possible, et la transaction dupliquée est considérée comme une
transaction Visa Checkout, attachée au même CallID Visa
Checkout. WL Sips informe Visa de la
duplication de la transaction. |
| Recyclage | X | |
| Crédit | X | |
Dupliquer une transaction Visa Checkout
Le processus de duplication d'une transaction Visa Checkout se déroule comme une duplication classique, la transaction résultante étant considérée comme une transaction Visa Checkout attachée au même CallID Visa Checkout que la transaction initiale.
Le CallId est disponible dans le champ issuerWalletInfo (Renseignements sur l'émetteur du portefeuille).
Consulter ses transactions Visa Checkout
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 Visa Checkout 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 |
Sips Office Extranet
Vous pouvez consulter vos transactions Visa Checkout et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.
Voici le détail d’une transaction Visa Checkout. Certaines informations spécifiques comme le CallId Visa Checkout sont affichées dans la zone « Renseignements sur l'émetteur du portefeuille ».
