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 :

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. Il est conseillé de toujours choisir une date fixe (par exemple le 05 ou le 15 du mois) ou un jour fixe de la semaine (par exemple le mercredi) afin de faciliter la validation des fichiers de prélèvement.	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

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

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

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.

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://scelliuspaiement.labanquepostale.fr/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>

Catégories

Tags

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