Floa

Introducción

Floa es una solución de pago francesa que permite financiar compras con opciones de crédito al consumo, incluyendo pagos a plazos. Entre las opciones de pago a plazos se ofrece:

3X: Pagos en 3 cuotas, con 30 días de diferencia entre cada una.
4X: Pagos en 4 cuotas, con 30 días de diferencia entre cada una.

Datos extra requeridos

Dependiendo del tipo de producto o servicio ofrecido será necesario indicar información adicional dentro del extra_data durante la creación de la orden, aunque el país siempre sera obligatorio (extra_data.billing_address.country), junto con el nombre y primer apellido (extra_data.profile.first_name y extra_data.profile.last_name, respectivamente).

En la siguiente tabla se muestran los campos adicionales que deberán ser enviados dentro de extra_data.payment en función del tipo de producto ofrecido:

Campo	Descripción	Tipo	Requerido
categorie_1	Categoría del producto más caro. Para Travel/Stay usar uno de los siguientes valores: AIRLINE TICKET, TRAIN TICKET, BUS TICKET, HOTEL, CAMPING, STAY, CRUISE, CAR RENTAL	string(30)	Sí
categorie_2	Subcategoría del producto más caro. Opcional para Travel.	string(30)	Sí
cart_item_count	Número de items	int	Sí
sale_channel	Canal de venta. Uno de los siguientes valores: DESKTOP, TABLET, TABLET_IPAD, SMARTPHONE, SMARTPHONE_ANDROID, SMARTPHONE_IPHONE	string(18)	Sí
merchant_home_url	URL de la página de inicio del comerciante	string	Sí
merchant_back_url	URL para regresar a la página anterior del sitio del comerciante	string	Sí
departure_date	Formato de fecha de inicio: DD/MM/AAAA HH:MM	date	Travel/Stay
return_date	Formato de fecha de vuelta: DD/MM/AAAA HH:MM	date	Travel/Stay
traveller_count	Número de viajeros	int	Travel/Stay
own_ticket	Campo para identificar si el titular de la tarjeta de crédito utilizada para financiar el viaje participa.	bool	Travel/Stay
room_range	Para pagos Stay, el rango del hotel (estrellas)	string	Stay
insurance	Si el cliente escoge un seguro. Values: "yes", "no"	string	Travel/Stay
destination_country	Código del país de destino, en formato ISO 3166-2 (p. ej.: "ES" para España)	string	Travel/Stay
travel_type	Un Valor entre: Unknown, OneWay (ida), TwoWay (ida y vuelta), Multiple (Multiples destinos)	string(2)	Travel/Stay
departure_airport	Código IATA del aeropuerto de salida	string(3)	Travel
arrival_airport	Código IATA del aeropuerto de destino	string(3)	Travel
main_departure_company	En caso de viajes con avión, nombre de la aerolínea del primer vuelo (código IATA)	string(3)	Travel
shipping_method	Método de entrega del comercio. Si no se envía, "VIR" por defecto. Valores: 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), RIM (Immediate withdrawal in store)	string(3)	No
fees_amount	Importe total de las tarifas asociadas al pedido (en céntimos)	string	No
shipping_cost	Importe total de los gastos de envío del pedido (en céntimos)	string	No
discount_amount	Importe total de los descuentos asociados al pedido (en céntimos)	string	No

Dependiendo del producto existen los siguientes sectores de actividad: General, Stay (hoteles) y Travel.

A continuación, se muestra un ejemplo de extra_data enviado para realizar un pago con cada sector de actividad:

General

"extra_data": {
    "profile": {
        "first_name": "John",
        "last_name": "Doe"
    },
    "billing_address": {
        "city": "",
        "country": "ESP",
        "address1": "Avenida del Mar",
        "zip_code": "",
        "state_code": ""
    },
    "payment": {
        "categorie_1": "Juego de mesa",
        "categorie_2": "Virus 2",
        "cart_item_count": 1,
        "sale_channel": "DESKTOP",
        "merchant_home_url": "https://www.google.com/",
        "merchant_back_url": "https://www.google.com/",
        "shipping_method": "STD",
        "shipping_cost": "500",
        "discount_amount": "1000"
    }
}

Stay (Hotel)

"extra_data":{
    "profile": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "test@gmail.com"
        },
    "billing_address": {
        "city": "",
        "country": "ESP",
        "address1": "Avenida del Mar",
        "zip_code": "",
        "state_code": ""
    },
    "payment": {
        "categorie_1": "HOTEL",
        "categorie_2": "Room",
        "departure_date": "05/05/2024 12:00",
        "return_date": "12/05/2024 12:00",
        "traveller_count": 2,
        "own_ticket": true,
        "room_range": 3,
        "insurance": "no",
        "destination_country": "ES",
        "travel_type": "OneWay",
        "cart_item_count": 2,
        "sale_channel": "DESKTOP",
        "merchant_home_url": "https://www.google.com/",
        "merchant_back_url": "https://www.google.com/"
    }
}

Travel

"extra_data":{
    "profile": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "test@gmail.com"
        },
    "billing_address": {
        "city": "",
        "country": "ESP",
        "address1": "Avinguda del Mar",
        "zip_code": "",
        "state_code": ""
    },
    "payment": {
        "categorie_1": "AIRLINE TICKET",
        "departure_date": "30/04/2024 12:00",
        "return_date": "05/05/2024 12:00",
        "traveller_count": 2,
        "own_ticket": true,
        "insurance": "no",
        "destination_country": "ES",
        "travel_type": "TwoWay",
        "cart_item_count": 2,
        "sale_channel": "DESKTOP",
        "merchant_home_url": "https://www.google.com/",
        "merchant_back_url": "https://www.google.com/",
        "departure_airport": "VLC",
        "arrival_airport": "LEN",
        "main_departure_company": "Iberia"
    }
}

Métodos de pago en Sandbox

Es recomendable usar un amount de entre 100€ y 250€ para aumentar las probabilidades de elegibilidad exitosa.

Los datos de tarjeta de prueba son los siguientes:

- número de tarjeta OK: 5017 6791 1038 0400
- número de tarjeta KO: 5017 6791 0090 0712
- CVV: 000
- fecha de expiración: mayor a la fecha de la última cuota

Moneda

La moneda soportada para este servicio es el euro (EUR).

Códigos de error

La estructura del error tiene la siguiente forma:

Código - Mensaje

Por ejemplo:

3 - Failed (Technical failure)

Introducción​

Datos extra requeridos​

General​

Stay (Hotel)​

Travel​

Métodos de pago en Sandbox​

Moneda​

Códigos de error​