Arborescence des pages



Contenu


Comment configurer votre compte ?

Vous devez vous rapprocher de votre responsable de compte partenaire Cofidis pour obtenir les informations nécessaires permettant de configurer votre compte sur Monext Online (login du compte et  mot de passe). 

Vous devez réaliser des transactions tests pour valider le bon fonctionnement en production.


Créer le moyen de paiement, en homologation et en production :

  1. Rendez-vous sur le centre d’administration dans l’onglet « Configuration » puis « Moyens de paiement ».
  2. Un écran de recherche s’affiche, cliquez sur le bouton + « Nouveau moyen de paiement ».
  3. Sélectionnez votre point de vente puis le type de moyen de paiement COFIDIS.
  4. Renseigner les informations : identifiant Commerçant Cofidis, un libellé, un numéro de contrat de votre choix puis sélectionner votre devise. Cliquez sur le statut « Actif » et renseigner la valeur du champ Référence Commerçant chez Cofidis .

Le code (card_code) du moyen de paiement est : COFIDIS

Les valeurs ci dessous vous seront fournis par Cofidis et elles sont obligatoires pour créer le moyen de paiement :

  • Merchant ID
  • Merchant Country
  • Payment.Option
  • Number Of Instalment
  • Payment Method
  • Waiting Period

Voici une représentation des valeurs possibles :

Pays

Logo France

Identifiant LOGONom du logo
Payment Option

FR

PayLaterLogo30joursDFPAY
FR
3xFRLogo3XCB3X
FR4xFRLogo3XCB4X

FR

NxCBFRLogo5x12xCBLOAN

FR

CofidisPayFRLogo5x10x20xLOAN

FR

ProjexioFRLogo10x36xLOAN

Logo EspagneIdentifiant LOGO

ES
4xESLogo4xcard4X

ES

CofidisPayESLogo6x12x24xLOAN

Logo ItalieIdentifiant LOGO

IT

PagodilLogoPagoDilPDIL

Logo BelgiqueIdentifiant LOGO

BE

3xBELogo3X3X

BE

CofidisPayBELogo6x12x18xLOAN


Exemple de configuration Cofidis Pay en 4x :


(info)   Note : Indiquer le type de contrat dans l'alias Contract_Number afin de faciliter votre intégration. Cela permet de retrouver le type de produit de la gamme Cofidis avec le contrat_number dans la response du web service.
  


Le détail de la transaction indique les informations du partenaire :



Comment proposer le paiement Cofidis à vos clients ?


Quand l'acheteur réalise un paiement avec Cofidis, il est redirigévers les pages de Cofidis et selon les mensualités sélectionnés alors il pourra payer par carte bancaire ou par crédit.

Pour initier la page de paiement, vous devez appeler le service doWebPayment.
Pour finir, quand le processus de paiement est terminé, le serveur de paiement Cofidis enverra les détails de la transaction à l’url de notification « normal_return_url ».

  • Si l'acheteur annule l’opération, il sera redirigé sur les pages web de Monext Online (grâce à une l'URL fournie par le commerçant lors de l’appel à la plateforme Cofidis) avec un message d’erreur lui disant que sa transaction n’a pas pu aboutir.
  • Si l'acheteur abandonne l’opération avant sa finalisation, le serveur de paiement Cofidis enverra les détails de la transaction à l’url de notification « automatic_return_url » fournie par le commerçant lors de l’appel à la plateforme Cofidis. Il s’agit d’une requête HTTP standard en POST.

Les fonctionnalités de paiement disponibles sont :


L'initialisation d'un paiement

La fonction doWebPayment permet d’initialiser une transaction de paiement web.
Vous pouvez préciser si vous souhaitez un paiement à la commande : renseignez le champ payment.mode à CPT et payment.action à 101.


Le web service getWebPaymentdetails et getTransactionDetails

