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.

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 :

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 :

1. paiement à la commande : Renseignez le champ payment.mode à CPT et payment.action à 101 avec le service doWebPayment ;
2. paiement à l'expédition : Renseignez le champ payment.mode à CPT et payment.action à 100 avec le service doWebPayment ;
3. demande d'encaissement : Utilisez la fonction doCapture() de l'API WebService ;
4. demande d'annulation d'une autorisation non encaissée : Utilisez la fonction doReset() de l'API WebService ;
5. demande de remboursement partiel ou totale : Utilisez la fonction doRefund() de l'API WebService avec le code payment.action à 421 ;
6. 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.

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.