Introduction
Worldline 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 du moyen de paiement Franfinance 3xWEB et 4xWEB dans Worldline Sips.
À qui s’adresse ce document ?
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 Worldline Sips, nous vous conseillons de consulter les documents suivants :
- Présentation fonctionnelle
- Guide de configuration des fonctionnalités
Comprendre les paiements Franfinance 3xWEB et 4xWEB avec Worldline Sips
Principes généraux
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.
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 | 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 |
Pages de paiement
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 Worldline Sips 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 Sips 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.
Ouvrir votre contrat d’acceptation Franfinance 3xWEB et 4xWEB
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.
Effectuer un paiement Franfinance 3xWEB et 4xWEB
Vous pouvez proposer le moyen de paiement Franfinance 3xWEB et 4xWEB au travers de Sips 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 :
Effectuer un paiement Franfinance 3xWEB et 4xWEB avec Sips Paypage
La cinématique de paiement pour Sips Paypage est décrite ci-dessous :
Paramétrer la requête de paiement
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
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. |
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é | acquirerResponseCode = 00
authorisationId = (voir le
Dictionnaire des données).paymentMeanBrand =
FRANFINANCE_3X ou FRANFINANCE_4XpaymentMeanType =
ONLINE_CREDITresponseCode =
00 |
Vous pouvez livrer la commande. |
Transation en attente | acquirerResponseCode =
60responseCode =
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.
Effectuer un paiement Franfinance 3xWEB et 4xWEB avec Sips Office
L’acceptation du moyen de paiement Franfinance 3xWEB et 4xWEB n’est pas disponible au travers de la solution Sips Office.
Gérer vos transactions Franfinance 3xWEB et 4xWEB
Opérations de caisse disponibles
Les opérations suivantes sont disponibles sur les transactions Franfinance 3xWEB et 4xWEB :
Gestion de caisse | ||
---|---|---|
Annulation | X | |
Validation | X | |
Remboursement | V | |
Duplication | 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é :
Tester Franfinance 3xWEB et 4xWEB
Pour tester Franfinance 3xWEB et 4xWEB, envoyez une requête à l'url correspondante à votre connecteur :
- Sips Paypage POST : https://payment-webinit.test.sips-services.com/paymentInit
- Sips Paypage SOAP : https://payment-webinit.test.sips-services.com/services/v2/paymentInit
- Sips Paypage JSON : https://payment-webinit.test.sips-services.com/rs-services/v2/paymentInit
Consulter vos transactions Franfinance 3xWEB et 4xWEB
Journaux
Les journaux mis à disposition par Worldline 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 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 |
Rapprochement des transactions Franfinance 3xWEB et 4xWEB
Principe
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 Worldline Sips, 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.
Worldline Sips reçoit ces fichiers et les rapproche des transactions (débits et crédits) remisées.
A partir de ce rapprochement, Worldline Sips 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.
Table des états de rapprochement des transactions
Pour définir les états du rapprochement, deux délais (après la date de remise Worldline Sips) 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 (**) |
Rapprochement avec les transactions
Les détails appartenant aux opérations acceptées lors du contrôle des contrats sont comparés avec les transactions traitées par Worldline Sips.
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 |
Transactions non rapprochées
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.
Sips Office Extranet
Vous pouvez consulter vos transactions Franfinance 3xWEB et 4xWEB et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.