Integration mode to choose if you want to have control over all the steps of the order.
In Full API integration, you will oversee the calls concerning the eligibility of the customer but also the payment.
- A dedicated and not shared IP
- This integration method requires PCI-DSS certification
- Calls to FLOA services must be made on the server side, the authentication token being provided for each call to our services must not be on the client side
This integration offers the following advantages :
- You master all the steps of the order
- You set up your own payment page
Disadvantages of this integration :
- Requires PCI-DSS certification
- More developments are needed to integrate all the calls to the different services
Workflow for 3DS payment
Services to call for 3DS payment
For a 1XD payment, specify the number of days of deferment in reportDelayInDays
For better tracking of the orders, we recommend you put the same value in presaleFolder/shoppingCarts/reference for the PreEligibility and Eligibility
In the case of a 1XD payment, indicate the number of deferred days in reportDelayInDays
In the case of a iXC payment, birthDate, birthZipCode, maidenName are not mandatory
Call JS ThreatMetrix
ThreatMetrix is a fraud detection tool used by Floa. For efficient detection, it is necessary to implement the call to a ThreatMetrix JS function to collect some data about the customer.
If you can't do it, apply a 3 second timer when clicking on the pay button.
The call must consist of the following :
Production : b0st0pm3
|OrderRef||Unique order reference on the merchant side|
Value that will be sent in order/orderRef when calling Check enrollment
|ScoringToken||Scoring token issued if scoring positive (customer eligible for FloaPay payment)|
Value returned in eligibilities/token of the Eligibility service
|PaymentAttempt||Number of the payment attempt. Starting with 1|
For better tracking of orders, we recommend you put the same value in order/orderRef as presaleFolder/shoppingCarts/reference
In the case of a 1XD payment, indicate the number of deferred days in options/reportDelayInDays
The orderData/orderTag field, present in the service contract, must not be used.
ACS page (3DS code entry)
User´s redirection to the URL returned by the 3D enrollment service card3dsRedirectionData.redirectionUrl (Redirection operated by the merchant)
Back from ACS
Redirect the user to the URL specified in returnUrl when calling the 3D enrollment service.
Validate authentication AND authorize / payment
Put the same value in order/orderRef as order/orderRef when calling the 3DS enrollment.
In the case of a 1XD payment, specify the number of days of deferment in options/reportDelayInDays