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).

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 .

Note: Votre compte Visa Checkout ne pourra être utilisé que si vous avez par ailleurs un contrat VAD (pour au moins l'un des moyens de paiement éligibles à Visa Checkout. Merci de vous référer au paragraphe Fonctionnalités disponibles ) configuré dans 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).
Note: Les captures des pages Visa Checkout sont données ici à titre indicatif. Il se peut que Visa modifie ses pages.

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 « User s » ;
  • à 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 :

Note: Dans ce cas, le bouton Visa Checkout est intégré dans les pages de WL Sips .
En raison de des Règles de sécurité d'utilisation du bouton Visa Checkout, le mode Sips iFrame de Sips Paypage n'est pas compatible avec Visacheckout : les pages de paiement Sips Paypage en mode Sips iFrame avec le moyen de paiement Visa Checkout ne s'afficheront pas.

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 :

Note: Dans ce cas, le bouton Visa Checkout est intégré dans vos pages, de manière à récupérer la donnée Visa Checkout CallID et la transmettre dans la requête d'appel à WL Sips .

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 :

Note: Dans ce cas, le bouton Visa Checkout est intégré dans vos pages, de manière à récupérer la donnée Visa Checkout CallID et la transmettre dans la requête d'appel à WL Sips .

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

paymentMeanBrand

VISACHECKOUT

cardCSCValue Obligatoire dans certains pays (3 positions pour une carte VISA ou MASTERCARD, 4 positions pour une carte AMEX).
Note: il n'est pas nécessaire de fournir la date de fin de validité du moyen de paiement (i.e. le champ cardExpiryDate doit rester vide).

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 :

Note: Dans ce cas, le bouton Visa Checkout est intégré dans vos pages, de manière à récupérer la donnée Visa Checkout CallID et la transmettre dans la requête d'appel à WL Sips .

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).
Note: Il n'est pas nécessaire de fournir la date de fin de validité du moyen de paiement (i.e. le champ cardExpiryDate doit rester vide).

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 :

Note: Dans ce cas, le bouton Visa Checkout est intégré dans votre application mobile, de manière à récupérer la donnée Visa Checkout CallID et la transmettre dans la requête d'appel à WL Sips .

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).
Note: Il n'est pas nécessaire de fournir la date de fin de validité du moyen de paiement (i.e. le champ cardExpiryDate doit rester vide).

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 :

Note: Dans ce cas, le bouton Visa Checkout est intégré dans votre application mobile, de manière à récupérer la donnée Visa Checkout CallID et la transmettre dans la requête d'appel à WL Sips .

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).
Note: Il n'est pas nécessaire de fournir la date de fin de validité du moyen de paiement (i.e. le champ cardExpiryDate doit rester vide).

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
Note: les transactions Visa Checkout sont visibles dans les journaux comme des transactions Visa, Mastercard ou American Expres, le champ paymentMeanBrand étant renseigné avec la valeur VISACHECKOUT.

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 ».