WL SIPS DOCS

Release 22.3

aller directement au contenu

Rechercher par mots clés

Intégration 3xCBCofidis

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

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

Cofidis, société Française spécialisée dans le crédit, offre un moyen de paiement permettant de payer en 3 ou 4 fois des achats en ligne, avec une carte bancaire.

Lors d’un paiement 3xCBCofidis, le client est redirigé vers l’application d’ouverture de dossier de crédit Cofidis. A la fin de sa saisie, il est informé en ligne du résultat de son paiement.

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 V
Paiement en fin de journée V
Paiement différé V Limité à 6 jours.
Paiement à l'expédition V Limité à 6 jours.
Paiement en plusieurs fois X
Paiement par abonnement X
Paiement par fichier X
Paiement OneClick X
Gestion des devises
Acceptation multidevise X EUR (978) uniquement
Règlement en devise X EUR (978) uniquement

Le client sélectionne le moyen de paiement 3xCB Cofidis.

Il est ensuite redirigé vers la page de la saisie des informations requises :





Le ticket de paiement s’affiche, puis le client retourne sur votre site Web.

Afin de proposer le moyen de paiement 3xCB Cofidis sur votre site Web, vous devez souscrire un contrat d’acceptation auprès de Cofidis. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Vous pouvez proposer le moyen de paiement 3xCB Cofidis au travers de l’interface Sips Paypage.

Les modes de remise disponibles pour une transaction 3xCBCofidis 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.
  • Mode immédiat : la remise de la transaction est réalisée au moment de l’acceptation du paiement en ligne.

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 3xCBCofidis

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.

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


Étapes d'un paiement 3xCBCofidis 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 3xCBCofidis ou 4xCBCofidis et saisit son numéro de carte. 3) Il est redirigé vers la page Cofidis 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.

Cette partie présente l’ensemble des données échangées entre les différents acteurs (commerçant, WL Sips, Cofidis) lors d’une requête de paiement 3xCBCofidis.

Certains champs que vous avez renseignés permettent de préremplir le formulaire hébergé par Cofidis.

Nom du champ Remarques / règles
captureDay La valeur envoyée dans la requête doit être de 6 au maximum.
Une valeur supérieure sera forcée à 6.
paymentPattern La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE_SHOT.
orderId Obligatoire : 15 caractères alphanumériques maximum.
amount Formaté en centimes : 9 chiffres maximum.

paymentMeanData.cofidis3x.preScoreValue

Facultatif. (7 caractères numériques maximum)
Votre notation préalable du risque sur la transaction.
La valorisation de ce champ devra se faire en accord avec Cofidis.

customerIpAddress

Facultatif.
Adresse IP de l’acheteur.
subMerchantName Identifiant du commerçant chez le Facilitateur de paiement dans le cadre d'une offre de Collecting ou de Marketplace
customerContact Obligatoire.
Voir les tableaux ci-dessous pour plus de détails.
customerId Facultatif (15 caractères maximum)

Identifiant du client.

customerData Facultatif.
Voir les tableaux ci-dessous pour plus de détails.
customerAddress Facultatif.
Voir les tableaux ci-dessous pour plus de détails.
customerLanguage Permet de choisir la langue utilisée sur les pages WL Sips et Cofidis.
shoppingCartDetail Facultatif.
Voir les tableaux ci-dessous pour plus de détails.
deliveryData Facultatif.
Voir les tableaux ci-dessous pour plus de détails.
deliveryContact Facultatif.
Voir les tableaux ci-dessous pour plus de détails.
customerAccountHistoric Facultatif.
Voir les tableaux ci-dessous pour plus de détails.
travelData Facultatif.
Voir les tableaux ci-dessous pour plus de détails.
Attention: Cofidis vous transmet des préconisations pour renseigner les champs preScoreValue et cofidisPrivateData. Ces consignes ne sont pas contrôlées par WL Sips, car elles ne bloquent pas le traitement du paiement.

customerContact

Nom du champ Remarques / règles
customerContact.title Civilité du client (M, MME ou MLLE)
customerContact.firstname Prénom du client (32 caractères maximum)
customerContact.lastname Nom du client (32 caractères maximum)
customerContact.phone Numéro de téléphone fixe (10 caractères numériques maximum)
customerContact.mobile Numéro de téléphone mobile (10 caractères numériques maximum)
customerContact.email Obligatoire

Adresse email

customerData

Nom du champ Remarques / règles
customerData.birthDate Date de naissance
customerData.birthZipCode Département de naissance
customerData.birthCity Ville de naissance (32 caractères maximum)
customerData.birthCountry Pays de naissance
customerData.nationalityCountry Pays de nationalité
customerData.maidenName Nom de jeune fille (32 caractères maximum)

