• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

Créer une demande de paiement Franfinance

  1. Utilisez les champs obligatoires ci-après pour construire votre formulaire de paiement.
    Nom du champ Description Format Valeur
    vads_payment_cards Permet de forcer le type de carte à utiliser.

    Il est recommandé de proposer sur le site marchand un bouton de paiement différent pour chaque moyen de paiement.

    Il est déconseillé de laisser le champ vide.

    enum
    • FRANFINANCE_3X
      pour appeler directement le bouton de paiement Franfinance 3XWEB.
    • FRANFINANCE_4X
      pour appeler directement le bouton de paiement Franfinance 4XWEB.
    vads_page_action Action à réaliser enum PAYMENT
    vads_amount Montant du paiement dans sa plus petite unité monétaire (le centime pour l'euro). n..12 Ex: 30000 pour 300 EUR.
    vads_ctx_mode Mode de communication avec la plateforme de paiement enum TEST ouPRODUCTION
    vads_currency Code numérique de la monnaie à utiliser pour le paiement, selon la norme ISO 4217 (code numérique) n3 Valeurs possibles:
    • 978 (EUR)
    vads_action_mode Mode d’acquisition des données du moyen de paiement enum INTERACTIVE
    vads_cust_email Adresse e-mail de l'acheteur ans..128 Ex : abc@example.com
    vads_cust_first_name Prénom.
    Les caractères suivants sont acceptés :
    • Alphabétique [aA-zZ]
    • Numérique [0-9]
    • Spécial " ' ` _ + . - @ ,
      • Le caractère apostrophe qui est accepté est le caractère 039 de la table ISO 8859-1
      • Le caractère guillemet qui est accepté est le caractère 034 de la table ISO 8859-1
    • Espace
    • Tous les caractères des alphabets de toutes les langues.
    ans..50 Ex : Laurent
    vads_cust_last_name Nom.
    Les caractères suivants sont acceptés :
    • Alphabétique [aA-zZ]
    • Numérique [0-9]
    • Spécial " ' ` _ + . - @ ,
      • Le caractère apostrophe qui est accepté est le caractère 039 de la table ISO 8859-1
      • Le caractère guillemet qui est accepté est le caractère 034 de la table ISO 8859-1
    • Espace
    • Tous les caractères des alphabets de toutes les langues.
    ans..50 Ex : Durant
    vads_cust_phone Numéro de téléphone.

    Champ obligatoire.

    n10 Ex : +31421234567 ou +31-42-12-34567
    vads_cust_cell_phone Numéro de téléphone mobile.

    Champ obligatoire.

    n10 Ex : +31421234567 ou +31-42-12-34567
    vads_cust_address Adresse postale

    Caractères acceptés :

    • Alphabétique [aA-zZ]
    • Numérique [0-9]
    • Spécial " ' ` _ + . - @ ,
      • Le caractère apostrophe qui est accepté est le caractère 039 de la table iso 8859-1
      • Le caractère guillement qui est accepté est le caractère 034 de la table iso 8859-1
    • Espace
    • Tous les caractères des alphabets de toutes les langues.
    ans..50 Ex : Rue de l'innovation

    vads_cust_zip Code postal.

    Caractères acceptés :

    • Alphabétique [aA-zZ]
    • Numérique [0-9]
    an..10 Ex : 31670
    vads_cust_city Ville.

    Caractères acceptés :

    • Alphabétique [aA-zZ]
    • Numérique [0-9]
    • Spécial " ' ` _ + . - @ ,
      • Le caractère apostrophe qui est accepté est le caractère 039 de la table iso 8859-1
      • Le caractère guillement qui est accepté est le caractère 034 de la table iso 8859-1
    • Espace
    • Tous les caractères des alphabets de toutes les langues.
    ans..50 Ex : Labège
    vads_payment_config Type de paiement enum SINGLE
    vads_site_id Identifiant de la boutique n8 Ex : 12345678
    vads_trans_date Date et heure du formulaire de paiement dans le fuseau horaire UTC. n14

    Respectez le format AAAAMMJJHHMMSS

    Ex : 20200101130025
    vads_trans_id Numéro de la transaction.

    Doit être unique sur une même journée (de 00:00:00 UTC à 23:59:59 UTC).

    Attention : ce champ n'est pas sensible à la casse.

    an6 Ex : xrT15p
    vads_version Version du protocole d’échange avec la plateforme de paiement enum V2
  2. Ajoutez les champs optionnels en fonction de vos besoins (voir chapitre Utiliser des fonctions complémentaires du Guide d'implémentation API Formulaire).
  3. Calculez la valeur du champ signature en utilisant l’ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir : Calculer la signature du Guide d'implémentation API Formulaire disponible sur notre site documentaire).
© 2025 Tous droits réservés à Sogecommerce
25.18-1.11