Introduction
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.
À qui s’adresse ce document ?
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
Contacter l'assistance
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).
Comprendre les paiements Cofidis avec Sogenactif
Principes généraux
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.
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 | |
| 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 |
Pages de paiement
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.
Ouvrir votre contrat d’acceptation Cofidis
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.
Effectuer un paiement Cofidis
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 :
Effectuer un paiement avec Sogenactif Paypage
La cinématique de paiement pour Sogenactif Paypage est décrite ci-dessous :
Paramétrer la requête de paiement
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. |
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é (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) |
Analyser la réponse
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_3XpaymentMeanType =
ONLINE_CREDITresponseCode =
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.
Effectuer un paiement avec Sogenactif Office Serveur
L'acceptation du moyen de paiement 3xCBCofidis n’est pas disponible au travers de la solution Sogenactif Office Serveur.
Gérer vos transactions
Opérations de caisse disponibles
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é :
Consulter vos transactions
Journaux
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 |
Sogenactif Gestion
Vous pouvez consulter vos transactions et effectuer différentes opérations de gestion de caisse grâce à Sogenactif Gestion.