customerAddress

Nom du champ Remarques / règles

customerAddress.streetNumber

Numéro de la rue (5 caractères numériques maximum)
customerAddress.street Nom de la rue (40 caractères maximum)
customerAddress.streetAdditional1 Complément d’adresse (32 caractères maximum)
customerAddress.zipCode Code postal (5 caractères maximum)
customerAddress.city Ville (32 caractères maximum)
customerAddress.country Code du pays
customerAddress.postBox Boîte postale de l'adresse (8 caractères maximum)
customerAddress.state Etat/département de l'adresse (2 caractères numériques maximum)

shoppingCartDetail

Nom du champ Remarques / règles
shoppingCartDetail.shoppingCartTotalQuantity Quantité totale d'articles du panier (2 caractères numériques maximum)
shoppingCartDetail.discountAmount 1 si une remise à été appliquée, 0 sinon
shoppingCartDetail.shoppingCartItemList.itemX.productUnitAmount Montant unitaire du produit
shoppingCartDetail.shoppingCartItemList.itemX.​productDescription Description détaillée du produit commandé
shoppingCartDetail.shoppingCartItemList.itemX.productCategory Catégorie du produit commandé
shoppingCartDetail.shoppingCartItemList.itemX.productSKU Modèle du produit (20 caractères maximum)
shoppingCartDetail.shoppingCartItemList.itemX.​productCode Code du produit commandé (15 caractères maximum)
shoppingCartDetail.shoppingCartItemList.itemX.​productQuantity Quantité de produit dans le panier (3 caractères numériques maximum)
shoppingCartDetail.shoppingCartItemList.itemX.​productName Nom du produit commandé (20 caractères maximum)

deliveryData

Nom du champ Remarques / règles
deliveryData.deliveryChargeAmount Coût total des frais de livraison de la commande (7 caractères numériques maximum)
deliveryData.deliveryMethod

1 – Chez le commerçant

2 – Point de relai tiers

3 - Aéroport, gare, agence de voyage

4 – Transporteur (La Poste, Colissimo, UPS, transporteur privé)

5 – Billet électronique

6 – Casier, point retrait sans contrôle d'identité

7 – Autre

deliveryData.deliveryMode

S - Strandard

E – Express

I – Immediat

O - Autre

deliveryData.deliveryOperator Prestataire de livraison (50 caractères maximum)

deliveryAddress

Nom du champ Remarques / règles

deliveryAddress.streetNumber

Numéro de la rue
deliveryAddress.street Nom de la rue
deliveryAddress.streetAdditional1 Complément d’adresse
deliveryAddress.zipCode Code postal
deliveryAddress.city Ville
deliveryAddress.country Code du pays
deliveryAddress.postBox Boîte postale de l'adresse
deliveryAddress.state Etat/département de l'adresse (2 caractères numériques maximum)

deliveryContact

Nom du champ Remarques / règles
deliveryContact.mobile Numéro de téléphone mobile du contact (15 caractères maximum)

travelData

Nom du champ Remarques / règles
travelData.stayDataList.stayDataX.stayDepartureDateTime Date de départ du séjour
travelData.stayDataList.stayDataX.stayArrivalDateTime Date d'arrivée du séjour.
travelData.stayDataList.stayDataX.stayCategory Nature de prestation du séjour
travelData.stayDataList.stayDataX.stayLocation Code du Pays

customerAccountHistoric

Nom du champ Remarques / règles
customerAccountHistoric.creationDate Date de création du compte client
customerAccountHistoric.firstPurchaseDate Date du premier achat du client
customerAccountHistoric.lastPurchaseDate Date de dernier achat du client
customerAccountHistoric.numberOfPurchase180Days Nombre d'achats effectués sur le compte client sur le site commerçant sur les six derniers mois (180 derniers jours) (2 caractères numériques maximum)
customerAccountHistoric.numberOfTransactionYear Nombre de transactions abandonnées ou réussies dans la dernière année sur le compte client du commerçant (2 caractères numériques maximum)

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).
paymentMeanBrand = COFIDIS_3X
paymentMeanType = ONLINE_CREDIT
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 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.

L'acceptation du moyen de paiement 3xCBCofidis n’est pas disponible au travers de la solution Sips Office.

Les opérations suivantes sont disponibles sur les transactions 3xCBCofidis :

Gestion de caisse
Annulation V
Validation V
Remboursement V
Duplication X
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

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 3xCBCofidis 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 X
Journal de rapprochement des impayés X
Note: pour les transactions 3xCBCofidis, le champ paymentMeanBrand est renseigné avec la valeur COFIDIS_3X.

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



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