WL SIPS DOCS

Release 22.5

aller directement au contenu

Rechercher par mots clés

Intégration Cofidis Pay 5X 10X 20X

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 Codifis Pay 5X 10X 20X dans WL Sips.

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Codifis Pay 5X 10X 20X 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

Codifis Pay 5X 10X 20X est une solution de financement des achats en ligne proposée par Cofidis. Il s’agit d’un crédit renouvelable permettant de payer en plusieurs fois, mais aussi au comptant.

Grâce à cette solution le client bénéficie d'un différé de paiement jusqu'à 45 jours et règle ses achats sans avoir à transmettre son numéro de carte bancaire.

Le principe du paiement Codifis Pay 5X 10X 20X se base sur l’utilisation d’un compte virtuel pour réaliser des achats. La création en ligne de ce compte virtuel est effectuée lors du premier paiement (saisie des données personnelles et garantie sur la carte bancaire).

Pour les achats suivants, l’utilisation de ce compte est soumise à une authentification par les identifiants de connexion.

Le moyen de paiement Cofidis Pay 5X 10X 20X est disponible pour la France, l'Espagne et la Belgique


Disponibilité des moyens de paiement par pays

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
Paiement à l'expédition V
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

Deux parcours sont disponibles pour les acheteurs :

  • le parcours « Déjà client » (le client possède un compte) ;
  • le parcours « Prospect » (le client crée son compte, ce qui implique une cinématique plus longue).

diagramme montrant le parcours d'un internaute déjà client

Le client valide son panier et choisi Cofidis Pay comme moyen de paiement sur le site web commerçant. Il est redirigé au travers de WL Sips vers les pages Cofidis afin de s'identifier et accéder à son compte client et choisit ensuite la modalité de paiement. Au retour vers WL Sips, le ticket avec le résultat s'affiche. Il est enfin redirigé vers la page du site web du commerçant qui lui confirme si sa commande est bien prise en compte ou non.
Pages Etapes
Commerçant Validation du panier.
Commerçant ou WL Sips Sélection du moyen de paiement (ici sur le site Web du commerçant).
WL Sips Le client est automatiquement redirigé vers la plateforme WL Sips pour initier la transaction. La plateforme WL Sips peut afficher au client la page « choix du moyen de paiement ».
Cofidis Le client s’authentifie avec les identifiants de son compte virtuel.
Cofidis Choix du moyen de paiement (comptant, 5 fois, 10 fois, …).
WL Sips Présentation du ticket.
Commerçant Le client est redirigé vers le site Web du commerçant.

diagramme montrant le parcours d'un prospect

Le client valide son panier et choisi Cofidis Pay comme moyen de paiement sur le site web commerçant. Il est redirigé au travers de WL Sips vers les pages Cofidis afin de s'identifier, de choisir sa modalité de paiement et de remplir le formulaire d'inscription. Au retour vers WL Sips, le ticket avec le résultat s'affiche. Il est enfin redirigé vers la page du site web du commerçant qui lui confirme si sa commande est bien prise en compte ou non.
Pages Etapes
Commerçant Validation du panier.
Commerçant ou WL Sips Sélection du moyen de paiement (ici sur le site Web du commerçant).
WL Sips Le client est automatiquement redirigé vers la plateforme WL Sips pour initier la transaction. La plateforme WL Sips peut afficher à l’internaute la page « choix du moyen de paiement »
Cofidis Le client choisit le parcours prospect.
Cofidis Choix du moyen de paiement (comptant, 5 fois, 10 fois, …).
Cofidis Le client renseigne ses données personnelles (3 pages).
Cofidis Le client renseigne ses données bancaires.
Cofidis Présentation du contrat pour validation.
WL Sips Présentation du ticket.
Commerçant Le client est redirigé vers le site Web du commerçant.

Le client sélectionne le moyen de paiement Codifis Pay 5X 10X 20X.

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

En fin de cinématique, le ticket de paiement s’affiche, puis le client retourne sur votre site Web.

Dans le cas de transactions Cofidis, le financement peut être automatiquement octroyé à l'issue du paiement, ce qui se traduit par l'état final suivant :

  • CAPTURED

