Introduction
Worldline 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 Worldline Sips.
À qui s’adresse ce document ?
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 Worldline Sips, nous vous conseillons de consulter les documents suivants :
- Présentation fonctionnelle
- Guide de configuration des fonctionnalités
Comprendre les paiements Cofidis Pay 5X 10X 20X avec Worldline Sips
Principes généraux
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
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 | |
| 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 |
Parcours de paiement
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).
Parcours « Déjà client »
| Pages | Etapes |
|---|---|
| Commerçant | Validation du panier. |
| Commerçant ou Worldline Sips | Sélection du moyen de paiement (ici sur le site Web du commerçant). |
| Worldline Sips | Le client est automatiquement redirigé vers la plateforme Worldline Sips pour initier la transaction. La plateforme Worldline 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, …). |
| Worldline Sips | Présentation du ticket. |
| Commerçant | Le client est redirigé vers le site Web du commerçant. |
Parcours « Prospect »
| Pages | Etapes |
|---|---|
| Commerçant | Validation du panier. |
| Commerçant ou Worldline Sips | Sélection du moyen de paiement (ici sur le site Web du commerçant). |
| Worldline Sips | Le client est automatiquement redirigé vers la plateforme Worldline Sips pour initier la transaction. La plateforme Worldline 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. |
| Worldline Sips | Présentation du ticket. |
| Commerçant | Le client est redirigé vers le site Web du commerçant. |
Pages de paiement
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.
Vérification de transactions
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 Worldline 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.
Ouvrir votre contrat d'acceptation Cofidis Pay 5X 10X 20X
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.
Effectuer un paiement Codifis Pay 5X 10X 20X
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.
- Mode immédiat : l'autorisation et la remise sont exécutées en ligne simultanément.
Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :
Effectuer un paiement Codifis Pay 5X 10X 20X avec Sips Paypage
La cinématique de paiement pour Sips 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, Worldline 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 Worldline 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. |
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 (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) |
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 =
00paymentMeanBrand =
1EUROCOMpaymentMeanType =
ONLINE_CREDITpaymentMeanData.unEuroCom.settlementMode
= code du moyen de paiement sélectionné par le
client.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 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.
Effectuer un paiement Codifis Pay 5X 10X 20X avec Sips Office
L’acceptation du moyen de paiement Codifis Pay 5X 10X 20X n’est pas disponible au travers de la solution Sips Office.
Gérer vos transactions Codifis Pay 5X 10X 20X
Opérations de caisse disponibles
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é :
Consulter vos transactions Codifis Pay 5X 10X 20X
Journaux
Les journaux mis à disposition par Worldline 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 |
Sips Office Extranet
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 :
