Introduction

WL 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 des moyens de paiement CACF_3X et CACF_4X dans WL Sips .

À qui s’adresse ce document ?

Ce document a pour objectif de vous aider à implémenter les moyens de paiement CACF_3X et CACF_4X 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 WL Sips , nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle ;
  • Guide de configuration des fonctionnalités .

Comprendre les paiements CACF_3X et CACF_4X avec WL Sips

Principes généraux

Le moyen de paiement CACF est un moyen de paiement privatif proposé par des grandes enseignes de la distribution, ayant pour acquéreur exclusif le Crédit Agricole en France.

Les moyens de paiement CACF_3X et CACF_4X sont des moyens de paiement de crédit en plusieurs fois.

A l'issu d'un paiement de ce type, vous êtes crédité du montant en une fois, et le porteur sera débité en 3 ou 4 fois (suivant le moyen de paiement choisi).

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 X
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
Règlement en devise X
Conversion dynamique des devises X

Remise en banque des paiements

Les paiements sont remis en banque conformément aux modalités de paiement définies par vous-même. En standard, la remise en banque est déclenchée la nuit à partir de 22h00, fuseau horaire CET (heure d’Europe Centrale), via un échange de fichier avec l’acquéreur.

Pages de paiement

Le client sélectionne les moyens de paiement CACF_3X et CACF_4X.

Il est ensuite redirigé vers la page de la saisie des informations requises :

Le ticket de paiement s’affiche, puis le client retourne sur votre site Web :

Ouvrir votre contrat d'acceptation CACF_3X et CACF_4X

Afin de proposer le moyen de paiement CACF_3X et CACF_4X sur votre site Web, vous devez souscrire un contrat d'acceptation auprès de Crédit Agricole Consumer Finance. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Effectuer un paiement CACF_3X et CACF_4X

WL Sips vous offre deux solutions pour intégrer CACF_3X et CACF_4X :

  • Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
  • Sips Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.

Les modes de remise disponibles pour une transaction 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 expire donc automatiquement.

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 Sips Paypage

La cinématique de paiement pour Sips Paypage est décrite ci-dessous :

Paramétrer la requête de paiement

Les champs suivants ont un comportement particulier :

Nom du champ Remarque / règles
captureDay La valeur envoyée dans la requête doit être de 8 au maximum.
Une valeur supérieure sera forcée à 8.
customerLanguage Permet de choisir la langue utilisée sur les pages WL Sips et CACF.
orderId Obligatoire
customerId Obligatoire
customerContact.email Obligatoire
billingContact.title Obligatoire {0,4} ANS (exemple : MR / MME / MLLE …)
billingContact.firstname Obligatoire
billingContact.lastname Obligatoire
billingContact.mobile Obligatoire
billingContact.phone Obligatoire
billingAddress.street Obligatoire
billingAddresst.streetNumber Obligatoire
billingAddress.zipCode Obligatoire
billingAddress.city Obligatoire
billingAddress.country Obligatoire

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é

responseCode = 00

acquirerResponseCode = 00

Vous pouvez livrer la commande.
Refus bancaire acquéreur

responseCode = 05

acquirerResponseCode = 05

L’autorisation est refusée pour un motif non lié à la fraude.
Vous pouvez proposer à votre client de payer avec autre moyen de paiement en générant une nouvelle requête.
Paiement en attente de confirmation

ResponseCode = 60

acquirerResponseCode = 60

Vous devez attendre la mise à jour automatique du statut de la transaction vers un état final avant de décider d’expédier la commande. Pour ces transactions, il est nécessaire d’utiliser les journaux de transaction pour décider de continuer le traitement de la commande.
Paiement annulé par le client

responseCode = 17

acquirerResponseCode = 17

Le client a annulé son paiement sur les pages CACF.
Ne livrez pas la commande.
Refus suite problème technique

responseCode = 90, 99

acquirerResponseCode = 90 à 98

Problème technique temporaire lors du traitement de la transaction.
Proposez à votre client de refaire un paiement ultérieurement.

Effectuer un paiement avec Sips Office

Le processus de paiement pour Sips Office est décrit ci-dessous :

Initialiser un paiement (PaymentProviderInitialize)

L’initialisation d'un paiement Paylib est effectuée en appelant la méthode PaymentProviderInitialize .

Requête d’initialisation du paiement

Les champs génériques suivants sont définis dans le cas d’une initialisation de paiement:

Nom du champ Remarques / règles
paymentMeanBrand Doit être valorisé avec CACF_3X ou CACF_4X
merchantReturnUrl URL de retour du commerçant.

Les champs spécifiques qui doivent être transmis sont les suivants :

Nom du champ Remarque / règles
orderId Obligatoire
customerId Obligatoire
customerContact.email Obligatoire
customerLanguage Permet de choisir la langue utilisée sur les pages WL Sips et CACF.
billingContact.title Obligatoire {0,4} ANS (exemple : MR / MME / MLLE …)
billingContact.firstname Obligatoire
billingContact.lastname Obligatoire
billingContact.mobile Obligatoire
billingContact.phone Obligatoire
billingAddress.street Obligatoire
billingAddress.streetNumber Obligatoire
billingAddress.zipCode Obligatoire
billingAddress.city Obligatoire
billingAddress.country Obligatoire

Réponse d’initialisation du paiement

Les champs suivants sont retournés dans le cas d’un paiement :

Nom du champ Remarques / règles
responseCode Code réponse
redirectionData Données de redirection récupérées en réponse à l’initialisation du paiement.
redirectionUrl URL de redirection vers le site du moyen de paiement
messageVersion Version du message récupérée en réponse à l’initialisation du paiement.

Rediriger le client vers le site Web du moyen de paiement

Le client doit être redirigé vers l’URL redirectionUrl fournie en réponse de la méthode paymentProviderInitialize . Cette redirection consiste à effectuer un appel POST sur l’URL redirectionUrl obtenue dans la réponse à l’initialisation de paiement. Les paramètres POST à transmettre sont redirectionData et messageVersion obtenus également dans la réponse à l’initialisation de paiement.

A la fin de la cinématique de paiement, le client est redirigé sur l’URL fournie dans la requête d’initialisation, merchantReturnUrl . Les champs suivants sont transmis en POST et doivent être récupérés pour finaliser le paiement :

Nom du champ Remarques / règles
responseCode Code réponse du processus
redirectionData Données de redirection récupérées en réponse à l’initialisation du paiement.
messageVersion Version du message récupérée en réponse à l’initialisation du paiement.
amount Montant de la transaction en centimes
merchantId Identifiant de la boutique
transactionReference Référence de la transaction
transactionId Identifiant de la transaction
transactionDate Date de la transaction

Réponse de finalisation du paiement

Les champs suivants sont retournés pour un paiement CACF_3X/CACF_4X :

Nom du champ Remarques / règles
paymentMeanBrand Nom du moyen de paiement
responseCode Code réponse du serveur WL Sips .
transactionStatus État de la transaction

Gérer vos transactions CACF_3X et CACF_4X

Opérations de caisse disponibles

Les opérations suivantes sont disponibles sur les transactions CACF_3X et CACF_4X :

Gestion de caisse
Annulation V
Validation V
Remboursement V
Duplication X
Recyclage 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 CACF_3X et CACF_4X

Journaux

Les journaux mis à disposition par WL 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 CACF_3X et CACF_4X 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 V
Journal de rapprochement des impayés V
Note: pour les transactions CACF_3X et CACF_4X, le champ paymentMeanBrand est renseigné avec les CACF_3X ou CACF_4X.

Sips Office Extranet

Vous pouvez consulter vos transactions CACF_3X et CACF_4X et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet .

Voici le détail d'une transaction CACF_3X :