Cofidis 3xCB / 4xCB - Intégration

S’abonner




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 Payline (login du compte et  mot de passe). 
Vous devez réaliser des transactions tests pour valider le bon fonctionnement en production.

Afin de créer le moyen de paiement, en homologation et en production, rendez-vous sur le centre d’administration dans l’onglet « Configuration » puis « Vos moyens de paiement ». Un écran de recherche s’affiche, cliquez sur le bouton « Nouveau moyen de paiement ».

Ecran de création de moyen de paiement  1/2:

Sélectionnez votre point de vente puis le type de moyen de paiement 3xCB ou 4xCB comme ci-dessous.

Cliquez ensuite sur le bouton « Suivant ».

Ecran de création de moyen de paiement  2/2:

Renseigner 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 . Il s’agit d’un compte de test utilisable uniquement dans l’environnement d’homologation donné par Cofidis.

Centre administration de Payline

Vous devez indiquer l'identifiant Commerçant Cofidis lors de la création du moyen de paiement CBx3 ou CBx4 :

 

  

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


Comment proposer le paiement Cofidis 3xCB / 4xCB à vos clients ?


Quand le client effectue un paiement avec 3xCB, il est redirigé vers l'étape 2 du processus. Cette page est hébergée sur les serveurs de la plateforme 3xCB et contient tous les détails de paiement soumis par le commerçant.
A l’étape 2 du doWebPayment, le client va être redirigé sur les pages de paiement de 3xCB où il devra entrer ses informations personnelles.
Pour finir, quand le processus de paiement est terminé, le serveur de paiement 3xCB enverra les détails de la transaction à l’url de notification « normal_return_url ».

Si le client annule l’opération, il sera redirigé sur les pages web de Payline (grâce à une l'URL fournie par le commerçant lors de l’appel à la passerelle 3xCB) avec un message d’erreur lui disant que sa transaction n’a pas pu aboutir.

Si le client abandonne l’opération avant sa finalisation le serveur de paiement 3xCB enverra les détails de la transaction à l’url de notification « automatic_return_url » fournie par le commerçant lors de l’appel à la passerelle 3xCB. Il s’agit d’une requête HTTP standard en POST.


Les fonctionnalités de paiement disponibles sont :

  • Paiement à la commande : Renseignez le champ payment.mode à CPT et payment.action à 101 avec le service doWebPayment.
  • Paiement à l'expédition : Renseignez le champ payment.mode à CPT et payment.action à 100 avec le service doWebPayment.
  • Demande d'encaissement : Utilisez la fonction doCapture() de l'API WebService.
  • Demande d'annulation d'une autorisation non encaissée : Utilisez la fonction doReset() de l'API WebService.
  • Demande de remboursement partiel ou totale : Utilisez la fonction doRefund() de l'API WebService avec le code payment.action à 421.
  • Demande d'information : Les services transactionsSearch, getWebPaymentDetails et getTransactionDetails sont également disponibles.


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 ou à l'expédition.

  1. paiement à la commande : Renseignez le champ payment.mode à CPT et payment.action à 101.
  2. paiement à l'expédition : Renseignez le champ payment.mode à CPT et payment.action à 100 ; Pour confirmer le paiement, vous devez réaliser une demande d'encaissement.


Cofidis exige que vous transmettiez les informations ci-après lors de la demande de paiement. L'objectif est de pré-renseigner les champs du formulaire de paiement affiché au consommateur.


Erreur du rendu de la macro 'excerpt-include' : User 'addon_com.kolibridigital.confluence-zendesk-sync' does not have permission to view the page 'Liste des objets Cofidis'.



L’intégralité des informations de la balise merchantData Cofidis sont retransmises dans les données privées du marchand avec le tag cofidis.merchantData.

Le web service getWebPaymentdetails

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 Payline lors de la demande d’initialisation (résultat de la fonction doWebPayment) pour obtenir un résultat détaillé du paiement.

Pour les paiements NxCB, Payline retourne les caractéristiques de la carte utilisée par l'acheteur.

Ces données sont récupérées des objets TransactionCard et Transaction3DSecure et retournées dans :

  • Payment.method
  • Card.number
  • Card.type
  • ExtendedCard.type
  • ExtendedCard.network
  • ExtendedCard.product
  • Authentication3DSecure.vadsResult

Le traitement des paiements 4XCB est identique à celui des paiements 3XCB.

Le web service getTransactionDetails

Pour toutes les transactions : la référence de commande Cofidis est ajoutée au privateData avec le mot clé PAYLINE.ORDER.ID.COFIDIS
Pour les transactions de validation : le numéro d’autorisation remonté par Cofidis est retourné dans le champ authorization.number.

Transaction en cours de traitement

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

Comment réaliser des tests ?

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.

Le numéro de carte test à utiliser pour la réalisation de vos tests sur Payline  :

          9898 98XX XXXX XXXX (pour rappel le montant minimum du 3xCB/4xCB est de 100 €)

X étant au choix, mais le numéro de carte doit être différents à chacun de vos tests.
Concernant la date de validité, il faut faire figurer une date de validité supérieure à 3 mois et un cryptogramme à 3 chiffres au hasard.

Les codes de retour

Erreur du rendu de la macro 'excerpt-include' : No link could be created for 'Return codes : Service SAF (22)'.

Erreur du rendu de la macro 'excerpt-include' : No link could be created for 'Return codes : Service SAF (22)'.


Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0
Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk