Enregistrer un mandat

Enregistrer un mandat récurrent correspond à la création d'un alias.

Ce dernier pourra être utilisé ultérieurement pour :

  • effectuer un paiement,
  • créer un abonnement,
  • utiliser le service d'échange de fichier. En combinant ce formulaire avec le service d'échange de fichier, chaque prélèvement pourra avoir un montant et une date d'échéance différents.
  • etc.

IMPORTANT

Si vous utilisez la plateforme de paiement uniquement pour effectuer de la signature de mandat SEPA, alors vous devez, au bout de 3 ans sans utilisation du mandat, appeler la méthode DELETE des Web Services REST SEPA afin que nous procédions à sa suppression. Pour plus d'informations, veuillez contacter le support.

Remarque

Il est également possible de créer un alias depuis le Back Office Marchand (voir chapitre Gérer les alias depuis le Back Office Marchand).

Pour enregistrer un mandat récurrent :

  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 : 20140919130128
    vads_action_mode Mode d’acquisition des données bancaires. INTERACTIVE
    vads_page_action Action à réaliser pour enregistrer un mandat et effectuer un paiement REGISTER
    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
  2. Valorisez le champ vads_page_action à REGISTER.
  3. Valorisez le champ vads_action_mode à INTERACTIVE.
  4. 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.
  5. 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.
  6. Ajoutez les champs optionnels en fonction de vos besoins (voir chapitre Utiliser des fonctions complémentaires).
  7. 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" />
<input type="hidden" name="vads_site_id" value="70258842" />
<input type="hidden" name="vads_trans_date" value="20160919130128" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="54b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/>
<input type="submit" name="payer" value="Payer"/>
</form>