Pour réaliser une demande de résultat de la transaction de paiement, Payline met à votre disposition ce web service.
Vous devez transmettre le jeton d’authentification (token de session) délivré par Monext Online lors de la demande d’initialisation (résultat de la fonction doWebPayment) pour obtenir un résultat détaillé du paiement.


Transaction en cours de traitement : état En cours

En cas de problème sur le parcours de paiement, par exemple le ferme le navigateur ou réalise un back du navigateur, ou encore lors de l'utilisation du batch de paiement, la transaction peut avoir un état de transaction INPROGRESS.
Après le traitement ces transactions seront annulées ou remboursés, le commerçant peut alors redemander l'état de la transaction.


Transaction en cours de validation : état En Attente

Ce moyen de paiement propose de générer des commandes avec un temps de validation. Votre commande sera en attente avec l'état ONHOLD_PARTNER, voir la description de la gestion des états et des codes retour.
Il est recommandé de gérer cet état et d'indiquer l'état de la commande à votre acheteur.


Transaction refusée/validée

Sur le retour de Cofidis, Monext crée une opération validé ou refusé lié à la commande.
Dans cette version, Payline peut demander l'état des dossiers.


Validez votre intégration

Cette étape vous permet de contrôler que votre intégration est correcte :

  • Réalisez un paiement complet avec votre moyen de paiement Cofidis Pay.
  • Consultez le centre d’administration commerçant et validez le bon enregistrement de votre transactions de paiement dans votre système.


Champs obligatoires

Afin de garantir le meilleur taux d'acceptation possible, Cofidis est à même de traiter de nombreux détails relatifs à la commande lors de la demande de paiement.
L'objectif est de pré-renseigner les champs du formulaire de paiement affiché au consommateur.

Ci-dessous la liste des informations que Monext Online est en mesure de transmettre à Cofidis.
Nous nous invitons à vous rapprocher de votre gestionnaire de compte Cofidis pour savoir quelles sont les informations importantes que vous devez renseigner par rapport à votre activité.


Le tableau ci-dessous donne la liste des informations dossier que vous pouvez transmettre directement à Cofidis avec le service doWebPayment de l'API WebPayment Monext Online.

Champs Monext Online
Description
Valeur préconisée

Obligatoire

Acheteur


buyer.titleCivilité MR / MME / MLLE

buyer.lastNameNom du client

buyer.firstNamePrénom du client

buyer.emailAdresse électronique de l'acheteur

buyer.mobilePhoneNuméro de téléphone mobile

buyer.ipAdresse IP de l'acheteur

buyer.birthDateDate de naissance de l'acheteurformat date :  AAAAMMJJ
buyer.customerIdIdentifiant de l'acheteur
(coche)
buyer.legalStatusType d'acheteur

1 : Person, 2 : Business


buyer.legalDocumentNuméro d'identification du document officiel



buyer.legalDocumentTypeType d'identification du document officielValeur 1, 6, 5, 3 : Codes - LegalDocumentType
buyer.accountOrderCountLe nombre de commandes passées par l'acheteur

buyer.accountCreateDateDate de création du compte de l'acheteur

Format : dd/mm/yy


buyer.loyaltyMemberTypeValeur : 

0 : No program, 1 : Standard/Normal, 9 : Subscription in progress, 3 : Gold/Premium, 2 : Silver, 4 : Platinium

Format : dd/mm/yy


Facturaction


buyer.billingAddress.phoneTéléphone de la personne pour la facturation

buyer.billingAddress.streetNumberAdresse pour la facturation

buyer.billingAddress.street1Adresse de facturation
(coche)
buyer.billingAddress.street2Complément d’adresse
(coche)
buyer.billingAddress.zipCodeCode postal ville de l’adresse
(coche)
buyer.billingAddress.cityName ville de l’adresse
(coche)

buyer.billingAddress.county

Adresse pour la facturation

buyer.billingAddress.countryAdresse pour la facturation

