WL SIPS DOCS

Release 21.4

aller directement au contenu
Rechercher par mots clés

Intégration Carte Bancaire

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

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 CB dans WL Sips.

Ce document a pour objectif de vous aider à implémenter le moyen de paiement CB 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.

La France dispose de son propre réseau d'acceptation CB, distinct des réseaux mondiaux Visa et Mastercard. La plupart des cartes françaises sont co-badgées CB+Visa ou CB+Mastercard, et disposent donc des 2 logos, CB et Visa ou Mastercard.

Pour payer avec une carte du réseau CB, le titulaire de carte doit fournir les renseignements détaillés sur sa carte, à savoir :

  • le numéro de carte ;
  • la date d’expiration ;
  • le cryptogramme visuel ;

Avec l'entrée en vigueur de la directive européenne DSP2, l'authentification 3-D Secure devient obligatoire. Lors d'un paiement, le client devra donc prouver qu'il est bien le titulaire de la carte CB utilisée. La manière de procéder à l'authentification dépend de la banque émettrice de la carte et du niveau de risque du paiement.

Canaux de paiement
Internet V Canal de paiement par défaut
MAIL_ORDER, TELEPHONE_ORDER V
Télécopie V
SVI V
Typologies de paiement
Paiement immédiat X
Paiement en fin de journée V Méthode par défaut
Paiement différé V Limité à 99 jours (sauf pour 3-D Secure qui est limité à 6 jours du fait des règles liées au transfert de responsabilité).
Paiement à l'expédition V Limité à 99 jours (sauf pour 3-D Secure qui est limité à 6 jours du fait des règles liées au transfert de responsabilité).
Paiement en plusieurs fois V
Paiement par abonnement V
Paiement par fichier V
Paiement OneClick V

Les réseaux CB, Visa et MasterCard participent au programme 3-D Secure qui assure l’authentification du titulaire de carte lors des paiements en ligne afin de limiter la fraude.

Les réseaux CB, Visa et MasterCard font référence au 3-D Secure en utilisant respectivement les slogans « FAST’R by CB », « Visa Secure » et « MasterCard ID Check » (« Verified By Visa » et «MasterCard Secure Code » en 3-D Secure 1.0). Dès lors que votre boutique est inscrite au programme 3-D Secure, chaque transaction de paiement est soumise à l’authentification du titulaire de carte. La banque qui a émis la carte ainsi que le réseau concerné (CB, Visa ou MasterCard) seront impliqués dans ce processus d’authentification.

Ce programme offre plusieurs avantages. En effet, vous êtes assuré que votre client est bien le titulaire de carte car celui-ci s’authentifie auprès de sa banque. Sur ce type de transactions, vous pouvez bénéficier de la garantie de paiement. Cependant, cette garantie dépend des réseaux (CB, Visa et MasterCard) et de votre acquéreur.

Dans le cas d’une demande de paiement différé avec une authentification 3-D Secure, le délai ne pourra excéder 6 jours (si le délai que vous avez demandé excède les 6 jours, il sera automatiquement ramené à 6 jours par WL Sips pendant la cinématique de paiement).

Lorsque vous souscrivez au programme d’authentification 3-D Secure, l’ensemble des paiements pour lesquels le programme est applicable sera soumis à cette authentification. Il est cependant possible de désactiver le programme d’authentification 3-D Secure à la demande, via l’alimentation d’un flag dans la requête.

Attention: avec la mise en place de la directive européenne DSP2, l'authentification de l'acheteur lors d'un paiement devient obligatoire. Si vous choisissez néanmoins de désactiver l'authentification 3-D Secure, vous vous exposez à des refus de paiement type "soft decline" (acquirerResponseCode = A1).
Attention: vous devez auparavant être inscrit à l’option permettant de désactiver le programme 3-D Secure à la demande.
Cette désactivation à la demande n’est possible que sur l’interface Sips Paypage.
Aucun transfert de responsabilité ne s’appliquera en cas de désactivation de l’authentification 3-D Secure.

Pour une carte du réseau CB, l’autorisation est valable pendant 6 jours.

Dans le cas d’un paiement différé d’une durée de 6 jours ou moins, WL Sips effectue auprès de l’acquéreur une demande d’autorisation sur le montant total de la transaction, qui sera ensuite remisée en fonction du moyen de paiement que vous avez demandé.

Dans le cas d’un paiement différé (non 3-D Secure) d’une durée supérieure à 6 jours, WL Sips effectue deux demandes d’autorisation auprès de l’acquéreur :

  • la 1ère demande d’autorisation appelée « demande de renseignement », effectuée en ligne, qui permet de vérifier le statut et la validité de la carte sans en impacter le plafond d’autorisation ;
Note: la demande de renseignement doit être supportée par votre acquéreur. Dans le cas contraire, une autorisation réelle d'un petit montant est effectuée (par exemple : 2,00 EUR pour la zone euro) afin de vérifier la validité de la carte.
  • la 2ème demande d’autorisation du montant réel, effectuée lors de la remise en banque.

Les paiements sont remis en banque conformément aux modalités de paiement que vous avez définies. En standard, la remise en banque est déclenchée la nuit à partir de 22h00, fuseau horaire CET (heure d’Europe Centrale), via un échange de fichier avec l’acquéreur.

Pour les canaux INTERNET et MOTO, uniquement sur l’interface Sips Office et Sips Office Batch, vous pouvez effectuer une demande de renseignement de votre propre initiative (non conditionnée au délai du paiement différé). Pour ce faire, il vous suffit de valoriser le montant de la transaction à « 0 ». WL Sips effectuera alors une demande de renseignement auprès de l’acquéreur, la transaction sera stockée dans le système d’information WL Sips dans un état final, et ne sera pas remisée en banque.

Attention: la demande de renseignement doit être supportée par votre acquéreur. Dans le cas contraire, une tentative de demande de renseignement à votre initiative entraînera une demande d’autorisation standard d’un montant de « 0 ».

Dans le cas où vous disposez de l’option nécessaire, une vérification de la présence de la carte utilisée dans la liste des cartes en opposition fournie par l’acquéreur est effectuée. Ce contrôle sera fait lors de la validation d’une transaction ou lors de la remise en banque.

Si la carte fournie est en opposition lors du contrôle de validation, l’opération est refusée.

Si la carte fournie est en opposition lors du contrôle avant envoi en banque, la transaction ne sera pas remisée.

Attention: ce contrôle doit être supporté par votre acquéreur. Le contrôle avant validation n’est effectué que si la transaction n’a pas été autorisée le jour-même et que l’autorisation est toujours valide.

La solution WL Sips 2.0 en tant que solution d’acceptation de paiement, est assujettie à la réglementation européenne MIF (JO EU 2015/751 L123 du 19/05/2015). Parmi ces règles, la « Sélection de la Marque » vous impose de proposer à vos clients titulaires d’une carte cobadgée le choix de la marque au moment du paiement, ce qui impacte la page de paiement.

Une carte cobadgée est une carte qui supporte au moins deux marques. La plupart des cartes émises en France sont cobadgées avec la marque CB. Dans le cas de l’acceptation CB, les combinaisons possibles de cartes cobadgées sont :

  • CB + Visa
  • CB + MasterCard
  • CB + VPAY
  • CB + Maestro
  • CB + Visa Electron

Ainsi vous devez permettre le choix de la marque de vos cartes cobadgées au client titulaire.

A titre d’illustration, l’écran ci-dessous présente un exemple de carte cobadgée CB + Visa avec CB en marque par défaut. Le client peut changer la marque en cliquant sur le lien en bas de l’écran.


mif

Attention: pour les cartes non cobadgées, aucun choix de marque n’est proposé.
Si vous avez intégré la solution WL Sips avant la migration MIF / Sélection de la marque, les marques VPay, Electron sont assimilées à la marque Visa et la marque Maestro à celle de MasterCard.
Si vous souhaitez distinguer les marques VPay, Visa Electron et Maestro, vous devez le préciser au moment de l’inscription de la boutique sur WL Sips ou en faire la demande auprès de Worldline. L’identification de ces marques impacte la réponse de paiement retournée : le champ paymentMeanBrand peut prendre une des nouvelles valeurs VPAY, VISA_ELECTRON ou MAESTRO.
Lorsqu'une demande de duplication est émise sur une transaction ayant bénéficié d’un processus de sélection de la marque, la nouvelle transaction bénéficiera du résultat de la sélection de la transaction initiale.

