• 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 prélèvement unique

Dans le cas d'un encaissement par prélèvement unique, l'acheteur autorise le marchand à prélever la totalité de son achat en une seule fois.

  1. Utilisez l'ensemble des champs présents dans le tableau ci-après pour construire votre formulaire de paiement.
    Nom du champ Description Valeur
    vads_action_mode Mode d’acquisition des données bancaires. INTERACTIVE
    vads_amount Montant du paiement dans sa plus petite unité monétaire. Ex : 4525 pour 45,25 EUR
    vads_capture_delay Délai avant remise en banque.

    Valorisez le champ à 0 pour que le transfert de fonds soit effectué au maximum 14 jours calendaires après l’achat.

    0
    vads_ctx_mode Mode de fonctionnement. TEST ou PRODUCTION
    vads_currency Code de la devise suivant la norme ISO 4217. 978
    vads_cust_email Adresse e-mail de l’acheteur.

    Lorsque l'adresse e-mail de l'acheteur est pré-renseignée sur la page de paiement, l'acheteur ne peut la modifier lors de la signature du mandat.

    Si l'adresse e-mail n'est pas connue, l'acheteur sera invité à la renseigner sur la page de paiement.

    Ex : monmail@exemple.com
    vads_page_action Action à réaliser PAYMENT
    vads_payment_cards Moyen de paiement. SDD
    vads_payment_config Type de paiement SINGLE
    vads_site_id Identifiant de la boutique. Ex : 12345678
    vads_trans_date Date et heure UTC du formulaire de paiement. Ex : 20240913131438
    vads_trans_id Numéro de la transaction. Ex : V8y52j
    vads_version Version du protocole d’échange. V2
  2. Il est recommandé de transmettre l'adresse complète de l'acheteur. Certaines banques vérifient la présence de ces informations pour accepter une demande de prélèvement. De plus, en renseignant ces informations, les champs correspondants seront pré-remplis sur la page de signature du mandat.

    Nom du champ Description Valeur
    vads_cust_address Adresse de l'acheteur.  
    vads_cust_city Ville de l'acheteur.

    Obligatoire si le client possède un compte bancaire dans les départements, territoires ou pays suivants : Suisse, Monaco, Saint-Marin, Mayotte, Saint-Pierre-et-Miquelon, Guernesey, Jersey, Île de Man.

    Ex : FR
    vads_cust_country Code du pays de l’acheteur à la norme ISO 3166 alpha-2.

    Obligatoire si le client possède un compte bancaire dans les départements, territoires ou pays suivants : Suisse, Monaco, Saint-Marin, Mayotte, Saint-Pierre-et-Miquelon, Guernesey, Jersey, Île de Man.

    Ex : FR
    vads_cust_cell_phone Numéro de téléphone portable de l'acheteur pour l'envoi du code de sécurité (par SMS).

    Lorsque le numéro de téléphone portable de l'acheteur (numéro de téléphone enregistré lors d'une inscription) est pré-renseigné sur la page de paiement, l'acheteur ne peut le modifier lors de la signature du mandat. Seul le titulaire du GSM ayant enregistré ce numéro de téléphone lors de son inscription peut recevoir par SMS ce code d'accès à usage unique.

    Si le numéro de téléphone portable de l'acheteur n'est pas connu, l'acheteur sera invité à le renseigner sur la page de paiement.

    Ex : 0612345678
    vads_cust_first_name Permet de définir le prénom de l’acheteur. Ex : Jean
    vads_cust_last_name Permet de définir le nom de l’acheteur. Ex : Dupont
    vads_cust_title Permet de définir la civilité de l’acheteur. Ex :
    • M.
    • Mme

  3. 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" du guide API Formulaire.
Exemple de formulaire:
<form method="POST" action="https://sogecommerce.societegenerale.eu/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="2990" /> 
<input type="hidden" name="vads_capture_delay" value="0" /> 
<input type="hidden" name="vads_ctx_mode" value="TEST" /> 
<input type="hidden" name="vads_currency" value="978" /> 
<input type="hidden" name="vads_cust_country" value="FR" />
<input type="hidden" name="vads_cust_cell_phone" value="0612345678" />
<input type="hidden" name="vads_cust_email" value="monmail@exemple.com" />
<input type="hidden" name="vads_cust_first_name" value="Paul" /> 
<input type="hidden" name="vads_cust_last_name" value="Juve" /> 
<input type="hidden" name="vads_cust_title" value="M." /> 
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_cards" value="SDD" /> 
<input type="hidden" name="vads_payment_config" value="SINGLE" /> 
<input type="hidden" name="vads_site_id" value="12345678" /> 
<input type="hidden" name="vads_trans_date" value="20240913131438" /> 
<input type="hidden" name="vads_trans_id" value="3N2kj2" /> 
<input type="hidden" name="vads_validation_mode" value="0" /> 
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="RROvv+fsP4U27wB2cqm67eDUv0gMXrvCSD05lKcWI28="/>
<input type="submit" name="payer" value="payer"/>
</form>
© 2025 Tous droits réservés à Sogecommerce
25.18-1.11