Cette page contient des conseils d'intégration notamment les données nécessaires au calcul de scoring en fonction du secteur d'activités. La documentation technique complète est disponible via le lien suivant : FLOA - Integration
| Logo |
|
|---|---|
| Info |
|
Sommaire
Parcours de paiement
*Les étapes 1 et 3 sont effectuées via Axepta
** L'éligibilité permet d'estimer le niveau de confiance attribué à une demande de paiement par un client. Cela implique un traitement statistique des données historiques relatives aux commandes des clients. L'éligibilité peut être réévaluée à l'aide des renseignements contenus dans le Fichier national des incidents de remboursement de crédits personnels (FICP).
Onboarding
Après signature du contrat
Le commerçant reçoit un mail de l'équipe 'Professional Services' de chez Floa, qui va l'accompagner sur la mise en place de FLOA.
Cette équipe sera notamment en charge de la mise en production de FLOA chez le commerçant.
Réception des identifiants de recette et de production
Une fois la configuration technique effectuée, FLOA transmet au commerçant un fichier Excel (cf. ci-dessous) contenant les identifiants de recette et de production.
Données FLOA
Les données clés à utiliser dans les requêtes sont le MerchandID (ou code marchand) et les MerchantSiteID (ou code guichet) .
Vous trouverez ci-dessous une description des identifiants de recette et de production.
| Données | Détail | Correspondance API AXEPTA |
|---|---|---|
| MerchandID (ou code marchand) | ID Marchand créé sur la plateforme FLOA - Donnée optionnelle | MerchantIDExt |
| MerchantSiteID (ou code guichet) | Identifiant unique créé par FLOA pour chacun des moyens de paiement souscrit par le marchand (3X/4X/capture manuelle/capture automatique) | PayType |
| MIN | Panier Minimum - En dessous de ce montant, le paiement ne pourra pas être effectué via FLOA | - |
| MAX | Panier Maximum - En delà de ce montant, le paiement ne pourra pas être effectué via FLOA | - |
Demande d'inscription FLOA sur Axepta
Une fois le fichier Excel réceptionné, le commerçant l'envoi à son chargé d'affaires BNP Paribas en spécifiant le MerchandID Axepta.
Le partage de cet élément est impératif afin que les équipes BNP Paribas puissent procéder à la configuration du MerchandID.
Intégration dans le site marchand
Mise en place des principes règlementaires FLOA
FLOA met à disposition des marchands un ensemble de ressources réglementaires et marketing nécessaire afin de répondre aux obligations légales et d'optimiser le taux de conversion.
Pour plus d'informations : Ressources réglementaires et marketing
Une fois FLOA intégré dans le site marchand, le commerçant contacte le service marketing de FLOA (marketing@floa.com) afin que celui-ci procède aux vérifications nécessaires à la mise en production.
FLOA doit valider la conformité des exigences réglementaires et marketing afin de procéder à la mise en production.
Affichage de l'échéancier
L'échéancier FLOA peut être simulé et affiché sur le site du marchand afin que les clients puissent se projeter dans leurs acte d'achat.
Pour utiliser ce levier de conversion vous devez utiliser le paramètre spécifique''&EventToken=SCHEDULE" dans votre requête.
Le calcul de l'échéancier est basé sur le montant total envoyé dans la requête.
Exemple
Requête
&TransID=TID603510031101338549 &MerchantID=BNP_DEMO_AXEPTA &RefNr=ADDZ3022302 &Amount=20000 &Currency=EUR &MerchantIDExt=38 &PayType=7017 &CustomerID=ID_User_13130307 &EventToken=SCHEDULE
Réponse
mid=BNP_DEMO_AXEPTA &PayID=00000000000000000000000000000000 &scheduleinfo=20480;24/04/2023;5120;24/05/2023;5120;23/06/2023;5120;23/07/2023;5120 &Code=00000000 &Status=OK &Description=success &CodeExt=0 &errortext=Request successfully processed &MAC=2196D6D553359AC1A7F62593B1E3E297E433651CD2E4A82BC57621C62C182665
Vous retrouverez dans le champ ''scheduleinfo="
<Montant Total>;<Date échéance 1>;<Montant1>;<Date échéance 2>;<Montant 2>;<Date échéance 3>;<Montant 3>
Le montant est toujours affiché en centimes.
Documentation technique
Vous trouverez le détail de l'intégration technique dans la section suivante : FLOA - Integration
La section Tester FLOA contient les données de test ainsi qu'un pas à pas pour réaliser une requête FLOA.
Préconisations
Cas standard
Vous trouverez ci-dessous les paramètres obligatoires à transmettre dans vos requêtes afin de calculer l'éligibilité.
Ces paramètres permettent de calculer le score client associé à chaque transaction.
| Paramètres | Description | Lien | Format minimal préconisé |
|---|---|---|---|
| Salutation | Genre | - | - |
| MaidenName | Nom de jeune fille - Obligatoire si Mrs | - | - |
| DateOfBirth | Date de naissance | - | - |
| PlaceOfBirth | Département de naissance | - | - |
| CustomerHistory | Donnée du client final | Customer History JSON Object | {
"firstOrderDate": "01/01/2023",
"lastOrderDate": "01/02/2023"
}
|
| ProductDetails | Donnée du panier | Product Details JSON Object | {
"categorie1": "Categorie 1 de produit",
"categorie2": "Categorie 2 de produit"
}
|
Voyage/Tourisme
En complément des paramètres ci-dessus, si le marchand exerce une activité liée au tourisme ou au voyage, il est nécessaire d'ajouter les paramètres suivants.
| Paramètres | Description | Lien | Format minimal préconisé |
|---|---|---|---|
| ProductDetails | Donnée du panier | Product Details JSON Object | Utiliser une des valeurs suivantes :
{
"categorie1": "AIRLINE TICKET"
}
|
| TravelDetails | Paramètre relatif au voyage : billets d'avion, informations passeport.... | Travel Details JSON Object | {
"insurance": "AXA",
"travelType": "TwoWay",
"departureDate": "21/11/2022 12:20",
"returnDate": "14/12/2022 12:20",
"destinationCountry": "FR",
"ticketCount": 2,
"travellerCount": 2,
"travelClass": "Economy",
"ownTicket": 1,
"mainDepartureCompany": "CDG",
"departureAirport": "cdg",
"arrivalAirport": "dub",
"luggageSupplement": "1"
}
|
| StayDetails | Paramètre relatif aux services hôteliers | Stay Details JSON Object | {
"company": "Ibis",
"destination": "Dublin",
"roomRange": 2
}
|
Pays
En fonction des pays contractualisés, certains paramètres sont obligatoires.
Vous trouverez ci-dessous un tableau synthétique reprenant la liste des paramètres spécifiques pour chaque pays.
| Paramètres API AXEPTA | Belgique | Espagne | Italie | Portugal |
|---|---|---|---|---|
| Language | nl-BE en-BE | es-ES | it-IT | pt-PT |
| AddrCountryCode | BE | ES | IT | PT |
| PersonID | NA | Obligatoire | Obligatoire | Obligatoire |
Vous trouverez des PersonID de test dans la section : Tester FLOA
Recette
Préconisation et prérequis de test FLOA
Vous trouverez ci-joint, le kit de recette FLOA,
Lors de vos activités de test nous vous invitons à vérifier que:
- Les champs MerchantIDExt et Paytype de recette sont bien bien renseignés.
- La valeur du champ Amount est comprise entre le montant minimum et maximum préalablement contractualisé
- La valeur du champ Amount est le montant exprimé en centimes
- Les champs ProductDetails et CustomerHistory contiennent des objets JSON encodés en base64 - Basics of Base64-encoding EN
- Le paramètre AddrCountryCode est renseigné
- Le paramètre Language correspond à la langue du pays cible
Mise en production
La mise en production se déroule selon les étapes suivantes :
- Validation fonctionnelle par FLOA
- L'équipe 'Professional Services' de FLOA, qui accompagne le commerçant dans la mise en place de FLOA, réalise un test jusqu’au paiement pour chaque solution intégrée sur le site marchand. Tous les produits seront testés.
- Ex : si le marchand a demandé du 3XG et 4XG, FLOA fera donc 1 test sur la solution 3XG et 1 test sur la solution 4XG.
- Validation Marketing par FLOA
- L'équipe Marketing de FLOA vérifie :
- Toutes les mises en avant de FLOA ou des solutions de paiement en plusieurs fois dans le parcours
- L’affichage des mentions légales dans les conditions générales de vente du commerçant
- L'équipe Marketing de FLOA vérifie :
- Mise en production par le commerçant
- Le commerçant ouvre FLOA sur son site marchand