La demande de redressement consiste à annuler la modification du plafond d'autorisation de la carte du porteur.

Cette demande de redressement est toujours liée à une demande d'autorisation.

Tip: la demande de redressement n'est possible que pour les acquéreurs le supportant (nous contacter pour connaître la liste).

La demande de redressement est envoyée à l'acquéreur dans les cas suivants :

  • le commerçant annule complètement la transaction (soit via une annulation totale, ou via une succession d'annulations partielles);
  • le serveur d'autorisation de l'acquéreur n'a pas répondu favorablement à une demande d'autorisation pour les raisons suivantes : « approuver après identification » ou « approuvée partiellement » ;
  • aucune réponse n'a été reçue suite à une demande d'autorisation (timeout).

Afin de proposer CB sur votre site Web, vous devez souscrire un contrat de Vente A Distance auprès de votre banque acquéreur. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information. Si vous acceptez les paiements INTERNET et MOTO, indiquez-le à votre acquéreur, car certains acquéreur auront besoin de vous faire souscrire 2 contrats distincts.

WL Sips vous offre trois solutions pour intégrer les moyens de paiement CB :

  • 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 Office Batch qui vous permet de traiter des paiements par échange de fichiers.

Les modes de remise disponibles pour une transaction CB 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 expire donc automatiquement.

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


ProcessPayment-VISA&MASTERCARD-FR

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


ProcessPaypage-VISA&MASTERCARD-FR

Les champs suivants ont un comportement particulier :

Nom du champ Remarque / règles
statementReference La valeur envoyée dans ce champ apparaîtra dans votre relevé bancaire (disponible seulement pour certains acquéreurs)
Note: le champ paymeantMeanBrand peut être valorisé à VISA pour les cartes Vpay et Electron et à MASTERCARD pour les cartes Maestro.
Note: pour les paiements 3-D Secure v2, il est recommandé de renseigner certains champs afin de favoriser le frictionless. Veuillez consulter le guide 3-D Secure.

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).
cardProductCode = (voir le Dictionnaire des données).
cardProductName = (voir le Dictionnaire des données).
cardProductProfile = (voir le Dictionnaire des données).
cardProductUsageLabel = (voir le Dictionnaire des données).
virtualCardIndicator = (voir le Dictionnaire des données).
issuerCode = (voir le Dictionnaire des données).
issuerCountryCode = (voir le Dictionnaire des données).
paymentMeanBrand = CB, MASTERCARD ou VISA
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.
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 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 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.

Dans le cas Sips Paypage, la cinématique de paiement et le choix de la marque sont gérés par WL Sips. En retour WL Sips informe le commerçant du choix de la marque effectué par le client par les champs suivants :

Champ Description
paymentMeanBrand Marque sélectionnée pour l’acceptation de la transaction.
paymentMeanBrandSelectionStatus

Méthode de sélection de la marque. Ce champ prend les valeurs suivantes :

  • Vide : choix de la marque non activé pour la boutique.
  • « NOT_APPLICABLE » : choix de la marque activé mais transaction non éligible.
  • « APPLIED_DEFAULT » : acceptation de la marque par défaut (sans aucune action de sélection du porteur).
  • « APPLIED_HOLDER » : le porteur choisi explicitement la marque.

Afin d’activer le choix de la marque, vous devez au préalable :

  1. Donner vos choix de marque par défaut pour chaque combinaison de carte cobadgée afin de configurer la sélection de la marque sur le serveur WL Sips :
    • CB + VISA = CB ou Visa,
    • CB + MASTERCARD = CB ou MasterCard,
    • CB + VPAY = CB ou VPay,
    • CB + MAESTRO = CB ou Maestro,
    • CB + VISA ELECTRON = CB ou Visa Electron.
  2. Si vous utilisez votre propre personnalisation (via l’usage d’une CSS commerçant), vous assurer de la compatibilité de cette personnalisation avec le choix de la marque.

