Logo | |
---|---|
Info |
|
SommaireSummary
Table of Contents |
---|
Payment journey
*Steps 1 and 3 are performed via by Axepta
** Eligibility is used to estimate the level of confidence assigned to a payment request by a customer.
This involves statistical processing of historical data relating to customer orders. Eligibility can be reassessed using information contained in the National Personal Credit Repayment Incident File (FICP).
Onboarding
After signing the contract
The merchant receives an email from 'Professional Services' Floa team, who will accompany him regarding FLOA duringFLOA implementation.
This team will be in charge of FLOA production plan the deployement in production mode on FLOA side.
Identifier : Sandbox/Production
Once the technical configuration has been completedis complete, FLOA sends to the merchant an Excel file (see below) containing with the recipe test and production identifierscrendentials.
The key data to be used in queries are the MerchandID and the MerchantSiteID.
You will find below a short recipe description and production identifiers.
DATA | Detail | Correspondance API AXEPTA Mapping |
---|---|---|
MerchandID | Merchant ID created by FLOA platform - Optional data | MerchantIDExt |
MerchantSiteID | Unique identifier created by FLOA for each of the payment methods purchased by the merchant (3X/4X/manual capture/automatic capture) | PayType |
MIN | Panier Minimum - En dessous de ce montant, le paiement ne pourra pas être effectuécustomer Cart - Below this amount, payment cannot be made via FLOA | - |
MAX | Panier Maximum - En delà de ce montant, le paiement ne pourra pas être effectuécustomer Cart - Beyond this amount, payment cannot be made via FLOA | - |
Demande d'inscription FLOA sur Axepta
Le partage de cet élément est impératif afin que les équipes BNP Paribas puissent procéder à la configuration du MerchandID.
FLOAregistrationrequestonAxepta
Once the Excel file has been received, the merchant sends it to his BNP Paribas account manager specifying the Axepta Merchand ID.
Sharing this element is imperative so that BNP Paribas teams can proceed with the MerchandID configuration.
Onboarding on merchant website
Implementation of FLOA regulatory principles
FLOA provides merchants with a set of regulatory and marketing resources necessary due to legal obligations and optimize the conversion rate.
More information: Regulatory and marketing resources
Once FLOA is integrated on the merchant site, the merchant contacts the marketing department of FLOA (marketing@floa.com) so that it can carry out the necessary checks to put in production.
Warning |
---|
FLOA must validate compliance with regulatory and marketing requirements in order to proceed with production environement. |
Payment schedule displayer
The FLOA payment schedule can be simulated and displayed on the merchant's website so that customers can project themselves into their purchases.
To use this conversion tool, you must use the specific parameter ''&EventToken=SCHEDULE'' in your request.
Tip |
---|
The schedule calculation is based on the total amount submitted in the request. |
Example :
Request
Code Block |
---|
&TransID=TID603510031101338549
&MerchantID=BNP_DEMO_AXEPTA
&RefNr=ADDZ3022302
&Amount=20000
&Currency=EUR
&MerchantIDExt=38
&PayType=7017
&CustomerID=ID_User_13130307
&EventToken=SCHEDULE |
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 |
---|
You will find in the field ''scheduleinfo=" <Total amount>;<Schedule date 1>;<Amount1>;<Schedule date 2>;<Amount 2>;<Schedule date 3>;<Amount 3> |
Tip |
---|
The amount is always displayed in cents. |
Technical documentation
You will find the technical integration details in the following section:
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.
Warning |
---|
FLOA doit valider la conformité des exigences réglementaires et marketing afin de procéder à la mise en production. |
Documentation technique
Vous trouverez le détail de l'intégration technique dans la section suivante : FLOA Pay Direct Integration - Documentation Axepta BNP Paribas - Axepta
Tip |
---|
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
The FLOA Test contains test data aswellas a step-by-steptoperformaFLOA payment request |
Recommendations
Standard case
You will find below the mandatory parameters to include in your request in order to calculate eligibility.
These parameters are used to calculate the customer score associated for each
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 | GenreGender | - | - | |||||
MaidenNameNom de jeune fille - Obligatoire si | Mrs Maiden name - mandatory if Mrs Mrs | - | - | |||||
DateOfBirth | Date de naissance of birth | - | - | |||||
PlaceOfBirthDépartement de naissance | Birth Zip Code | - | - | |||||
CustomerHistory | Donnée du client finalCustomer data | Customer History JSON Object |
| |||||
ProductDetailsDonnée du panier | Customer cart data | Product Details JSON Object |
|
Travel/
TourismeTourism
In addition, if the merchant has an activity related to tourism or travel, it is necessary to add the following parametersEn 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é | |||||
---|---|---|---|---|---|---|---|---|
ProductDetailsDonnée du panier | Customer cart data | Product Details JSON Object | Utiliser une des valeurs suivantes Use the following values :
| |||||
TravelDetails Paramètre | relatif au voyage : billets d'avion, informations passeport... Travel parameter: airline tickets, passport information, etc. | Travel Details JSON Object |
| |||||
StayDetails | Paramètre relatif aux Hotelservices hôteliersparameter | Stay Details JSON Object |
|
Pays
Country
Depending which countries you have contracted, additional mandatory parameters must be added.
You will find belowasummarytablelistingthespecificparametersforeachcountryEn 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 | BelgiqueBelgium | EspagneSpain | ItalieItaly | Portugal |
---|---|---|---|---|
Language | nl-BE en-BE | es-ES | it-IT | pt-PT |
AddrCountryCode | BE | ES | IT | PT |
PersonID | NA | ObligatoireMandatoryObligatoire | Mandatory | ObligatoireMandatory |
Tip |
---|
Vous trouverez des PersonID de test dans la section : Tester FLOA |
Recette
Préconisation et prérequis de test FLOA
You will find test PersonIDs in the section: Test FLOA |
Testing
FLOAtest recommendation andprerequisites
During your testing activities we invite you to check that:
- The MerchantIDExt and Paytype recipe fields are well informed.
- The value of the Amount field is between the minimum and maximum amount previously contracted
- The value of the Amount field is the amount valued in cents
- The ProductDetails and CustomerHistory fields contain base64-encoded JSON objects -
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 :
- The AddrCountryCode parameter is populated
- The Language parameter corresponds to the country language
Production environnement
The steps for the deployment in production are :
- FLOA Functional validation
- FLOA's 'Professional Services' team, which supports the merchant FLOA implementation, carries out testing until payment for each solution integrated on the merchant site. All products will be tested.
- Ex: if the merchant has requested 3XG and 4XG, FLOA will do 1 test on the 3XG solution and 1 test on the 4XG solution.
- FLOA Marketing validation
- The FLOA Marketing team checking:
- All the visible highlights of FLOA and payment solutions along the customer journey
- The legal notices display and the merchant's general sales conditions
- Merchant Production Onboarding.
- The merchant opens FLOA on his website.
- The FLOA Marketing team checking:
- 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
- Le commerçant ouvre FLOA sur son site marchand