Tip |
---|
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 | Image Removed Image Added
|
---|
Info | - Proposer à vos clients du paiement différé, en 3X ou 4X.
- Parcours rapide et réponse immédiate.
- Aucune pièce justificative à traiter. La carte du client doit être en cours de validité dans le cadre éventuel d'un remboursement.
- 100% en ligne via un PC ou une tablette.
- 100% Garanti : le marchand est protégé contre les impayés et la fraude.
- Règlement à J+2 maximum de la totalité de la transaction.
- Possibilité de configurer la capture en automatique ou manuelle
|
---|
*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).
Réception des données d'accès
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éeA l'issue du processus d'onboarding, FLOA transmet au marchand commerçant un fichier Excel (cf. ci-dessous) contenant des données techniquesles identifiants de recette et de production.
Image Modified
Tip |
---|
|
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 productionSeules certaines données seront à utiliser lors de la conception de la requête.
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 | - |
Tip |
---|
|
Les données clés à utiliser dans les requêtes sont le MerchandID (ou code marchand) et les MerchantSiteID (ou code guichet)
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
Kit marketing
Mise en place des principes règlementaires FLOA
FLOA met à disposition des marchands un ensemble de ressources marketing permettant d'aider à la mise en place les solutions de paiement FLOAréglementaires et marketing nécessaire afin de répondre aux obligations légales et d'optimiser le taux de conversion.
Pour plus d'informations : Kit marketing FLOA
Certaines données interviennent dans le calcul de risque
MaidenName
CustomerHistory
ProductDetails
Données nécessaires pour ....
Paramètres | France | Belgique | Espagne | Italie | Portugal |
---|
MobileNr | à inclure | à inclure | à inclure | à inclure | à inclure |
PlaceOfBirth | à inclure | à inclure | à inclure | à inclure | à inclure |
DateOfBirth | à inclure | à inclure | à inclure | à inclure | à inclure |
Salutation | à inclure | à inclure | à inclure | à inclure | à inclure |
PersonID | pas de NIF | pas de NIF | Renseigner la valeur Nif de test: 40919740A | Renseigner la valeur Nif de test: RSSMRA74D22A001Q | Renseigner la valeur Nif de test: 999999999 |
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.
Warning |
---|
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.
Tip |
---|
Le calcul de l'échéancier est basé sur le montant total envoyé dans la requête. |
Requête
Code Block |
---|
&TransID=TID603510031101338549 |
Paramètre API AXEPTA | Belgique | Espagne | Italie | Portugal |
---|
Language | nl-BE en-BE | es-ES | it-IT | pt-PT |
AddrCountryCode | BE | ES | IT | PT |
PersonID | Absent | Obligatoire | Obligatoire | Obligatoire |
Construction de la requête de test
Le marchand récupère dans un premier temps le Login et mot de passe Axepta reçu au préalable par e-mail après sa contractualisation.
Vous trouverez ci-dessous les informations nécessaires au bon paramétrage de la requête de test :
Info |
---|
title | Configuration du compte de test |
---|
|
MerchantIdext : 38 Montant minimum d'une commande de test : 100€ Montant maximum d'une commande de test : 2000€ |
ID de test :
Pays | Moyen de paiement | MerchantSiteId | Méthode de capture |
France | 3X | 7369 | Automatic |
France | 3X | 7240 | Manual |
France | 4X | 7017 | Automatic |
France | 4X | 7235 | Manual |
France | 1XD | 7377 | Automatic |
France | 1XC | 70657 | Automatic |
France | 3XD | 7378 | Automatic |
France | 10X | 7286 | Automatic |
Spain | 3X | 7936 | Automatic |
Spain | 3X | 71085 | Manual |
Spain | 4X | 7594 | Automatic |
Spain | 4X | 71086 | Manual |
Spain | 1XD | 7929 | Automatic |
Italy | 3X | 7934 | Automatic |
Italy | 3X | 71089 | Manual |
Italy | 4X | 7937 | Automatic |
Italy | 4X | 71082 | Manual |
Italy | 1XD | 71122 | Automatic |
Portugal | 4X | 7938 | Automatic |
Portugal | 4X | 71088 | Manual |
Portugal | 1XD | 70838 | Automatic |
Liste des paramètres d'une requête Floa
Liste des paramètres
Info |
---|
Pour en savoir plus sur le paramétrage de la requête dirigez-vous vers le lien suivant : |
Exemple de requête de test standard
Code Block |
---|
TransID=TID-603512401222998545
&MerchantID=BNP_DEMO_AXEPTA
&RefNr=AEEZA92ADDZ3022302
&Amount=20000
&Currency=EUR
&URLSuccess=https://www.paytest.org/ct-test-1/success.php&URLFailure=https://www.paytest.org/ct-test-1/failure.php
&URLNotify=https://www.paytest.org/ct-test-1/notify.php
&TermURL=https://www.paytest.org/ct-test-1/term.php
&Response=encrypt
&Response=encrypt
&MerchantIDExt=38
&PayType=73697017
&CustomerID=ID_User_123456713130307
&FirstName=John
&LastName=Doe
&MobileNr=0607080910
&Email=john.doe@mail.com
&AddrStreet=rue du marche
&AddrZIP=75001
&AddrCity=PARIS
&AddrCountryCode=FR
&Date=25/10/2022
&FirstOrderDate=05/07/2022
&LastOrderDate=25/10/2022
&Channel=DESKTOP
&DeliveryChannel=STD
&NumberArticles=3
&Homepage=https://axepta.bnpparibas/&URLBack=https://axepta.bnpparibas/
&ProductDetails=ewogICAgImNhdGVnb3JpZTEiOiAiQ2F0ZWdvcmllIDEgZGUgcHJvZHVpdCIsCiAgICAiY2F0ZWdvcmllMiI6ICJDYXRlZ29yaWUgMiBkZSBwcm9kdWl0IiwKICAgICJjYXRlZ29yaWUzIjogIkNhdGVnb3JpZSAzIGRlIHByb2R1aXQiCn0=
&MAC=5d32e54bc3628698e59b7a9830617ad9135ad3faac24fdc2d2ed6f554c40c719 |
Info |
---|
title | Les points d'attention |
---|
|
Avant de commencer la phase de test
1) Vérifiez au préalable la bonne configuration de votre compte de test par les équipes Axepta Online.
2) Vérifiez que les paramètres MerchantID, clé Hmac, clé Blowfish, soit ceux à utiliser en environnement de recette Axepta Online.
3) Vérifiez que la valeur MerchantIDExt=38 est bien renseigné dans votre requête.
4) Vérifiez que la valeur du champ Amount soit bien comprise entre 100 et 2000 euro. Vous devez veiller également à bien spécifier la valeur Amount en centime dans votre requête.
5) Vérifiez que les champs suivants soient bien renseignés et cryptés dans le paramètre ProductDétails (mandatory)
ex ci dessous:
{
"categorie1": "Categorie 1 de produit",
"categorie2": "Categorie 2 de produit",
"categorie3": "Categorie 3 de produit"
}
5) Vérifiiez que le paramètre AddrCountryCode du pays que vous souhaitez tester soit bien renseigné dans votre requête.
6) Vérifiez que le paramètre Language correspond bien au pays de la page de paiement que vous souhaitez tester.
Après avoir finalisé un paiement de test:
7) Vérifier que les champs TransID, RefNr, CustomerID, sont bien unique dans votre requête avant de relancer un nouveau paiement.
End point
Info |
---|
|
https://paymentpage.axepta.bnpparibas/floapay.aspx |
La page de fichage
Image Removed
Pendant vos tests si certains paramètres ne sont pas indiqués dans votre requête initiale, vous serez alors redirigé avant le paiement sur une page appelé "page de fichage" ou il vous sera tenu d'indiquer manuellement les informations manquantes afin d'accéder à la page paiement.
Les informations demandées dans la page de fichage sont obligatoire, ces informations peuvent varier en fonction de la configuration du pays utilisé pendant vos tests.
Vous trouverez ci-dessous un tableau synthétique reprenant la liste des paramètres par pays à renseigner dans la requête FloaPay pour être redirigé directement sur la page de paiement.
Info |
---|
Si ces informations ne sont pas présente initialement dans votre requête, votre client sera alors redirigé vers la page de fichage et devra compléter ses éléments à la main avant de pouvoir procéder au paiement. |
La page de paiement
Vous pourrez ensuite saisir les informations carte relatives à la carte de test FloaPay.
Image Removed
Cartes de test FLOA :
Réponse
Code Block |
---|
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 |
Info |
---|
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> |
Tip |
---|
Le montant est toujours affiché en centimes. |
Vous trouverez le détail de l'intégration technique dans la section suivante : FLOA - Integration
Tip |
---|
La section Tester FLOA contient les données de test ainsi qu'un pas à pas pour réaliser une requête FLOA. |
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 |
Code Block |
---|
| {
"firstOrderDate": "01/01/2023",
"lastOrderDate": "01/02/2023"
} |
|
ProductDetails | Donnée du panier | Product Details JSON Object |
Code Block |
---|
| {
"categorie1": "Categorie 1 de produit",
"categorie2": "Categorie 2 de produit"
} |
|
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 : - AIRLINE TICKET
- TRAIN TICKET
- BUS TICKET
- HOTEL
- CAMPING
- STAY
- CRUISE
- CAR RENTAL
- OTHER
Code Block |
---|
| {
"categorie1": "AIRLINE TICKET"
} |
|
TravelDetails | Paramètre relatif au voyage : billets d'avion, informations passeport.... | Travel Details JSON Object | |
Type de carte | Numéros de carte | date d'expiration | code sécurité | Fonction |
---|
Carte OK | 5017679110380400 | Toujours supérieure à la date du jour | 000 | Simule le comportement d'un paiement valide |
Carte KO | 5017679100900712 | Toujours supérieure à la date du jour | 000 | Simule le comportement d'un paiement invalide |
Paramétrages spécifiques selon votre activité
En fonction du type d'activité e-commerce que vous exercez, la requête de paiement FloaPay peut nécessiter l'ajout de paramètres supplémentaires.
C'est le cas des activités de billetterie et d'hôtellerie en ligne où l'ajout du paramètre TravelDetails et du paramètre StayDetails devient obligatoire.
Paramètre relatif aux activités de billetteries en ligne
Info |
---|
Vous trouverez ci-dessous : |
Code Block |
---|
title | Exemple du paramètre TravelDetails en clair |
---|
|
{
"departureDate": "21/11/2022 12:20",
|
|
"returnDate": "14/12/2022 12:20",
"destinationCountry": "FR",
|
|
"travelClass": "Economy",
|
|
"mainDepartureCompany": "CDG",
|
|
"departureAirport": "cdg",
|
|
"discountCode":1",
"",
modificationCancellation": 0 Code Block |
---|
title | Exemple du paramètre TravelDetails crypté à rajouter dans la requête |
---|
collapse | true |
---|
|
&TravelDetails=ew0KICAiaW5zdXJhbmNlIjogIkFYQSIsDQogICJ0cmF2ZWxUeXBlIjogIlR3b1dheSIsDQogICJkZXBhcnR1cmVEYXRlIjogIjIxLzExLzIwMjIgMTI6MjAiLA0KICAicmV0dXJuRGF0ZSI6ICIxNC8xMi8yMDIyIDEyOjIwIiwNCiAgInRpY2tldENvdW50IjogMiwNCiAgInRyYXZlbGxlckNvdW50IjogMiwNCiAgInRyYXZlbENsYXNzIjogIkVjb25vbXkiLA0KICAib3duVGlja2V0IjogMSwNCiAgIm1haW5EZXBhcnR1cmVDb21wYW55IjogIkNERyIsDQogICJkZXBhcnR1cmVBaXJwb3J0IjogImNkZyIsDQogICJhcnJpdmFsQWlycG9ydCI6ICJkdWIiLA0KICAiZGlzY291bnRDb2RlIjogIjEiLA0KICAibHVnZ2FnZVN1cHBsZW1lbnQiOiAiMSIsDQogICJtb2RpZmljYXRpb25DYW5jZWxsYXRpb24iOiAwDQp9 |
StayDetails | Paramètre relatif aux services hôteliers |
Info |
---|
Vous trouverez ci-dessous :
Le détail des champs à crypter pour les activités d'hôtellerie : FLOA Pay Direct Integration - Documentation Axepta BNP Paribas - Axeptatitle | Exemple du paramètre StayDetails en clair | {
"company": "Ibis",
"destination": "Dublin" |
|
,
"nightNumber": 2 Code Block |
---|
title | Exemple du paramètre StayDetails à rajouter crypté dans la requête |
---|
collapse | true |
---|
|
&StayDetails=ew0KICAgICJjb21wYW55IjogIkliaXMiLA0KICAgICJkZXN0aW5hdGlvbiI6ICJEdWJsaW4iLA0KICAgICJuaWdodE51bWJlciI6IDIsDQogICAgInJvb21SYW5nZSI6IDINCn0=
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 |
Tip |
---|
Vous trouverez des PersonID de test dans la section : Tester FLOA |
Préconisation et prérequis de test FLOA
Vous trouverez ci-joint, le kit de recette FLOA,
View file |
---|
name | FLOA Kit recette Axepta.pdf |
---|
height | 250 |
---|
|
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
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
- Mise en production par le commerçant
- Le commerçant ouvre FLOA sur son site marchand