Livraison


buyer.shippingAdress.name


buyer.shippingAdress.phoneTéléphone pour la livraison.

buyer.shippingAdress.street1Adresse pour la livraison.

buyer.shippingAdress.street2Adresse pour la livraison.

buyer.shippingAdress.zipcodeAdresse pour la livraison.

buyer.shippingAdress.cityNameAdresse pour la livraison.

buyer.shippingAdress.countyAdresse pour la livraison.

buyer.shippingAdress.countryAdresse pour la livraison.

buyer.buyerExtended.buyerExtendedHistory.totalAmountMontant total de l'historique des achats.

buyer.buyerExtended.buyerExtendedHistory.orderCount6MonthsNombre de commandes passées par l'acheteur au cours des six derniers mois.

buyer.buyerExtended.buyerExtendedHistory.orderAmount6MonthsMontant total des commandes passées au cours des six derniers mois.

buyer.buyerExtended.buyerExtendedHistory.firstOrderDateDate de la première commande.

Stocké par Payline en JSON : DD/MM/YYYY hh:mm:ss


buyer.buyerExtended.buyerExtendedHistory.lastOrderDateDate de la dernière commande.

Stocké par Payline en JSON : DD/MM/YYYY hh:mm:ss


Paiement




miscData

Clé : "preScore", valeur défini entre commerçant et Cofidis.

Clé : 'Cofidis_offerId'

La règle de construction du prescore est à définir entre le commerçant et Cofidis.
merchantNameNom du commerçant affiché sur la page d'authentification.



languageCodeAffichage de langue de la page.



subMerchant.subMerchantIdID du sous marchant.



payment.actionType de paiementValeur : 100, 101(coche)
payment.amountMontant de l'opération
(coche)
Commande


order.refRéférence de la commandetruncate (order.reference, 15)(coche)
order.amountMontant de la commande

 


order.currencyDevise de la commande

 

(coche)
order.deliveryModeMode de retrait

Cf. Values for deliveryMode : 1, 2, 3, 4, 5, 10, 999


order.deliveryChargeMontant de la livraisonMontant en plus petite unité
order.deliveryTimeType de livraison

Cf. Values for deliveryTime : 1, 2, 4, 6


order.orderExtended.riskLevel Code indiquant le niveau de risque de la commande

order.orderExtended.deliveryProviderNom du service de livraison

orderDetail.refRéférence de l''article

orderDetail.pricePrix des articles

orderDetail.quantity

Nombre d'articles



orderDetail.categoryCatégorie d'articlecf. Codes - Category ou description libre
orderDetail.brandLa marque du produit

orderDetail.subcategory1Rang 1 sous catégorie

orderDetail.subcategory2Rang 2 sous catégorie

orderDetail.commentCommentaire

orderDetail.additionalData 

Liste des spécifications "risque" requises pour le moyen de paiement.

Donnée au format JSON avec clé = 'risk' et valeur ci-contre.

0 : Non risqué

1 : Risqué


orderDetail.additionalData

Donnée au format JSON avec clé = 'itemAvailability', et valeur ci-contre.  

Y = Yes , N = No


orderDetail.additionalData

Donnée "discount" au format JSON

0 : Pas de promotion, 1 : Promotion


orderDetail.sellerNom ou identifiant du vendeur final

orderDetail.sellerTypeType de vendeur

1 : professional, 2 : private seller



Comment réaliser des test ?

Il vous faut obtenir un compte de test auprès de Cofidis.
Les données de tests vous seront communiquées par Cofidis avec votre compte de tests.


Exemple de trames


Les codes de retour

Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. 

Les états retournés :

  • Le paiement est accepté avec l'état ACCEPTED et le code retour 00000.
  • Le paiement est refusé avec l'état REFUSED. Le code varie en fonction du motif de refus (Par exemple : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).

La gestion des états et des codes retour sont listés ici.