Release 24.5

aller directement au contenu

Rechercher par mots clés

Intégration Franfinance 3X 4X

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Sherlock's 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 Franfinance 3xWEB et 4xWEB dans Sherlock's.

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Franfinance 3xWEB et 4xWEB 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 Sherlock's, nous vous conseillons de consulter les documents suivants :

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

Spécialisée dans le crédit à la consommation, la société française Franfinance 3xWEB et 4xWEB est une solution réservée aux personnes physiques majeures titulaires d’une carte bancaire valable au moins 3 mois après la date de conclusion du contrat de paiement échelonné et dont l'utilisation n'est pas soumise à une demande d’autorisation systématique (notamment les cartes Visa Electron et Maestro).

Grâce à cette solution, les clients paient en 3 ou 4 fois leurs achats sur Internet.

Lors d'un paiement Franfinance 3xWEB et 4xWEB, le client complète ses données personnelles ainsi que ses informations de carte bancaire.

A la fin de sa saisie, il est informé en ligne du résultat de sa demande.

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 Méthode par défaut
Paiement en fin de journée X
Paiement différé X
Paiement à l'expédition X
Paiement en plusieurs fois X
Paiement par abonnement X
Paiement par fichier X
Paiement OneClick X
Gestion des devises
Acceptation multidevis X Euro uniquement
Règlement en devise X Euro uniquement

Les pages pour ce moyen de paiement sont gérées et hébergées par Franfinance.

Une première page permet au client de compléter les données nécessaires à sa souscription 3xWEB et 4xWEB.

A la suite de la validation de cette dernière, le client se verra proposer la saisie de ses informations de carte afin d'initier le paiement:

  • le numéro de sa carte ;
  • la date d’expiration de sa carte ;
  • le CVV de sa carte.

Si l’une de ces données est absente ou invalide, ou si le numéro de carte saisi n’est pas dans la plage, un message d’erreur est affiché et une nouvelle saisie est demandée.

Le fonctionnement standard de Sherlock's s’applique : le nombre de tentatives de saisie est plafonné, un code d'erreur est retourné si le nombre de tentatives est dépassé.

Suite à la réalisation du paiement une page de ticket est affichée au client indiquant le résultat de la transaction. Ce ticket porte un bouton « Retour boutique » permettant de revenir vers votre site Web avec la réponse de paiement Franfinance 3xWEB et 4xWEB.

Les options standard de Sherlock’s Paypage sont applicables : ce ticket peut être désactivé à votre demande. Si vous positionnez l’option bypassReceiptPage du ticket, le ticket ne s’affiche pas. Le client est directement redirigé vers votre site Web.

En fonction du résultat de la demande d’autorisation, des messages différents seront affichés au client sur le ticket.

Si le client ne retourne pas sur votre site Web commerçant (cas d'une rupture de cinématique de paiement), une réponse automatique avec le résultat de la transaction vous sera envoyée jusqu'à 24 heures après le début du paiement. Généralement, le délai est compris entre 30 minutes et 1 heure.

Afin de proposer le moyen de paiement Franfinance 3xWEB et 4xWEB, vous devez souscrire un contrat d’acceptation auprès de Franfinance. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Vous pouvez proposer le moyen de paiement Franfinance 3xWEB et 4xWEB au travers de Sherlock’s Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.

Le seul mode de remise disponible pour une transaction Franfinance est le mode immédiat (la remise de la transaction est réalisée au moment de l’acceptation du paiement en ligne).

Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :


Description des status possibles pour une transaction Franfinance 3xWEB et 4xWEB

Dans le mode immédiat, la transaction passera soit à l'état Captured si elle a été acceptée (response code 00), soit à l'état Refused si elle a été refusé (response code différent de 00). En cas de timeout, la transaction passera temporairement à l'état TO_CONFIRM_CAPTURE.

La cinématique de paiement pour Sherlock’s Paypage est décrite ci-dessous :


Étapes d'un paiement Franfinance 3xWEB et 4xWEB via Paypage

1) Le client procède au paiement. 2) Il est redirigé vers la page de sélection du moyen de paiement hébergée chez Sherlock's, il sélectionne Franfinance 3xWEB ou Franfinance 4xWEB et saisit son numéro de carte. 3) Il est redirigé vers la page Franfinance 3xWEB ou Franfinance 4xWEB où il s'authentifie. 4) Il est redirigé sur une page Sherlock's. 5) S'il clique sur le bouton de retour à la boutique, il est redirigé vers votre site Web ce qui délenche l'envoi de la réponse manuelle. 6) Sherlock's envoie une réponse automatique.