Il est également possible que le dossier de l'internaute nécessite une étude avant acceptation définitive. Si un dossier est en cours de validation par Cofidis, l'état de la transaction qui lui est associée est :

  • TO_CONFIRM_CAPTURE ou TO_CONFIRM_AUTHOR

A tout moment, Cofidis peut tenir Sips informé d'une évolution de l'état d'un dossier et en complément un traitement d'interrogation de WL Sips auprès de Cofidis est exécuté quotidiennement pour mettre à jour ces transactions vers des états finaux :

  • CAPTURED si le dossier lié à la transaction à été accepté par Cofidis.
  • CAPTURE_REFUSED si le dossier lié à la transaction à été refusé par Cofidis, ou si aucune mise à jour n'a été constatée depuis 30 jours.

Afin de proposer le moyen de paiement Cofidis Pay 5X 10X 20X 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 Codifis Pay 5X 10X 20X au travers de Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.

Les modes de remise disponibles pour une transaction Codifis Pay 5X 10X 20X sont les suivants :

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

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


diagramme montrant les différents états d'une transaction

Si le commerçant choisit le mode validation, la transaction passera soit à l'état To validate si elle a été acceptée (response code 00), soit à l'état refused si elle a été refusée (response code 05). Si le commerçant choisit le mode annulation, la transaction passera soit à l'état To capture si elle a été acceptée (response code 00), soit à l'état refused si elle a été refusée (response code 05). En cas de timeout, et suivant le mode de capture utilisé, la transation passe temporairement en statut TO_CONFIRM_AUTHOR ou TO_CONFIRM_CAPTURE.

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


diagramme montrant la cinématique de paiement via paypage

1) Après avoir finalisé sa commande sur le site web commerçant, le client procède au paiement. 2) le client est redirigé vers les pages de paiement hébergées côté WL Sips et sélectionne le moyen de paiement Cofidis Pay 5X 10X 20X. 3) Le client est redirigé vers Cofidis afin de finaliser le paiement 4) Au retour du client vers WL Sips, le ticket avec le résultat du paiement s'affiche. 5) Si le client clique sur le bouton de retour à la boutique, il est redirigé sur le site web commerçant ce qui délenche l'envoi de la réponse manuelle. 6) Le moteur WL Sips envoie églament une réponse automatique vers le site commerçant.

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 Codifis Pay 5X 10X 20X.

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

Nom du champ Remarques / règles
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.unEuroCom.preScoreValuepreScoreValue

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.
customerId Facultatif (15 caractères maximum)

Identifiant du client.

customerData Facultatif.
Voir les tableaux ci-dessous.
customerAddress Facultatif.
Voir les tableaux ci-dessous.
customerLanguage Permet de choisir la langue utilisée sur les pages WL Sips et Cofidis.
shoppingCartDetail Facultatif.
Voir les tableaux ci-dessous.
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.
Note: 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 (50 caractères numériques maximum)
deliveryAddress.street Nom de la rue (40 caractères maximum)
deliveryAddress.streetAdditional1 Complément d’adresse (32 caractères maximum)
deliveryAddress.zipCode Code postal (5 caractères maximum)
deliveryAddress.city Ville (32 caractères maximum)
deliveryAddress.country Code du pays
deliveryAddress.postBox Boîte postale de l'adresse (8 caractères maximum)
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 Numéro de téléphone mobile du contact
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 = 1EUROCOM
paymentMeanType = ONLINE_CREDIT
paymentMeanData.unEuroCom.​settlementMode = code du moyen de paiement sélectionné par le client.
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 Codifis Pay 5X 10X 20X n’est pas disponible au travers de la solution Sips Office.

Les opérations suivantes sont disponibles sur les transactions Codifis Pay 5X 10X 20X :

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



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 Cofidis Pay 5X 10X 20X 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 Cofidis Pay 5X 10X 20X, le champ paymentMeanBrand est renseigné avec la valeur 1EUROCOM.

Vous pouvez consulter vos transactions Codifis Pay 5X 10X 20X et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.

Voici le détail d'une transaction Codifis Pay 5X 10X 20X :



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