Générer un formulaire de paiement

1. Champs obligatoires :

   Des champs obligatoires supplémentaires sont nécessaires par rapport à votre intégration actuelle.

   Si vous intégrez pour la première fois, voir le chapitre "Créer un paiement comptant immédiat" du guide API Formulaire.

   Des champs supplémentaires sont obligatoires :

   • vads_cust_email (Adresse e-mail de l’acheteur).
   • vads_order_id (numéro de commande).
     • Ce champ doit être unique. Il est à la charge du site marchand de garantir l'unicité du numéro de commande.
2. Champs ignorés :
   Pour un paiement FLOA, les valeurs transmises dans les champs suivants sont ignorées :
   • vads_validation_mode (pour le mode de validation)
   • vads_capture_delay (pour le délai de remise en banque)
   Résultat :

   • Pour le paiement immédiat, la transaction part automatiquement en remise.
   • Pour le paiement différé, la transaction nécessite une validation manuelle et le délai de remise dépend du nombre de jours déterminé dans le contrat.

     Vous pouvez modifier le délai de remise à la baisse depuis le Back Office Expert (ou automatiquement via l'utilisation de la fonction Web Service Transaction/Update).

3. Champs spécifiques :

   • vads_cust_title (Civilité de l’acheteur.)
     • FLOA accepte uniquement ces valeurs :
       • Mr (Monsieur)
       • Mrs (Madame)
       • Ms (Mademoiselle)

   • vads_ext_info_floa (Pour une réservation de voyage.)

     Ce champ est uniquement en mode redirection et obligatoire si vous utilisez la valeur TRAVEL dans le contenu de votre panier (champ vads_product_typeN).

     Ce champ doit respecter le format JSON et se compose de deux objets.

     Intégrez les données suivantes :

     1. History

        Cette donnée est obligatoire, sauf pour un nouvel acheteur.

        Nom	Description	Format	Valeur
        firstOrderDate	Première date de la commande	dateTime (ISO 8601)	Ex : 2027-07-16T12:42:16
        lastOrderDate	Date de la dernière commande	dateTime (ISO 8601)	Ex : 2027-07-16T13:42:16

     2. Travel

        * champs obligatoires

        Nom	Description	Format	Valeur
        productCategory	Catégorie du produit	Enum	AIRLINE TICKET (ticket d'avion) TRAIN TICKET (ticket de train) BUS TICKET (ticket de bus) HOTEL (hôtel) CAMPING (camping) STAY (hébergement) CRUISE (croisière) CAR RENTAL (location de voiture) OTHER (autres)
        cartInitialAmount	Montant du produit (avant réduction)	Number	Exemple: 50000 pour 500,00 EUR
        productBrand	Marque du produit	String
        travelInsurance*	Assurance de voyage	Booléan	1 (Oui) 0 (Non)
        travelType*	Type de voyage	Enum	Unknown (inconnu) OneWay (aller) TwoWay (aller -retour) Multiple (plusieurs escales)
        departureDate*	Date de départ	YYYY-MM-DD	Ex : 2025-08-20
        returnDate*	Date de retour	YYYY-MM-DD	Ex : 2025-00-10 Vide si travelType a pour valeur OneWay.
        destinationCountry*	Pays de la destination	norme ISO 3166 alpha-2	Ex : FR pour France.
        travelerCount*	Nombre de voyageurs	Number	Ex : 4
        travelClass	Classe du voyage	String	Ex : 4
        buyerAmongTravelers*	Si l'acheteur voyage aussi	Booléan	1 (Oui) 0 (Non)
        travelCompany*	Nom de la compagnie aérienne	Enum (code IATA)	Uniquement le code IATA. Ex : AF pour Air France Sinon, laissez vide
        departureLocation*	Lieu de départ (aéroport)	Enum (code IATA)	Uniquement le code IATA. Ex : CDG pour Charles de Gaulle (Paris) Sinon, laissez vide
        arrivalLocation*	Lieu d'arrivée (aéroport)	Enum (code IATA)	Uniquement le code IATA. Ex : TLS pour Blagnac (Toulouse). Sinon, laissez vide
        luggageSupplement	Vol avec des bagages supplémentaires	Booléan	1 (Oui) 0 (Non)
        travelCanBeModified OrCanceled	Vol avec annulation ou modification	Booléan	1 (Oui) 0 (Non)
        stayCompany	Nom de l'hébergement	String	Ex : Stay Hotels
        stayDestination	Destination de l'hébergement	String	Ex :Blagnac (Toulouse)
        stayNightsCount	Nombre de nuits	Number	Ex : 4
        stayRoomRange	Gamme de l'hébergement	String	Ex : 2 étoiles

     Exemple de JSON

     vads_ext_info_floa={
         "history": {
             "firstOrderDate": "2027-07-16T12:42:16",
             "lastOrderDate": "2027-07-16T13:42:16"
         },
         "travel": [
             {
                 "key": "cartInitialAmount",
                 "value": "50000"
             },
             {
                 "key": "productCategory",
                 "value": "AIRLINE TICKET"
             },
             {
                 "key": "travelInsurance",
                 "value": "yes"
             },
             {
                 "key": "travelType",
                 "value": "TwoWay"
             },
             {
                 "key": "departureDate",
                 "value": "2025-08-20"
             },
             {
                 "key": "returnDate",
                 "value": "2025-09-10"
             },
             {
                 "key": "destinationCountry",
                 "value": "FR"
             },
             {
                 "key": "ticketsCount",
                 "value": "2"
             },
             {
                 "key": "travelerCount",
                 "value": "4"
             },
             {
                 "key": "travelClass",
                 "value": "Economy"
             },
             {
                 "key": "buyerAmongTravelers",
                 "value": true
             },
             {
                 "key": "travelCompany",
                 "value": "AF"
             },
             {
                 "key": "departureLocation",
                 "value": "CDG"
             },
             {
                 "key": "arrivalLocation",
                 "value": "TLS"
             },
             {
                 "key": "luggageSupplement",
                 "value": "1"
             },
             {
                 "key": "travelCanBeModifiedOrCanceled",
                 "value": "0"
             },
             {
                 "key": "stayCompany",
                 "value": "Stay Hotels"
             },
             {
                 "key": "stayDestination",
                 "value": "Blagnac"
             },
             {
                 "key": "stayNightsCount",
                 "value": "4"
             },
             {
                 "key": "stayRoomRange",
                 "value": "2 stars"
             }
         ]
     }

4. Champs recommandés :
   1. Simplification du parcours d'achat

      Transmettez les données de l'acheteur (nom, prénom, e-mail, adresse postale, ...). Ainsi, l'acheteur n'a plus à ressaisir ces informations lors de la souscription.

      Voir Transmettre les données de l'acheteur dans le chapitre Utiliser des fonctions complémentaires du guide API Formulaire.

   2. Surcharge des options de paiement (avec ou sans frais)

      Par défaut, les options de paiement sont configurés sur le contrat.

      Pour surcharger la configuration du contrat, utilisez le champ vads_acquirer_transient_data avec les valeurs suivantes :

      Moyen de paiement	Sans frais	Avec frais
      FLOA en 3 fois	BC3XF	BC3XC
      FLOA en 4 fois	BC4XF	BC4XC
      FLOA en 10 fois	BC10XF	BC10XC
      FLOA Pay Later	BC1XFD	BC1XPD

      Par exemple, envoyez les données suivantes :

      • Pour surcharger FLOA en 3 fois sans frais :

        vads_acquirer_transient_data={"FLOA": {"optionCode":"BC3XF"}}

      • Pour surcharger FLOA en 3 fois avec frais :

        vads_acquirer_transient_data={"FLOA": {"optionCode":"BC3XC"}}

   3. Surcharge du mode de livraison :

      Par défaut, le mode de livraison est configuré sur le contrat.

      Pour surcharger la configuration du contrat, utilisez les champs vads_ship_to_type et vads_ship_to_speed avec la combinaison suivante des valeurs :

      Mode de livraison	Type de livraison	Délai de livraison
      Livraison standard	PACKAGE_DELIVERY_COMPANY	STANDARD
      Livraison express	PACKAGE_DELIVERY_COMPANY	EXPRESS
      Livraison en magasin	RECLAIM_IN_SHOP	STANDARD
      Livraison en consigne	AUTOMATED_PICKUP_POINT	STANDARD
      Livraison digitale	DIGITAL_GOOD	STANDARD

      Par exemple, envoyez les données suivantes :
      • Pour surcharger la livraison standard :

        vads_ship_to_type="PACKAGE_DELIVERY_COMPANY";
        vads_ship_to_speed="STANDARD";

      • Pour surcharger la livraison digitale :

        vads_ship_to_type="DIGITAL_GOOD";
        vads_ship_to_speed="STANDARD";

      Respectez l'association des deux champs, car en cas d'erreur sur la combinaison :

      • Soit le moyen de paiement FLOA ne sera pas proposé.
      • Soit un message d'erreur s'affiche si vous forcez le moyen de paiement FLOA.

5. Champs facultatifs

   Voir chapitre Utiliser des fonctions complémentaires du guide API Formulaire.

Selon le pays du contrat, il est possible de personnaliser les moyens de paiement proposés à l'acheteur en utilisant le champ vads_payment_cards.

Exemples :

Voir chapitre "Gérer les moyens de paiement proposés à l'acheteur" du guide API Formulaire.