Le champ existant paymentMeanBrandList doit être renseigné avec la liste des moyens de paiement proposés au client et spécifiquement le moyen de paiement Franfinance proposé.

Des informations spécifiques sont nécessaires pour une requête de paiement Franfinance 3xWEB et 4xWEB :

Nom du champ Remarques / règles
amount Montant en centimes.
captureMode La valeur envoyée dans la requête est ignorée.
Le mode de capture est forcé à IMMEDIATE.
currencyCode Obligatoire : Euro uniquement (978)
customerId Facultatif.
Identifiant du client.
orderId Obligatoire : Numéro de la commande
customerIpAddress Facultatif.
Adresse IP de l’acheteur.
bypassReceiptPage Facultatif.
Indique que le commerçant veut contourner les pages de type ticket.

customerAccountHistoric

Nom du champ Remarques / règles
customerAccountHistoric.creationDate Facultatif.
Date de création.
Avec le container customerAccount, c'est la date de création du compte client chez le marchand qui permet de calculer l'ancienneté du compte.

customerAddress

Nom du champ Remarques / règles
customerAddress.streetNumber Facultatif.
Numéro de la rue de l'adresse.
customerAddress.street Obligatoire
customerAddress.addressAdditional1 Facultatif
customerAddress.zipCode Obligatoire
customerAddress.city Obligatoire
customerAddress.country Obligatoire.
Code pays de l'adresse.

customerContact

Nom du champ Remarques / règles
customerContact.email Obligatoire
customerContact.lastName Obligatoire
customerContact.maidenName Facultatif
customerContact.firstName Obligatoire
customerContact.mobile Obligatoire
customerContact.title Facultatif.
Titre de civilité du contact.
M pour monsieur, MRS pour madame

billingAddress

Nom du champ Remarques / règles
billingAddress.streetNumber Facultatif.
Numéro de la rue de l'adresse.
billingAddress.street Obligatoire.
Nom de la rue de l'adresse.
billingAddress.addressAdditional1 Facultatif.
Complément de l’adresse.
billingAddress.zipCode Obligatoire.
Code postal de l'adresse.
billingAddress.city Obligatoire.
Ville de l'adresse.
billingAddress.country Obligatoire.
Pays de l'adresse.

billingContact

Nom du champ Remarques / règles
billingContact.email Facultatif.
E-mail du contact.
billingContact.mobile Facultatif.
Numéro de téléphone mobile du contact.
billingContact.title Facultatif.
Titre de civilité du contact.
M pour monsieur, MRS pour madame
billingContact.lastname Facultatif.
Nom de famille du contact.
billingContact.firstname Facultatif.
Prénom du contact.
billingContact.company
Facultatif.
Entreprise de l'adresse.

deliveryAddress

Nom du champ Remarques / règles
deliveryAddress.streetNumber Facultatif.
Numéro de la rue de l'adresse.
deliveryAddress.street Obligatoire.
Nom de la rue de l'adresse.
deliveryAddress.addressAdditional1 Facultatif.
Complément de l’adresse.
deliveryAddress.zipCode Obligatoire.
Code postal de l'adresse.
deliveryAddress.city Obligatoire.
Ville de l'adresse.
deliveryAddress.country Obligatoire.
Pays de l'adresse.

deliveryContact

Nom du champ Remarques / règles
deliveryContact.email Facultatif.
E-mail du contact.
deliveryContact.mobile Facultatif.
Numéro de téléphone mobile du contact.
deliveryContact.title Facultatif.
Titre de civilité du contact.
deliveryContact.lastname Facultatif.
Nom de famille du contact.
deliveryContact.firstname Facultatif.
Prénom du contact.
deliveryContact.company Facultatif.
Entreprise de l'adresse.

deliveryData

Nom du champ Remarques / règles
deliveryData.deliveryMethod Facultatif.
Modalité choisie pour la livraison (standard, prioritaire, ...).
deliveryData.deliveryOperator Facultatif.
Nom du transporteur assurant la livraison.
deliveryData.electronicDeliveryIndicator Facultatif.
Indique si la livraison est dans un mode électronique.
deliveryData.estimatedDeliveryDelay Facultatif.
Délai de livraison (en nombre de jours) estimé par le commerçant.

paymentMeanData

Nom du champ Remarques / règles
paymentMeanData.franfinance3xcb.authenticationKey Obligatoire .

Chaîne fournie par Franfinance.

paymentMeanData.franfinance4xcb.authenticationKey Obligatoire .

Chaîne fournie par Franfinance.

shoppingCartDetail

Attention: shoppingCartItemList est un objet complexe.
Merci de vous référer à la documentation d'intégration du connecteur choisi pour savoir comment le renseigner.
Nom du champ Remarques / règles
shoppingCartDetail.mainProduct Obligatoire. Produit le plus cher du panier.
shoppingCartDetail.shoppingCartTotalQuantity Obligatoire.
Quantité totale d'articles du panier.
shoppingCartDetail.shoppingCartItemList.itemX.productCategory Obligatoire.
Catégorie du produit commandé.
Exemple : 1

1 : Alimentation et Gastronomie

2 : Auto et Moto

3 : Culture et Divertissements

4 : Maison et Jardin

5 : Electroménager

6 : Enchères et Achats groupés

7 : Fleurs et Cadeaux

8 : Informatique et Logiciels

9 : Santé et Beauté

10 : Services aux particuliers

11 : Services aux professionnels

12 : Sport

13 : Vêtements et Accessoires

14 : Voyage et Tourisme

15 : Hifi, Photo et Vidéos

16 : Téléphonie et Communication

17 : Bijoux et Métaux précieux

18 : Articles et Accessoires pour bébé

19 : Sonorisation et Lumière

shoppingCartDetail.shoppingCartItemList.itemX.productName Obligatoire.
Nom du produit commandé.
shoppingCartDetail.shoppingCartItemList.itemX.productQuantity Obligatoire.
Quantité de produits dans le panier.
shoppingCartDetail.shoppingCartItemList.itemX.productUnitAmount Obligatoire.
Montant unitaire du produit.
Le montant doit être transmis dans la plus petite unité de la devise.

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 = 00
authorisationId = (voir le Dictionnaire des données).
paymentMeanBrand = FRANFINANCE_3X ou FRANFINANCE_4X
paymentMeanType = ONLINE_CREDIT
responseCode = 00
Vous pouvez livrer la commande.
Transation en attente acquirerResponseCode = 60
responseCode = 60
L’autorisation est en attente de confirmation.
Ensuite, le batch de confirmation mettra automatiquement à jour la transaction une fois le résultat définif obtenu.
Annulation de l'acheteur responseCode = 17 N/A
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.

L’acceptation du moyen de paiement Franfinance 3xWEB et 4xWEB n’est pas disponible au travers de la solution Sherlock’s Office.

Les opérations suivantes sont disponibles sur les transactions Franfinance 3xWEB et 4xWEB :

Gestion de caisse
Annulation X
Validation X
Remboursement V
Duplication 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é :


Schéma trop complexe à décrire, merci de contacter le support sips@worldline.com

La transaction passera de l'état Captured à l'état Credited une fois qu'elle sera remboursée complètement. En cas de timeout, la transaction passera temporairement à l'état TO_CONFIRM_CREDIT.

Pour tester Franfinance 3xWEB et 4xWEB, envoyez une requête à l'url correspondante à votre connecteur :

  • Sherlock’s Paypage POST : https://payment-webinit-sherlocks.test.sips-services.com/paymentInit
  • Sherlock’s Paypage SOAP : https://payment-webinit-sherlocks.test.sips-services.com/services/v2/paymentInit
  • Sherlock’s Paypage JSON : https://payment-webinit-sherlocks.test.sips-services.com/rs-services/v2/paymentInit

Les journaux mis à disposition par Sherlock's 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 Franfinance 3xWEB et 4xWEB 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 X
Note: pour les transactions Franfinance 3xWEB et 4xWEB, le champ paymentMeanBrand est renseigné avec la valeur FRANFINANCE_3X ou FRANFINANCE_4X.

Il s’agit de mettre à disposition d'un état quotidien rapprochant :

Les opérations envoyées par FRANFINANCE (remises au débit et/ou au crédit), d'une part, et les transactions effectuées sur Sherlock's, d'autre part.

Chaque fichier contient, entre autres, les transactions créditées ou débitées sur vos comptes. Chaque fichier est global pour tous les commerçants.

Sherlock's reçoit ces fichiers et les rapproche des transactions (débits et crédits) remisées.

A partir de ce rapprochement, Sherlock's vous envoie le Journal de rapprochement des transactions. L’envoi du journal de rapprochement est désynchronisé par rapport au traitement des fichiers de Franfinance.

Ce type de journal permet d’avoir une réelle information quant à la remise effective du paiement ou du financement côté Franfinance.

Pour définir les états du rapprochement, deux délais (après la date de remise Sherlock's) sont définis :

  • un délai de 30 jours correspond à la durée normale durant lequel une transaction doit être rapprochée ;
  • un délai de 40 jours correspond à la période maximale après la date de la transaction durant laquelle une transaction peut être rapprochée. Au-delà de ce délai, la transaction n’est plus « rapprochable ».

Le délai entre 30 et 40 jours correspond à l’intervalle de temps durant lequel Franfinance devra analyser la cause du non rapprochement. Lorsque les 40 jours seront écoulés, la transaction sera considérée comme non rapprochée.

Après l'analyse des critères de rapprochement définis ci-dessus, les différents états de rapprochement possibles sont les suivants :

Etat pour la transaction Décision commerçant / Information Franfinance
Présence fichier

MATCH_OK

MATCH_INFO (Franfinance indique une information concernant la livraison)

Absence fichier

30 jours < MATCH_WARNING ≤ 40 jours (**)

40 jours < MATCH_ERROR (**)

Les détails appartenant aux opérations acceptées lors du contrôle des contrats sont comparés avec les transactions traitées par Sherlock's.

Les informations d'une opération qui correspond à une transaction sont conservées et remontées dans le Journal de rapprochement des transactions. Celui-ci est envoyé au client.

Le statut du rapprochement pour cette transaction devient alors MATCH_OK.

Dans le cas ou Franfinance mentionne un avertissement particulier pour cette transaction, le statut, certes « matché » techniquement, devient MATCH_INFO.

Pour ce type de statut, la colonne SPECIFIC_DATA du JRT permet de connaître la raison de l'avertissement.

Code Franfinance fourni dans RGI et renvoyé au commerçant dans la colonne SPECIFIC_DATA Etat technique véhiculé dans JRT
00 - Financement garanti – livraison MATCH_OK
00 – Remboursement pris en compte MATCH_OK
02 - Financement refusé – ne pas livrer MATCH_INFO
03 - Annulation de la transaction – ne pas livrer MATCH_INFO
XX - Autres libellés libres (ne débutant pas par 00) MATCH_INFO
YY - Autres libellés libres (ne débutant pas par 00) MATCH_INFO

Les transactions envoyées en remises et non créditées sur votre compte sont soumises à analyse.

Le statut de rapprochement des transactions dont la date de paiement est supérieure de 30 jours et dont l’état est toujours MATCH_WAIT deviendra MATCH_WARNING.

De la même façon, le statut des transactions dont l’état est MATCH_WARNING dont la date de paiement est supérieure de 40 jours deviendra MATCH_ERROR.

Un rapport des anomalies de rapprochement est alors généré pour analyse.

Vous pouvez consulter vos transactions Franfinance 3xWEB et 4xWEB et effectuer différentes opérations de gestion de caisse grâce à Sherlock's Gestion.



Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Fermer

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation Sherlock's.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres