logo Sogenactif

Release 24.1

aller directement au contenu

Rechercher par mots clés

3xCB Cofidis

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

  • Sogenactif

Sogenactif 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 échelonné…).

L’objectif du présent document est d’expliquer l'intégration du moyen de paiement 3xCBCofidis dans Sogenactif.

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 Sogenactif, nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle
  • Configuration des fonctionnalités

Pour toute question technique ou demande d'assistance, nos services sont disponibles du lundi au vendredi, hors jours fériés, de 9 h à 19 h :

  • par téléphone au : +33 (0) 825 090 095  (0,15 € TTC/min + prix d’un appel local – Tarif au 12/09/2022)
  • par e-mail : supportsogenactif@worldline.com

Pour faciliter le traitement de vos demandes, veuillez communiquer votre identifiant de commerçant : merchantId (numéro à 15 chiffres).

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

Lors d’un paiement Cofidis, 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.

Le moyen de paiement 3xCB est disponible pour la France, l'Espagne et la Belgique.

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 échelonné X
Paiement récurrent X
Paiement par fichier X
Paiement One Clic 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.

En fin de cinématique, 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 3xCBCofidis au travers de l’interface Sogenactif Paypage.

Les modes de remise disponibles pour une transaction Cofidis 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. En mode immédiat (captureMode = IMMEDIATE), si la transaction est acceptée, elle passe en status CAPTURED. 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 Sogenactif 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 Sogenactif, 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 Sogenactif. 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) Sogenactif envoie une réponse automatique.

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

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 dans le cadre d'un paiement 3xCBCofidis.

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 Sogenactif 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 le champs preScoreValue. Ces consignes ne sont pas contrôlées par Sogenactif, 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

Attention: shoppingCartItemList est un objet complexe.
Merci de vous référer à la documentation d'intégration du connecteur choisi pour savoir comment le renseigner.
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é (20 caractères maximum)
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
paymentMeanBrand = COFIDIS_3X
paymentMeanType = ONLINE_CREDIT
responseCode = 00
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données).
responseCode = 05
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 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 Sogenactif Office Serveur.

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

Gestion de caisse
Annulation V
Annulation possible sur le montant total ou partiel de la transaction
Validation V
Validation possible sur le montant total ou partiel de la transaction.
Remboursement V
Remboursement possible sur le montant total ou partiel de la transaction.
Duplication 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 Sogenactif 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 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 bancaire X
Journal de rapprochement des impayés X
Note: le champ paymentMeanBrand est renseigné en fonction du moyen de paiement utilisé pour la transaction, soit ici COFIDIS_3X.

Vous pouvez consulter vos transactions et effectuer différentes opérations de gestion de caisse grâce à Sogenactif Gestion.



Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Fermer

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 Sogenactif.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres