• 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

Enregistrer un mandat récurrent avec un paiement et définir un abonnement fixe

Pour enregistrer un mandat récurrent avec un paiement et créer un abonnement dont les montants et les dates d'échéances sont fixes :

  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_currency Code de la devise suivant la norme ISO 4217. 978
    vads_ctx_mode Mode de fonctionnement. TEST ou PRODUCTION
    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 REGISTER_PAY_SUBSCRIBE
    vads_payment_cards Moyen de paiement. SDD
    vads_site_id Identifiant de la boutique. Ex : 12345678
    vads_sub_amount Montant des échéances dans sa plus petite unité monétaire Ex : 4525 pour 45,25 EUR
    vads_sub_currency Code de la devise suivant la norme ISO 4217. Valeur possible : 978
    vads_sub_desc Règle de récurrence à appliquer suivant la spécification iCalendar RFC5545.

    La fréquence de l'abonnement peut être journalière, hebdomadaire ou mensuelle.

    Il est possible de spécifier le numéro du jour ou du mois.

    Par exemple :
    • le 10 de chaque mois :

      FREQ=MONTHLY;BYMONTHDAY=10,

    • tous les 3 mois :

      FREQ=MONTHLY;INTERVAL=3,

    • tous les mois sauf en août :

      FREQ=YEARLY;BYMONTH=1,2,3,4,5,6,7,9,10,11,12;

    Remarque: la chaine ne doit pas contenir d'espace.

    		 Exemples:
    • Pour définir des échéances de paiement ayant lieu le 15 de chaque mois, pendant 12 mois :
    RRULE:FREQ=MONTHLY;
COUNT=12;BYMONTHDAY=15
    • Pour définir des échéances de paiement ayant lieu le 4ème mardi de chaque mois :
    RRULE:FREQ=MONTHLY;BYDAY=4TU
    • Pour définir un abonnement toutes les semaines :
    RRULE:FREQ=WEEKLY
    • Pour définir un abonnement toutes les deux semaines, aujourd’hui et tous les 7 jours :
    RRULE:FREQ=WEEKLY;INTERVAL=2
    • Pour définir des échéances de paiement ayant lieu le dernier jour de chaque mois, pendant 12 mois :
    RRULE:FREQ=MONTHLY;
BYMONTHDAY=28,29,30,31;
BYSETPOS=-1;COUNT=12
    vads_sub_effect_date Date d'effet de l'abonnement.

    Pour des raisons techniques, la date d'effet doit être au minimum 14 jours calendairesaprès la date de soumission du formulaire (vads_trans_date).

    		 Ex : 20241001
    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. Si vous souhaitez définir un abonnement dont la (ou les) première échéance est valorisée différemment de celles qui sont valorisées par le champ vads_sub_amount, utilisez les champs ci-dessous :
    Nom du champ Description Valeur
    vads_sub_init_amount Montant des premières échéances. Le nombre des premières échéances est défini par vads_sub_init_amount_number.

    Ne peut être valorisé à 0.

    Pour définir un abonnement dont les n premiers mois sont gratuits, il vous suffit de décaler la date d'effet (vads_sub_effect_date) de n mois.

    		 2500
    vads_sub_init_amount_number Nombre d'échéances auxquelles sera appliqué le montant défini par vads_sub_init_amount. 3
  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" 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="4525" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_cust_email" value="nom.prenom@exemple.com" />
<input type="hidden" name="vads_page_action" value="REGISTER_PAY_SUBSCRIBE" />
<input type="hidden" name="vads_payment_cards" value="SDD" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_sub_amount" value="2990" />
<input type="hidden" name="vads_sub_currency" value="978" />
<input type="hidden" name="vads_sub_desc" value="RRULE:FREQ=MONTHLY;BYMONTHDAY=15" />
<input type="hidden" name="vads_sub_effect_date" value="20200609" />
<input type="hidden" name="vads_trans_date" value="20240913131438" />
<input type="hidden" name="vads_trans_id" value="V8y52j" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="moN40CpO8Kp8WCe8OHyebvEfSv2uzTajPHefcB9iIHk="/>
<input type="submit" name="payer" value="Payer"/></form>
© 2025 Tous droits réservés à Sogecommerce
25.18-1.11