Enregistrer un mandat et définir un abonnement fixe

Pour enregistrer un mandat récurrent 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_site_id Identifiant de la boutique Ex : 12345678
    vads_ctx_mode Mode de fonctionnement TEST ou PRODUCTION
    vads_trans_date Date et heure UTC du formulaire de paiement Ex : 20160919130128
    vads_action_mode Mode d’acquisition des données bancaires. INTERACTIVE
    vads_page_action Action à réaliser REGISTER_SUBSCRIBE
    vads_version Version du protocole d’échange V2
    vads_cust_email Adresse e-mail de l’acheteur.

    Remarque :

    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_sub_effect_date Date d'effet de l'abonnement Ex : 20161002
    vads_sub_amount Montant des échéances dans sa plus petite unité monétaire Ex : 3000 pour 30,00 EUR
    vads_sub_currency Code de la devise utilisée pour le paiement suivant la norme ISO 4217 Ex : 978 pour l'euro (EUR)
    vads_sub_desc Règle de l'abonnement à appliquer Ex: RRULE:FREQ=MONTHLY;

    BYMONTHDAY=10

  2. Valorisez le champ vads_page_action à REGISTER_SUBSCRIBE .
  3. Valorisez le champ vads_action_mode à INTERACTIVE.
  4. Valorisez le champ vads_sub_effect_date .
    Pour des raisons techniques, la date d'effet doit être au minimum à + 14 jours calendaires par rapport à la date de soumission du formulaire (vads_trans_date).
  5. Valorisez le champ vads_currency à 978 (code de la devise euro).
    Seule la devise euro est acceptée pour ce moyen de paiement.
  6. Valorisez le champ vads_sub_desc.
    Pour vous aider voici trois exemples de regles de récurrence:
    • Pour définir des échéances de paiement ayant lieu le 1er de chaque mois, pendant 12 mois:

    RRULE:FREQ=MONTHLY;COUNT=12;BYMONTHDAY=1

    • Pour définir des échéances de paiement ayant lieu chaque trimestre, jusqu’au 31/12/2016 :

    RRULE:FREQ=YEARLY;BYMONTHDAY=1;BYMONTH=1,4,7,10;UNTIL=20161231

    • 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

  7. Si vous souhaitez pré-renseigner des champs avec des informations déjà connues, utilisez l'ensemble des champs optionnels présents dans le tableau ci-après pour construire votre formulaire de paiement :

    Nom du champ Description Valeur
    vads_cust_title Permet de définir la civilité de l’acheteur. Ex :
    • M.
    • Mme
    • Mlle
    vads_cust_last_name Permet de définir le nom de l’acheteur. Ex : Dupont
    vads_cust_first_name Permet de définir le prénom de l’acheteur. Ex : Jean
    vads_cust_cell_phone Numéro de téléphone portable de l'acheteur pour l'envoi du code de sécurité (par SMS).

    Remarque :

    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_address Adresse de l'acheteur

    Remarque

    L'adresse est requise 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.

     
    vads_cust_country Permet de spécifier le code du pays de l’acheteur à la norme ISO 3166. Ex : FR

    IMPORTANT

    Si la valeur du champ vads_cust_cell_phone est fournie dans un format international (+336xxxxxxxx) ou si les champs vads_cust_cell_phone et vads_cust_country sont tous les deux valorisés, alors le code de sécurité sera systématiquement envoyé par SMS indépendamment du mode de signature paramétré au niveau de la boutique.

  8. Si vous souhaitez pré-renseigner le ou les moyens de paiement affichés, valorisez le champ optionnel vads_payment_cards.

    Remarque :

    • Si la liste ne contient qu'un moyen de paiement, la page de saisie des données de ce moyen de paiement sera directement présentée.

      Pour proposer le prélèvement SEPA, la valeur attendue est SDD.

    • Sinon la page de sélection des moyens de paiement sera présentée.
    • Si ce paramètre est vide (conseillé) alors tous les moyens de paiement éligibles (en fonction de la devise, du montant min ou max, des contraintes techniques comme la présence des données panier, adresse porteur, adresse de livraison, etc.) associés à la boutique seront proposés.
  9. Ajoutez les champs optionnels en fonction de vos besoins (voir chapitre Utiliser des fonctions complémentaires).
  10. 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).
Exemple de formulaire:
<form method="POST" action="https://secure.payzen.eu/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<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_SUBSCRIBE" />
<input type="hidden" name="vads_site_id" value="70258842" />
<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=1" />
<input type="hidden" name="vads_sub_effect_date" value="20161002" />
<input type="hidden" name="vads_trans_date" value="20160919130128" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/>
<input type="submit" name="payer" value="Payer"/></form>