Construire votre formulaire de paiement Choozeo

L’intégration du paiement 3-4 fois par carte bancaire avec Choozeo 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 Choozeo 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

    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. 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).