Si vous hébergez vous-même la page de sélection des moyens de paiement, vous devez éviter la confusion entre la sélection du moyen de paiement et le choix de la marque : par exemple le groupement des logos carte.


Payment-mean-CB

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


ProcessOffice-VISA&MASTERCARD-FR

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 Obligatoire
cardExpiryDate Obligatoire, si précisé sur la carte.
cardCSCValue
Le CVV est facultatif en cas de transactions utilisant les canaux de paiement MOTO, MAIL_ORDER ou TELEPHONE_ORDER.
paymentMeanBrand Si vous avez mis en œuvre la règlementation européenne MIF – sélection de la marque, veuillez vous référer au paragraphe Sélection de la marque sur Sips Office.
Le champ paymeantMeanBrand peut être valorisé à VISA pour les cartes Vpay et Electron et à MASTERCARD pour les cartes Maestro.

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).
cardData.cardProductCode = (voir le Dictionnaire des données).
cardData.cardProductName = (voir le Dictionnaire des données).
cardData.cardProductProfile = (voir le Dictionnaire des données).
cardData.cardProductUsageLabel = (voir le Dictionnaire des données).
cardData.virtualCardIndicator = (voir le Dictionnaire des données).
cardData.issuerCode = (voir le Dictionnaire des données).
cardData.issuerCountryCode = (voir le Dictionnaire des données).
cardData.issuerName = (voir le Dictionnaire des données).
paymentMeanBrand = CB, MASTERCARD ou VISA
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.

Dans le cas de Sips Office et Sips In-App, vous pouvez gérer la sélection de la marque afin d'accepter la transaction. Vous devez détecter les cartes cobadgées avec la marque CB et proposer un choix de la marque au client porteur de carte, puis envoyer ce choix à WL Sips en renseignant les champs suivants :

Champ Description
paymentMeanBrand
Marque sélectionnée pour l’acceptation de la transaction. Champ obligatoire dans un contexte de Sélection de la marque (champ paymentMeanBrandSelectionStatus renseigné).
  • Si le porteur n’a pas effectué de choix explicite de la marque alors vous indiquez dans ce champ la marque par défaut proposée.
  • En cas d’erreur de marque, la transaction est refusée (code réponse 14).
  • Si le champ paymentMeanBrandSelectionStatus est renseigné et le champ paymentMeanBrand est vide, alors la transaction est refusée (code réponse 30).
paymentMeanBrandSelectionStatus
Méthode de sélection de la marque. Ce champ prend les valeurs suivantes :
  • Vide : choix de la marque non activé par la boutique (valeur par défaut).
  • « NOT_APPLICABLE » : choix de la marque activé mais transaction non éligible.
  • « APPLIED_DEFAULT » : acceptation de la marque par défaut (sans aucune action de sélection du porteur).
  • « APPLIED_HOLDER » : Le porteur choisi explicitement la marque.

Pour la détection des cartes cobadgées avec CB, vous devez demander à votre acquéreur de recevoir le fichier de référentiel des cartes appelé « Liste d’acceptation Enrichie VADS (pour le Grand Commerce / PAT) » (identifiant du flux SICB – CNFFHVB). Cette liste vous permet de reconnaître les marques d’une carte à partir de votre BIN.

Enfin vous devez éviter la confusion entre la sélection du moyen de paiement et le choix de la marque : par exemple le groupement des logos carte.


Payment-mean-CB

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

Gestion de caisse
Annulation V En fonction de votre acquéreur, une annulation totale peut provoquer l'envoi d'une demande de redressement.
Validation V Validation possible sur le montant partiel de la transaction.
Remboursement V Remboursement possible sur le montant partiel de la transaction et sur les montants supérieurs au montant initial (remboursement illimité).
Duplication V
Recyclage V
Crédit V

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é :


ProcessCashManagement-VISA&MASTERCARD-FR

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 CB 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 CB, le champ paymentMeanBrand est renseigné avec la valeur CB.

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

Voici le détail d'une transaction CB :


ScreenSOE-CB-FR

Ce site utilise des cookies 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 cookies sur votre appareil.

Paramètres