Fields description
There are three types of data to be provided concerning the customer and the order:
- Mandatory data: without this data the request is not valid.
- Necessary data: without this data the information provided to FLOA is not sufficient to guarantee an optimal calculation of the customer's eligibility. The data are not mandatory as such but are highly necessary to be able to return a relevant decision concerning the customer and his purchase. The list of these data will be validated and detailed with FLOA, who will contact the merchant before activation.
You can find below examples of the data required for different sectors of activity - Optional Data: This data concerns any additional information that the merchant may provide about the customer or his shoppingcart that may be relevant to the calculation of customer eligibility.
| Field | Description | Type | Mandatory |
|---|---|---|---|
| MerchantId | Merchant ID (provided by Floa to the merchant) | int | Yes |
| MerchantSiteId | Merchant's site identifier (provided by Floa to the merchant) | string | Yes |
| AgencyCode | Agency/Store ID (provided by Floa to the merchant) | string(50) | Yes (if agencies are set up for the MerchantSiteId) |
| TokenId | Valid STS token obtained when calling the Authenticate method | string | Yes |
| Currency | ISO currency code of the order (e.g. EUR) | enum | Yes |
| Language | Language used (=FR) | enum | Yes |
| PaymentOptionRef | Identifier of the payment method selected by the customer (provided by Floa to the merchant) | string | Yes |
| Country | Country (=FR) | enum | Yes |
| Version | Version of the payment platform used (=1.0) | string | Yes |
| InvoiceId | Unique identifier that characterizes the invoice | String(30) | No |
| freeText | Free text. Special characters are not allowed. | String | No |
| Culture | Language and type of payment page (fr-FR by default) | string | No |
| Hash | HMAC seal (see HMAC calculation) | string | Yes |
| Customer | Customer Information | Customer | Yes |
| Order | Order Information | Order | Yes |
| OptionalCustomerHistory | Customer history data in the merchant's site | OptionalCustomerHistory | No |
| OptionalProductDetails | Product data | OptionalProductDetails | Yes |
| OptionalShippingDetails | Shipping Data | OptionalShippingDetails | No |
| OptionalTravelDetails | Travel data (for the merchant in the travel industry) | OptionalTravelDetails | No |
| OptionalStayDetails | Stay data (for the merchant in the hospitality industry) | OptionalStayDetails | No |
| AdditionalNumericFieldList | Additional fields for free input of integers | AdditionalNumericFieldList | No |
| AdditionalTextFieldList | Additional fields for free input of strings | AdditionalTextFieldList | No |
| Urls | Urls needed in the payment path | Urls | Yes |
| Amounts | Order amounts | Amounts | Yes |
| RequestId | eligibilities[].request_id value returned by the PreEligibility method | long | No |
Customer
| Field | Description | Type | Mandatory |
|---|---|---|---|
| CustomerRef | Unique identification that characterizes the customer in the merchant's IS | string(30) | Yes |
| LastName | Customer’s last name | string(64) | Yes |
| SecondLastName | Second customer’s last name (for Spanish orders) | string(64) | No |
| MiddleName | The middle name (for Netherlands order) | string(64) | No |
| FirstName | Customer’s first name | string(64) | Yes |
| Civility | Civility : Mr, Mrs, Ms (if Miss) | string(3) | No |
| MaidenName | Birth name : necessary for FICP control | string(64) | No |
| BirthDate | Client's date of birth : DD/MM/YYYY format | DateTime | No |
| BirthZipCode | Birth Zip Code (1 or 4 characters refused). 99 if not French, 972 Martinique, 971 Guadeloupe. ‘06000’ for Nice and not '6000'. Always "99" for Portuguese order. | string(8) | No |
| PhoneNumber | Customer's cell phone number For Spanish and Portuguese orders, only numbers with 9 characters are accepted. For Italian orders, only numbers with 6 characters are accepted. | string(6-15) | No |
| CellPhoneNumber | Customer's cell phone number For Spanish, Portuguese and Italian orders, only numbers with 9 characters are accepted. | string(9-15) | No |
| Customer's email | string(60) | Yes | |
| Address1 | Main address | string(32) | No |
| Address2 | Address line 2 (building / apartment / door code) | string(32) | No |
| Address3 | Address line 3 (place) | string(32) | No |
| Address4 | Address line 4 (use as little as possible) | string(32) | No |
| ZipCode | Postal code - France / Spain / Italy / Germany : 5 caracters - Portugal : 8 caracters xxxx-xxx - Netherlands : 7 caracters xxxx aa | string(8) | No |
| City | City | string(50) | No |
| Country | Alpha-2 ISO country code of the customer (FR for France, ES for Spain, ...) | string(2) | Yes |
| Nationality | Nationality- • FR • UE • HorsUE • ES • BE | string(10) | No |
| UniqueClientId | NIF (for Spanish, Portuguese, Italian orders) | string(19) | No |
| IpAddress | IP address | string(39) | No |
| WhiteList | Whitelist • BLACKLIST • UNKNOWN • TRUSTED • WHITELIST | string | No |
*Any character not provided for by the civil status will be rejected and the call will raise an error
Order
| Field | Description | Type | Mandatory |
|---|---|---|---|
| OrderDate | Date of order purchase DD/MM/YYYY | Date | Yes |
| SaleChannel | Sales channel • DESKTOP • TABLET • TABLET_IPAD • SMARTPHONE • SMARTPHONE_ANDROID • SMARTPHONE_IPHONE | string(18) | Yes |
| ShippingMethod | Merchant delivery method • STD : Normal • EXP : Express Delivery • TRK : Tracked • REG : Registered • COL : Colissimo • CHR : Chronopost • REL : Mondial Relay • TNT : TNT • UPS : UPS • TRP : Transporter • MAG : Delivery in store • LCK : Lockers • VIR : Virtual (dematerialized sale) • RIM : Immediate withdrawal in store | string(3) | Yes |
| ShoppingCartItemCount | Number of items | string(3) | Yes |
| ShoppingCartRef | Unique identifier that defines the customer's order. The spaces at the beginning and at the end of the field will be removed. Will be the value of orderRef in the payment notification. | string(30) Do not use special characters. Only letters, numbers and _ | Yes |
| TotalAmount | Total purchase amount in cents | Integer | Yes |
| reportDelayInDays | Number of days of deferral | Integer | No (to be sent only for a deferred cash payment) |
OptionalCustomerHistory
| Field | Description | Type | Mandatory |
|---|---|---|---|
| CanceledOrderAmount | Total amount in cents of canceled orders during the last 2 years | Integer | No |
| CanceledOrderCount | Number of orders placed and then canceled by the customer during the last 2 years | Integer | No |
| FirstOrderDate | Date of the first customer order in DD/MM/YYYY format | Date | Necessary |
| FraudAlertCount | Number of fraud alerts of customer orders in the last 2 years | Integer | No |
| LastOrderDate | Date of last customer order Format: DD/MM/YYYY | Date | Necessary |
| PaymentIncidentCount | Number of payment incidents concerning the customer's orders during the last 2 years | Integer | No |
| RefusedManyTimesOrderCount | Number of orders refused for payment in installments in the last 2 years | Integer | No |
| UnvalidatedOrderCount | Number of orders refused in the validation phase in the last 2 years | Integer | No |
| ValidatedOneTimeOrderCount | Number of orders paid in 1 installment in the last 2 years | Integer | No |
| ValidatedOrderCount | Number of orders validated in the last 2 years | Integer | No |
| ClientIpAddressRecurrence | Customer IP address recurrence | Integer | No |
| OngoingLitigationOrderAmount | Current amounts in dispute not settled | Integer | No |
| PaidLitigationOrderAmount24Month | Amount of litigation settled in the last 2 years | Integer | No |
| ScoreSimulationCount7Days | Number of simulated scores in the last 7 days | Integer | No |
OptionalProductDetails
| Field | Description | Type | Mandatory |
|---|---|---|---|
| Categorie1 | Most expensive product category | string(30) | Yes |
| Categorie2 | Subcategory of the most expensive product | string(30) | No |
| Categorie3 | Brand of the most expensive product | string(30) | No |
OptionalShippingDetails
| Field | Description | Type | Mandatory |
|---|---|---|---|
| ShippingDetailsAdress1 | Main address | string(100) | No |
| ShippingDetailsAdress2 | Address complement 1 (building / apartment / door code) | string(100) | No |
| ShippingDetailsAdressCity | City | string(100) | No |
| ShippingDetailsAdressZip | Postal code | string(5) | No |
| ShippingDetailsAdressCountry | Alpha-2 ISO country code (= FR) | string(2) | No |
OptionalTravelDetails
| Field | Description | Type | Mandatory |
|---|---|---|---|
| Insurance | Type of supplementary insurance chosen by the customer. Depends on the merchant | string(30) | No |
| TravelType | Type of flights : • Unknown : Unknown • OneWay : One way • TwoWay : Round trip • Multiple : Multi-destination | string | No |
| DepartureDate | Start date format: DD/MM/YYYY HH:MM | string | No (Yes if tour operator) |
| ReturnDate | Return date format: DD/MM/YYYY HH:MM | string | No (Yes if tour operator) |
| DestinationCountry | Alpha-2 ISO code of the destination country | string(2) | No (Yes if tour operator) |
| TicketCount | Number of tickets. Note: If the customer has taken additional insurance, this will be reflected in the ShoppingCartItemCount field | Integer | No |
| TravellerCount | Number of passengers | Integer | No (Yes if tour operator) |
| Class | Type of class chosen : • Unknown : Inconnu • Economy : Economy • PremiumEconomy : Premium Economy • Business : Business • First : First • Others : Others | string | No |
| OwnTicket | Indicator to identify whether the holder of the credit card used to fund the trip is participating: 1 = true 0 = false | Boolean | No |
| MainDepartureCompany | Airline Company One Way Flight | string(3) | No |
| TravellerPassportList | Information concerning the passport(s) of the traveler(s) | TravellerPassport | No |
| DepartureAirport | IATA code of the airport of departure | string(3) | No |
| ArrivalAirport | IATA code of the arrival airport | string(3) | No |
| DiscountCode | Discount code | string(30) | No |
| LuggageSupplement | Luggage supplement | string(30) | No |
| ModificationAnnulation | Modification-cancellation | Boolean | No |
TravellerPassport
| Field | Description | Type | Mandatory |
|---|---|---|---|
| ExpirationDate | Passport expiration date in DD/MM/YYYY format Add default time 00:00:00 format example : value="DD/MM/YYYY 00:00:00" | string | No |
| IssuanceCountry | Alpha-2 ISO code of the country of issue of the passport, value in uppercase | string(2) | No |
OptionalStayDetails
| Field | Description | Type | Mandatory |
|---|---|---|---|
| Company | Shipowner/Operator/ Hotel chain | string(50) | No |
| Destination | Destination city | string(50) | No |
| NightNumber | Number of overnight stays | Integer | No |
| RoomRange | Room range | Integer | No |
AdditionalNumericFieldList
| Field | Description | Type | Mandatory |
|---|---|---|---|
| Index | Information index (1 to 10) | Integer | No |
| Value | Value of the information | Integer (Nullable) | No |
AdditionalTextFieldList
| Field | Description | Type | Mandatory |
|---|---|---|---|
| Index | Information index (1 to 10) | Integer | No |
| Value | Value of the information | string(10) | No |
Urls
| Field | Description | Type | Mandatory |
|---|---|---|---|
| MerchantHomeUrl | URL of the merchant's homepage | string | Yes |
| MerchantBackUrl | URL to return to the previous page of the merchant site | string | Yes |
| MerchantReturnUrl | URL through which the customer returns to the merchant site after the payment has been made | string | Yes |
| MerchantNotifyUrl | URL through which the payment platform notifies the merchant site of the outcome | string | Yes |
| MerchantScoringResponseKoUrl | URL where the customer is redirected if not eligible to Floa payment | string | Yes |
Amounts
| Field | Description | Type | Mandatory |
|---|---|---|---|
| OrderFeesAmount | Total amount of fees associated with the order (in cents) | Long | Yes |
| OrderDiscountAmount | Total amount of discounts associated with the order (in cents) | Long | Yes |
| OrderShippingCost | Total amount of shipping costs for the order (in cents) | Long | Yes |
Code example
<html>
<body>
<form method="post" id="4x" action="https://eureka.integration-cb4x.fr/AdditionalCustomerInformations/form" name="floaPay" target="_parent">
<input type="hidden" name="MerchantId" value="38">
<input type="hidden" name="MerchantSiteId" value="7017">
<input type="hidden" name="TokenId" value="d73d091972074c65ae5c9a792f08bc3b">
<input type="hidden" name="Currency" value="EUR">
<input type="hidden" name="Language" value="FR">
<input type="hidden" name="PaymentOptionRef" value="63">
<input type="hidden" name="Country" value="FR">
<input type="hidden" name="Version" value="1.0">
<input type="hidden" name="freeText" value="free">
<input type="hidden" name="culture" value="fr-FR">
<input type="hidden" name="Customer[CustomerRef]" value="EV000001">
<input type="hidden" name="Customer[LastName]" value="Prenom">
<input type="hidden" name="Customer[FirstName]" value="Nom">
<input type="hidden" name="Customer[Civility]" value="Mr">
<input type="hidden" name="Customer[MaidenName]" value="Nom">
<input type="hidden" name="Customer[BirthZipCode]" value="75">
<input type="hidden" name="Customer[BirthDate]" value="25/10/1978">
<input type="hidden" name="Customer[PhoneNumber]" value="0501020304">
<input type="hidden" name="Customer[CellPhoneNumber]" value="0601020304">
<input type="hidden" name="Customer[Email]" value="[email protected]">
<input type="hidden" name="Customer[Address1]" value="ROUTE DE LA GARONNE">
<input type="hidden" name="Customer[ZipCode]" value="33000">
<input type="hidden" name="Customer[City]" value="BORDEAUX">
<input type="hidden" name="Customer[Country]" value="FR">
<input type="hidden" name="Customer[Nationality]" value="FR">
<input type="hidden" name="Customer[IpAddress]" value="196.227.133.71">
<input type="hidden" name="Customer[WhiteList]" value="UNKNOWN">
<input type="hidden" name="Order[OrderDate]" value="12/12/2020">
<input type="hidden" name="Order[ShoppingCartRef]"value="TESTWMA" >
<input type="hidden" name="Order[TotalAmount]" value="22971">
<input type="hidden" name="Order[ShoppingCartItemCount]" value="2">
<input type="hidden" name="Order[ShippingMethod]" value="VIR">
<input type="hidden" name="Order[SaleChannel]" value="DESKTOP">
<input type="hidden" name="OptionalProductDetails[Categorie1]" value="Hotel">
<input type="hidden" name="OptionalCustomerHistory[FirstOrderDate]" value="10/08/2021">
<input type="hidden" name="OptionalCustomerHistory[LastOrderDate]" value="08/12/2022">
<!-- Additional field to send for deferred payment
<input type='hidden' name='Order[reportDelayInDays]' value='3' />
-->
<input type="hidden" name="Urls[MerchantHomeUrl]" value="https://site.com/HomePageUrl">
<input type="hidden" name="Urls[MerchantBackUrl]" value="https://site.com/MerchantBackUrl">
<input type="hidden" name="Urls[MerchantReturnUrl]" value="https://site.com/MerchantReturnUrl">
<input type="hidden" name="Urls[MerchantNotifyUrl]" value="https://site.com/MerchantNotifyUrl">
<input type="hidden" name="Urls[MerchantScoringResponseKoUrl]" value="https://site.com/MerchantScoringResponseKoUrl">
<input type="hidden" name="Amounts[OrderFeesAmount]" value="0">
<input type="hidden" name="Amounts[OrderDiscountAmount]" value="0">
<input type="hidden" name="Amounts[OrderShippingCost]" value="0">
<input type="hidden" name="Hash" value="5118e26acb77557b71fd7f614dd69152b11657f3">
</form>
<script>
document.floaPay.submit();
</script>
</body>
</html>
Requierements for specific activity sectors
Travel / Stay
Additionnal datas asked :
| Field | Description | Type |
|---|---|---|
| OptionalProductDetails/Categorie1 | Product's category. Use one of the following items : AIRLINE TICKET TRAIN TICKET BUS TICKET HOTEL CAMPING STAY CRUISE CAR RENTAL * OTHER | String |
| OptionalTravelDetails/Insurance | Insurance's name/code choosen by the customer Or boolean yes/no the customer chooses an insurance. | String |
| OptionalTravelDetails/TravelType | "Unknown", "OneWay", "TwoWay", "Multiple" | String |
| OptionalTravelDetails/DepartureDate | Format JJ/MM/AAAA HH:MM | String |
| OptionalTravelDetails/ReturnDate | Format JJ/MM/AAAA HH:MM | String |
| OptionalTravelDetails/DestinationCountry | Destination country code, format ISO 3166-2 (ex : "FR" for France) | String |
| OptionalTravelDetails/TravellerCount | number of passengers | String |
| OptionalTravelDetails/OwnTicket | boolean : does the payment card holder is part of the trip | String |
| OptionalTravelDetails/MainDepartureCompany | Airline name of the first flight (IATA code) in case of travel with flight, empty otherway | String |
| OptionalTravelDetails/DepartureAirport | IATA code of the airport/train or bus station if travel with transportation. Empty otherway | String |
| OptionalTravelDetails/ArrivalAirport | IATA code of the airport/train or bus station if travel with transportation. Else IATA code of the stay city | String |
| OptionalStayDetails/RoomRange | Accommodation range if travel with stay empty otherway | String |
Example :
<html>
<body>
<form method="post" id="4x" action="https://eureka.integration-cb4x.fr/AdditionalCustomerInformations/form" name="FloaForm" target="_parent">
<input type="hidden" name="MerchantId" value="38">
<input type="hidden" name="MerchantSiteId" value="7017">
<input type="hidden" name="AgencyCode" value="12345678910112">
<input type="hidden" name="TokenId" value="d73d091972074c65ae5c9a792f08bc3b">
<input type="hidden" name="Currency" value="EUR">
<input type="hidden" name="Language" value="FR">
<input type="hidden" name="PaymentOptionRef" value="63">
<input type="hidden" name="Country" value="FR">
<input type="hidden" name="Version" value="1.0">
<input type="hidden" name="Culture" value="fr-FR">
<input type="hidden" name="Hash" value="5118e26acb77557b71fd7f614dd69152b11657f3">
<input type="hidden" name="Customer[CustomerRef]" value="1">
<input type="hidden" name="Customer[LastName]" value="Nom">
<input type="hidden" name="Customer[FirstName]" value="Prenom">
<input type="hidden" name="Customer[Civility]" value="Mr">
<input type="hidden" name="Customer[Email]" value="[email protected]">
<input type="hidden" name="Customer[Country]" value="FR">
<input type="hidden" name="Order[OrderDate]" value="16/03/2023">
<input type="hidden" name="Order[SaleChannel]" value="DESKTOP">
<input type="hidden" name="Order[ShippingMethod]" value="VIR">
<input type="hidden" name="Order[ShoppingCartItemCount]" value="2">
<input type="hidden" name="Order[ShoppingCartRef]" value="TESTWMA" >
<input type="hidden" name="Order[TotalAmount]" value="22971">
<input type="hidden" name="OptionalCustomerHistory[FirstOrderDate]" value="10/08/2021">
<input type="hidden" name="OptionalCustomerHistory[LastOrderDate]" value="08/12/2022">
<input type="hidden" name="OptionalTravelDetails[Insurance]" value="WWInsurance">
<input type="hidden" name="OptionalTravelDetails[TravelType]" value="TwoWay">
<input type="hidden" name="OptionalTravelDetails[DepartureDate]" value="20/07/2023 08:59">
<input type="hidden" name="OptionalTravelDetails[ReturnDate]" value="28/07/2023 23:02">
<input type="hidden" name="OptionalTravelDetails[DestinationCountry]" value="BE">
<input type="hidden" name="OptionalTravelDetails[TravellerCount]" value="2">
<input type="hidden" name="OptionalTravelDetails[OwnTicket]" value="true">
<input type="hidden" name="OptionalTravelDetails[MainDepartureCompany]" value="AirFrance">
<input type="hidden" name="OptionalTravelDetails[DepartureAirport]" value="CDG">
<input type="hidden" name="OptionalTravelDetails[ArrivalAirport]" value="BRU">
<input type="hidden" name="OptionalStayDetails[RoomRange]" value="First class">
<input type="hidden" name="OptionalProductDetails[Categorie1]" value="AIRLINE TICKET">
<input type="hidden" name="Urls[MerchantHomeUrl]" value="https://HomeUrl.fr">
<input type="hidden" name="Urls[MerchantBackUrl]" value="https://BackUrl.fr">
<input type="hidden" name="Urls[MerchantReturnUrl]" value="https://ReturnUrl.fr">
<input type="hidden" name="Urls[MerchantNotifyUrl]" value="https://NotifyUrl.fr">
<input type="hidden" name="Urls[MerchantScoringResponseKoUrl]" value="https://ScoringResponseKoUrl.fr">
<input type="hidden" name="Amounts[OrderFeesAmount]" value="0">
<input type="hidden" name="Amounts[OrderDiscountAmount]" value="0">
<input type="hidden" name="Amounts[OrderShippingCost]" value="0">
</form>
<script>
document.FloaForm.submit();
</script>
</body>
</html>
Vehicle / Garage
Additionnal datas asked :
| Field | Description | Type |
|---|---|---|
| OptionalProductDetails/Categorie1 | Product's categories. Depending on the available granularity, but at least the main category. If possible, add a sub-category | String |
| AdditionalTextFieldList | Index : 1 Value : Date of first registration of the vehicle Index : 2 Value : Vehicle type (private vehicle, 2 wheels, caravan...) Index : 3 Value : Vehicle's brand | Set of Index-Value pair. Value : String |
| AdditionalNumericFieldList | Index : 1 Value : Fiscal power of the vehicle (if available) Index : 2 Value : Flag customer type. 0 : New customer. 1 : Known customer Index : 3 Value : Postal code of the vehicle | Set of Index-Value pair. Value : Integer |
Example :
<html>
<body>
<form method="post" id="4x" action="https://eureka.integration-cb4x.fr/AdditionalCustomerInformations/form" name="FloaForm" target="_parent">
<input type="hidden" name="MerchantId" value="38">
<input type="hidden" name="MerchantSiteId" value="7017">
<input type="hidden" name="AgencyCode" value="12345678910112">
<input type="hidden" name="TokenId" value="d73d091972074c65ae5c9a792f08bc3b">
<input type="hidden" name="Currency" value="EUR">
<input type="hidden" name="Language" value="FR">
<input type="hidden" name="PaymentOptionRef" value="63">
<input type="hidden" name="Country" value="FR">
<input type="hidden" name="Version" value="1.0">
<input type="hidden" name="Culture" value="fr-FR">
<input type="hidden" name="Hash" value="5118e26acb77557b71fd7f614dd69152b11657f3">
<input type="hidden" name="Customer[CustomerRef]" value="1">
<input type="hidden" name="Customer[LastName]" value="Nom">
<input type="hidden" name="Customer[FirstName]" value="Prenom">
<input type="hidden" name="Customer[Civility]" value="Mr">
<input type="hidden" name="Customer[Email]" value="[email protected]">
<input type="hidden" name="Customer[Country]" value="FR">
<input type="hidden" name="Order[OrderDate]" value="16/03/2023">
<input type="hidden" name="Order[SaleChannel]" value="DESKTOP">
<input type="hidden" name="Order[ShippingMethod]" value="VIR">
<input type="hidden" name="Order[ShoppingCartItemCount]" value="2">
<input type="hidden" name="Order[ShoppingCartRef]" value="TESTWMA" >
<input type="hidden" name="Order[TotalAmount]" value="22971">
<input type="hidden" name="OptionalCustomerHistory[FirstOrderDate]" value="10/08/2021">
<input type="hidden" name="OptionalCustomerHistory[LastOrderDate]" value="08/12/2022">
<input type="hidden" name="OptionalProductDetails[Categorie1]" value="CAR">
<input type="hidden" name="AdditionalTextFieldList[0][Index]" value="1">
<input type="hidden" name="AdditionalTextFieldList[0][Value]" value="2022-08-11">
<input type="hidden" name="AdditionalTextFieldList[1][Index]" value="2">
<input type="hidden" name="AdditionalTextFieldList[1][Value]" value="private vehicle">
<input type="hidden" name="AdditionalTextFieldList[2][Index]" value="3">
<input type="hidden" name="AdditionalTextFieldList[2][Value]" value="Mercedes">
<input type="hidden" name="AdditionalNumericFieldList[0][Index]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[0][Value]" value="8">
<input type="hidden" name="AdditionalNumericFieldList[1][Index]" value="2">
<input type="hidden" name="AdditionalNumericFieldList[1][Value]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[2][Index]" value="3">
<input type="hidden" name="AdditionalNumericFieldList[2][Value]" value="33000">
<input type="hidden" name="Urls[MerchantHomeUrl]" value="https://HomeUrl.fr">
<input type="hidden" name="Urls[MerchantBackUrl]" value="https://BackUrl.fr">
<input type="hidden" name="Urls[MerchantReturnUrl]" value="https://ReturnUrl.fr">
<input type="hidden" name="Urls[MerchantNotifyUrl]" value="https://NotifyUrl.fr">
<input type="hidden" name="Urls[MerchantScoringResponseKoUrl]" value="https://ScoringResponseKoUrl.fr">
<input type="hidden" name="Amounts[OrderFeesAmount]" value="0">
<input type="hidden" name="Amounts[OrderDiscountAmount]" value="0">
<input type="hidden" name="Amounts[OrderShippingCost]" value="0">
</form>
<script>
document.FloaForm.submit();
</script>
</body>
</html>
Training courses
Additionnal datas asked :
| Field | Description | Type |
|---|---|---|
| OptionalProductDetails/Categorie1 | course details: sector/subject (Art, Math, Computer science, marketing…) | String |
| OptionalProductDetails/Categorie2 | level/degree | String |
| OptionalProductDetails/Categorie3 | wording/name | String |
| AdditionalTextFieldList | Index : 2 Value : start date of the course (YYYY-MM-DD) Index : 3 Value : end date of the course (YYYY-MM-DD) | Set of Index-Value pair. Value : String |
| AdditionalNumericFieldList | Index : 1 Value : Flag if course is partially/totally funded by a third party organization (ex : CPF in France) : 0 : no 1 : yes Index : 2 Value : Flag if course leads to a diploma : 0 : no 1 : yes Index : 3 Value : Flag if course is a post-high school degree (post-bac in France) 0 : no 1 : yes | Set of Index-Value pair. Value : Integer |
Example :
<html>
<body>
<form method="post" id="4x" action="https://eureka.integration-cb4x.fr/AdditionalCustomerInformations/form" name="FloaForm" target="_parent">
<input type="hidden" name="MerchantId" value="38">
<input type="hidden" name="MerchantSiteId" value="7017">
<input type="hidden" name="AgencyCode" value="12345678910112">
<input type="hidden" name="TokenId" value="d73d091972074c65ae5c9a792f08bc3b">
<input type="hidden" name="Currency" value="EUR">
<input type="hidden" name="Language" value="FR">
<input type="hidden" name="PaymentOptionRef" value="63">
<input type="hidden" name="Country" value="FR">
<input type="hidden" name="Version" value="1.0">
<input type="hidden" name="Culture" value="fr-FR">
<input type="hidden" name="Hash" value="5118e26acb77557b71fd7f614dd69152b11657f3">
<input type="hidden" name="Customer[CustomerRef]" value="1">
<input type="hidden" name="Customer[LastName]" value="Nom">
<input type="hidden" name="Customer[FirstName]" value="Prenom">
<input type="hidden" name="Customer[Civility]" value="Mr">
<input type="hidden" name="Customer[Email]" value="[email protected]">
<input type="hidden" name="Customer[Country]" value="FR">
<input type="hidden" name="Order[OrderDate]" value="16/03/2023">
<input type="hidden" name="Order[SaleChannel]" value="DESKTOP">
<input type="hidden" name="Order[ShippingMethod]" value="VIR">
<input type="hidden" name="Order[ShoppingCartItemCount]" value="2">
<input type="hidden" name="Order[ShoppingCartRef]" value="TESTWMA" >
<input type="hidden" name="Order[TotalAmount]" value="22971">
<input type="hidden" name="OptionalCustomerHistory[FirstOrderDate]" value="10/08/2021">
<input type="hidden" name="OptionalCustomerHistory[LastOrderDate]" value="08/12/2022">
<input type="hidden" name="OptionalProductDetails[Categorie1]" value="Computer science">
<input type="hidden" name="OptionalProductDetails[Categorie2]" value="Bachelor">
<input type="hidden" name="OptionalProductDetails[Categorie3]" value="Bachelor in Comp. Science & AI">
<input type="hidden" name="AdditionalTextFieldList[0][Index]" value="2">
<input type="hidden" name="AdditionalTextFieldList[0][Value]" value="2023-06-01">
<input type="hidden" name="AdditionalTextFieldList[1][Index]" value="3">
<input type="hidden" name="AdditionalTextFieldList[1][Value]" value="2023-06-05">
<input type="hidden" name="AdditionalNumericFieldList[0][Index]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[0][Value]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[1][Index]" value="2">
<input type="hidden" name="AdditionalNumericFieldList[1][Value]" value="0">
<input type="hidden" name="AdditionalNumericFieldList[2][Index]" value="3">
<input type="hidden" name="AdditionalNumericFieldList[2][Value]" value="0">
<input type="hidden" name="Urls[MerchantHomeUrl]" value="https://HomeUrl.fr">
<input type="hidden" name="Urls[MerchantBackUrl]" value="https://BackUrl.fr">
<input type="hidden" name="Urls[MerchantReturnUrl]" value="https://ReturnUrl.fr">
<input type="hidden" name="Urls[MerchantNotifyUrl]" value="https://NotifyUrl.fr">
<input type="hidden" name="Urls[MerchantScoringResponseKoUrl]" value="https://ScoringResponseKoUrl.fr">
<input type="hidden" name="Amounts[OrderFeesAmount]" value="0">
<input type="hidden" name="Amounts[OrderDiscountAmount]" value="0">
<input type="hidden" name="Amounts[OrderShippingCost]" value="0">
</form>
<script>
document.FloaForm.submit();
</script>
</body>
</html>
Second Hand
Additionnal datas asked :
| Field | Description | Type |
|---|---|---|
| OptionalProductDetails/Categorie1 | product's categories. Depending on the available granularity, but at least the main category. | String |
| OptionalProductDetails/Categorie2 | If possible, add a sub-category | String |
| AdditionalTextFieldList | Index : 1 Value : Brand of the most expensive product Index : 2 Value : Most expensive product model Index : 3 Value : Version/year of the most expensive product Index : 4 Value : Reconditioning status | Set of Index-Value pair. Value : String |
| AdditionalNumericFieldList | Index : 1 Value : Flag customer type 0 : New customer 1 : Known customer Index : 2 Value : Number of smartphones in the basket Index : 3 Value : Guarantee Indicator/Additional Insurance | Set of Index-Value pair. Value : Integer |
Example :
<html>
<body>
<form method="post" id="4x" action="https://eureka.integration-cb4x.fr/AdditionalCustomerInformations/form" name="FloaForm" target="_parent">
<input type="hidden" name="MerchantId" value="38">
<input type="hidden" name="MerchantSiteId" value="7017">
<input type="hidden" name="AgencyCode" value="12345678910112">
<input type="hidden" name="TokenId" value="d73d091972074c65ae5c9a792f08bc3b">
<input type="hidden" name="Currency" value="EUR">
<input type="hidden" name="Language" value="FR">
<input type="hidden" name="PaymentOptionRef" value="63">
<input type="hidden" name="Country" value="FR">
<input type="hidden" name="Version" value="1.0">
<input type="hidden" name="Culture" value="fr-FR">
<input type="hidden" name="Hash" value="5118e26acb77557b71fd7f614dd69152b11657f3">
<input type="hidden" name="Customer[CustomerRef]" value="1">
<input type="hidden" name="Customer[LastName]" value="Nom">
<input type="hidden" name="Customer[FirstName]" value="Prenom">
<input type="hidden" name="Customer[Civility]" value="Mr">
<input type="hidden" name="Customer[Email]" value="[email protected]">
<input type="hidden" name="Customer[Country]" value="FR">
<input type="hidden" name="Order[OrderDate]" value="16/03/2023">
<input type="hidden" name="Order[SaleChannel]" value="DESKTOP">
<input type="hidden" name="Order[ShippingMethod]" value="VIR">
<input type="hidden" name="Order[ShoppingCartItemCount]" value="2">
<input type="hidden" name="Order[ShoppingCartRef]" value="TESTWMA" >
<input type="hidden" name="Order[TotalAmount]" value="22971">
<input type="hidden" name="OptionalCustomerHistory[FirstOrderDate]" value="10/08/2021">
<input type="hidden" name="OptionalCustomerHistory[LastOrderDate]" value="08/12/2022">
<input type="hidden" name="OptionalProductDetails[Categorie1]" value="WOMAN">
<input type="hidden" name="OptionalProductDetails[Categorie2]" value="DRESS">
<input type="hidden" name="AdditionalTextFieldList[0][Index]" value="1">
<input type="hidden" name="AdditionalTextFieldList[0][Value]" value="Dior">
<input type="hidden" name="AdditionalTextFieldList[1][Index]" value="2">
<input type="hidden" name="AdditionalTextFieldList[1][Value]" value="Dress of the year">
<input type="hidden" name="AdditionalTextFieldList[2][Index]" value="3">
<input type="hidden" name="AdditionalTextFieldList[2][Value]" value="2023-01-01">
<input type="hidden" name="AdditionalTextFieldList[3][Index]" value="4">
<input type="hidden" name="AdditionalTextFieldList[3][Value]" value="SILVER">
<input type="hidden" name="AdditionalNumericFieldList[0][Index]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[0][Value]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[1][Index]" value="2">
<input type="hidden" name="AdditionalNumericFieldList[1][Value]" value="0">
<input type="hidden" name="AdditionalNumericFieldList[2][Index]" value="3">
<input type="hidden" name="AdditionalNumericFieldList[2][Value]" value="1">
<input type="hidden" name="Urls[MerchantHomeUrl]" value="https://HomeUrl.fr">
<input type="hidden" name="Urls[MerchantBackUrl]" value="https://BackUrl.fr">
<input type="hidden" name="Urls[MerchantReturnUrl]" value="https://ReturnUrl.fr">
<input type="hidden" name="Urls[MerchantNotifyUrl]" value="https://NotifyUrl.fr">
<input type="hidden" name="Urls[MerchantScoringResponseKoUrl]" value="https://ScoringResponseKoUrl.fr">
<input type="hidden" name="Amounts[OrderFeesAmount]" value="0">
<input type="hidden" name="Amounts[OrderDiscountAmount]" value="0">
<input type="hidden" name="Amounts[OrderShippingCost]" value="0">
</form>
<script>
document.FloaForm.submit();
</script>
</body>
</html>
Telephony
Additionnal datas asked :
| Field | Description | Type |
|---|---|---|
| OptionalProductDetails/Categorie1 | product's categories. Depending on the available granularity, but at least the main category. If possible, add a sub-category and the brand name. | String |
| AdditionalTextFieldList | Index : 2 Value : Purchase Type. Default to "BARE_PHONE" for purchase of a cell phone. Default to "PACKAGE_PHONE" for purchase of a cell phone with phone plan. Index : 3 Value : Type of phone package. Only for purchase of a cell phone with phone plan. Index : 4 Value : Phone brand Index : 5 Value : Phone number of the subscrided line. Only if purchase without portability, empty otherway. Index : 6 Value : Current phone provider. Only if purchase with portability, empty otherway. Index : 7 Value : Phone condition. | Set of Index-Value pair. Value : String |
| AdditionalNumericFieldList | Index : 1 Value : Phone number portability flag 0 : without portability 1 : with portability Index : 2 Value : Flag if insurance have been subscrided 0 : without insurance 1 : with insurance Index : 3 Value : Flag if aditionals options have been subscribed 0 : without options 1 : with options Index : 4 Value : Advance on telephony consumption (in euros). Only for purchase of a cell phone with phone plan. | Set of Index-Value pair. Value : Integer |
Example :
<html>
<body>
<form method="post" id="4x" action="https://eureka.integration-cb4x.fr/AdditionalCustomerInformations/form" name="FloaForm" target="_parent">
<input type="hidden" name="MerchantId" value="38">
<input type="hidden" name="MerchantSiteId" value="7017">
<input type="hidden" name="AgencyCode" value="12345678910112">
<input type="hidden" name="TokenId" value="d73d091972074c65ae5c9a792f08bc3b">
<input type="hidden" name="Currency" value="EUR">
<input type="hidden" name="Language" value="FR">
<input type="hidden" name="PaymentOptionRef" value="63">
<input type="hidden" name="Country" value="FR">
<input type="hidden" name="Version" value="1.0">
<input type="hidden" name="Culture" value="fr-FR">
<input type="hidden" name="Hash" value="5118e26acb77557b71fd7f614dd69152b11657f3">
<input type="hidden" name="Customer[CustomerRef]" value="1">
<input type="hidden" name="Customer[LastName]" value="Nom">
<input type="hidden" name="Customer[FirstName]" value="Prenom">
<input type="hidden" name="Customer[Civility]" value="Mr">
<input type="hidden" name="Customer[Email]" value="[email protected]">
<input type="hidden" name="Customer[Country]" value="FR">
<input type="hidden" name="Order[OrderDate]" value="16/03/2023">
<input type="hidden" name="Order[SaleChannel]" value="DESKTOP">
<input type="hidden" name="Order[ShippingMethod]" value="VIR">
<input type="hidden" name="Order[ShoppingCartItemCount]" value="2">
<input type="hidden" name="Order[ShoppingCartRef]" value="TESTWMA" >
<input type="hidden" name="Order[TotalAmount]" value="22971">
<input type="hidden" name="OptionalCustomerHistory[FirstOrderDate]" value="10/08/2021">
<input type="hidden" name="OptionalCustomerHistory[LastOrderDate]" value="08/12/2022">
<input type="hidden" name="OptionalProductDetails[Categorie1]" value="SMARTPHONE">
<input type="hidden" name="OptionalProductDetails[Categorie1]" value="SAMSUNG">
<input type="hidden" name="AdditionalTextFieldList[0][Index]" value="2">
<input type="hidden" name="AdditionalTextFieldList[0][Value]" value="BARE_PHONE">
<input type="hidden" name="AdditionalTextFieldList[1][Index]" value="4">
<input type="hidden" name="AdditionalTextFieldList[1][Value]" value="SAMSUNG">
<input type="hidden" name="AdditionalTextFieldList[2][Index]" value="5">
<input type="hidden" name="AdditionalTextFieldList[2][Value]" value="">
<input type="hidden" name="AdditionalTextFieldList[3][Index]" value="6">
<input type="hidden" name="AdditionalTextFieldList[3][Value]" value="">
<input type="hidden" name="AdditionalTextFieldList[3][Index]" value="7">
<input type="hidden" name="AdditionalTextFieldList[3][Value]" value="NEW">
<input type="hidden" name="AdditionalNumericFieldList[0][Index]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[0][Value]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[1][Index]" value="2">
<input type="hidden" name="AdditionalNumericFieldList[1][Value]" value="1">
<input type="hidden" name="AdditionalNumericFieldList[2][Index]" value="3">
<input type="hidden" name="AdditionalNumericFieldList[2][Value]" value="0">
<input type="hidden" name="Urls[MerchantHomeUrl]" value="https://HomeUrl.fr">
<input type="hidden" name="Urls[MerchantBackUrl]" value="https://BackUrl.fr">
<input type="hidden" name="Urls[MerchantReturnUrl]" value="https://ReturnUrl.fr">
<input type="hidden" name="Urls[MerchantNotifyUrl]" value="https://NotifyUrl.fr">
<input type="hidden" name="Urls[MerchantScoringResponseKoUrl]" value="https://ScoringResponseKoUrl.fr">
<input type="hidden" name="Amounts[OrderFeesAmount]" value="0">
<input type="hidden" name="Amounts[OrderDiscountAmount]" value="0">
<input type="hidden" name="Amounts[OrderShippingCost]" value="0">
</form>
<script>
document.FloaForm.submit();
</script>
</body>
</html>