Mettre à jour un mandat et effectuer un paiement

Prérequis

Il est indispensable d'avoir enregistré un mandat (vads_page_action = REGISTER) avant de procéder à la mise à jour d'un mandat.

Pour mettre à jour un mandat récurrent et effectuer un paiement :

  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 pour mettre à jour un mandat et effectuer un paiement REGISTER_UPDATE_PAY
    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_identifier Rappel de l'alias de paiement à débiter Ex : 22e75ce992924f069279f42afe18da10
    vads_amount Montant du paiement dans sa plus petite unité monétaire Ex : 3000 pour 30,00 EUR
    vads_currency Code de la devise utilisée pour le paiement suivant la norme ISO 4217 Ex : 978 pour l'euro (EUR)
  2. Valorisez le champ vads_page_action à REGISTER_UPDATE_PAY.
    Remarque :
    Ne pas confondre REGISTER_UPDATE_PAY et REGISTER_UPDATE.
    REGISTER_UPDATE permet seulement de mettre à jour un mandat sans effectuer de paiement.
  3. Valorisez le champ vads_action_mode à INTERACTIVE.
  4. Valorisez le champ vads_currency à 978 (code de la devise euro).
    Seule la devise euro est acceptée pour ce moyen de paiement.
  5. Valorisez le champ vads_amount avec un montant exprimé en son unité indivisible (en centimes pour l'euro).
  6. Valorisez le champ vads_identifier avec l'alias (identifiant) que vous avez récupéré lors de l'enregistrement du mandat.
  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_identifier" value="22e75ce992924f069279f42afe18da10" />
<input type="hidden" name="vads_page_action" value="REGISTER_UPDATE_PAY" />
<input type="hidden" name="vads_site_id" value="70258842" />
<input type="hidden" name="vads_amount" value="2990" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_trans_date" value="20160919130128" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="89b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/>
<input type="submit" name="payer" value="Payer"/>
</form>