Construire votre formulaire de paiement FullCB

L’intégration du paiement 3-4 fois par carte bancaire avec FullCB nécessite la transmission d’un certain nombre de paramètres dans le formulaire de paiement, ainsi que certaines restrictions sur les paramètres existants.

Nous indiquons ici les paramètres qui sont pris en compte pour un paiement FullCB avec leurs éventuelles restrictions.

  1. Utilisez les champs présents dans le tableau ci-dessous pour valoriser les informations techniques obligatoires sur le formulaire de paiement.
    Nom du champ Description Format Requis Valeur
    vads_action_mode Mode d’acquisition des données de la carte string (enum) oui INTERACTIVE
    vads_ctx_mode Mode de fonctionnement string (enum) oui Les valeurs possibles sont :

    - TEST pour des transactions de test.

    - PRODUCTION pour des transactions réelles.

    vads_page_action Action à réaliser string (enum) oui PAYMENT
    vads_site_id Identifiant de la boutique n8 oui Ex : 12345678
    vads_version Version du protocole d’échange string (enum) oui V2
    Précisions sur certains champs :
    vads_action_mode
    Seule la valeur INTERACTIVE peut être valorisée. Il s'agit d'un paiement avec redirection. L'acheteur saisit les informations de la carte sur la page de paiement.
    vads_page_action
    Seule la valeur PAYMENT peut être valorisée. Cette valeur permet de réaliser des paiements.
  2. Utilisez les champs présents dans le tableau ci-dessous pour valoriser les informations obligatoires sur la transaction devant figurer dans le formulaire de paiement.
    Nom du champ Description Format Requis Valeur
    vads_amount Montant du paiement (dans sa plus petite unité monétaire) n..12 oui Ex : 3000 pour 30,00 EUR
    vads_capture_delay Délai avant remise en banque n..3 oui 0

    Remarque : tout délai de remise supérieur à 0 jour spécifié dans le requête sera ignoré car il s'agit d'un débit immédiat.

    vads_currency Code de la devise Euro n3 oui 978
    vads_payment_config Type de paiement string (enum) oui SINGLE
    vads_trans_id Numéro de la transaction n6 oui Ex : 123456
    vads_order_id Numéro de la commande an9 oui Ex : 123456789
    vads_validation_mode Mode de validation string (enum) oui 0
    vads_trans_date Date et heure UTC du formulaire de paiement n14 oui Ex : 20150113130025
    Précisions sur certains champs :
    vads_currency
    Seule la devise Euro peut être valorisée. Son code est 978.
    vads_trans_id
    Cet identifiant est composé de 6 caractères numérique et doit être unique pour chaque transaction pour une boutique donnée sur la journée.
    vads_validation_mode
    Seule la validation automatique peut être paramétrée. Le paiement sera remis de manière automatique à la banque.
  3. Utilisez les champs présents dans le tableau ci-dessous pour valoriser les informations obligatoires sur l'acheteur devant figurer dans le formulaire de paiement.
    Afin de faciliter le parcours client, les informations saisies seront récupérées pour pré-renseigner le formulaire de demande de crédit que l'acheteur doit remplir.
    Nom du champ Description Format Requis Valeur
    vads_cust_title Civilité de l'acheteur string   Ex : M, Mme ou Mlle
    vads_cust_last_name Nom de l'acheteur an..63 oui Ex : Dupont
    vads_cust_first_name Prénom de l'acheteur an..63 oui Ex : Jean
    vads_cust_address Rue de l’acheteur.

    Peut contenir espace, virgule, point, apostrophe, tiret et slash (/)

    ans..255 oui Ex : rue du test
    vads_cust_zip Code postal de l’acheteur

    n5

    oui Ex : 31000
    vads_cust_city Ville de l’acheteur

    Peut contenir espace, slash, tiret et apostrophe.

    an..128 oui Ex : Toulouse
    vads_cust_cell_phone Numéro de téléphone portable de l'acheteur

    de 0 à 9 sans espace

    Remarque : au moins un des deux champs vads_cust_cell_phone et vads_cust_phone est obligatoire

    n10   Ex : 0612345678
    vads_cust_phone Numéro de téléphone de l'acheteur sans espace n10   Ex : 0123456789
    vads_cust_country Permet de spécifier le code du pays de l’acheteur à la norme ISO 3166.

    Seul le code pays de la France peut être valorisé.

    a2 oui FR
    vads_cust_email Adresse e-mail de l’acheteur. ans..255 oui Ex: prenom.nom@exemple.fr
    vads_cust_id Référence de l’acheteur sur le site marchand.

    Cette référence ne doit comporter ni espace, ni caractère spécial ou accentué.

    an..8

      Ex : 12345678
    vads_cust_status Type d'acheteur string (enum) oui

    PRIVATE

    Précisions sur certains champs :
    vads_cust_country
    Seule la France peut être valorisée. Son code (norme ISO 3166) est FR.
    vads_cust_status
    Seule la valeur PRIVATE peut être valorisée (particulier). Une société (COMPANY) ne peut bénéficier de ce moyen de paiement.
  4. Utilisez les champs présents dans le tableau ci-dessous pour valoriser les informations sur la livraison devant figurer dans le formulaire de paiement.
    Si les informations de livraison ne sont pas paramétrées alors les champs requis pour l'adresse de facturation seront automatiquement utilisés.
    Nom du champ Description Format Valeur
    vads_ship_to_city Ville an..128 Toulouse
    vads_ship_to_country Code pays suivant la norme ISO 3166 a2 FR
    vads_ship_to_delay Délai de livraison string (enum) Ex : IMMEDIATE

    Donnée obligatoire si le champ vads_ship_to_speed est valorisé à PRIORITY

    vads_ship_to_delivery_

    company_name

    Nom du transporteur ans..127 Ex : mon transporteur
    vads_ship_to_first_name Prénom ans..63 Jean
    vads_ship_to_last_name Nom ans..63 Dupont
    vads_ship_to_phone_num Numéro de téléphone n10 Ex : 0612345678
    vads_ship_to_speed Mode de livraison (rapidité) string (enum) Ex : STANDARD
    vads_ship_to_status Type d'adresse de livraison string (enum) Ex : PRIVATE
    vads_ship_to_street Adresse postale. ans..127 rue de l'innovation
    vads_ship_to_street2 Complément ou suite ou détail de l'adresse ans..127  
    vads_ship_to_zip Code postal an..64 31670
    vads_ship_to_speed
    Les valeurs possibles sont les suivantes :
    • STANDARD pour un délai de livraison normal.
    • EXPRESS pour un délai de livraison rapide.
    • PRIORITY pour un délai de livraison personnalisé rapide (Click & Collect).
      La valeur PRIORITY implique l'utilisation du champ vads_ship_to_delay.
    vads_ship_to_status
    Les valeurs possibles sont :
    • PRIVATE pour une livraison à domicile.
    • COMPANY pour une livraison dans une entreprise.
  5. Calculez la valeur du champ signature en utilisant l’ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature).