Définir le contrat commerçant

Le marchand peut spécifier dans son formulaire de paiement la valeur du contrat commerçant à utiliser.

Cette fonctionnalité n'est utile que si vous possédez plusieurs contrats acceptant la même devise sur un même réseau d’acceptation.

  1. Utilisez l’ensemble des champs nécessaires à votre cas d’utilisation (voir chapitre Générer un formulaire de paiement) pour construire votre formulaire de paiement.
  2. Utilisez le champ facultatif vads_contracts pour définir le contrat commerçant utilisé.
    Exemple :
    Valeur Description
    Absent ou vide Utilisation du contrat tel que défini par l'ordre de priorité dans le Back Office Marchand (Menu Paramétrage > Boutique > onglet Contrats).
    CB=12312312 Réseau CB
    POSTFINANCE=contrat_yp Réseau PostFinance
    AMEXGLOBAL=949400444000 Réseau American Express
    PAYPAL=nom@paypal.com PayPal

    Pour définir une liste de contrats, séparez les valeurs par un point-virgule « ; ».

    Pour exclure un réseau, il faut ajouter nom du réseau=NO

  3. 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:

Vous disposez de:

  • deux contrats CB: 1231230 et 1231231
  • deux contrats AMEXGLOBAL: 949400444000 et 949400444001

Pour spécifier le contrat à utiliser pour ces deux réseaux, vads_contracts devra être valorisé de la manière suivante : vads_contracts=CB=1231231; AMEXGLOBAL=949400444000

Pour proposer un paiement uniquement sur le contrat 1231231 et pas sur l'un des contrats AMEXGLOBAL, les valeurs de vads_contracts seront :

vads_contracts=CB=1231231; AMEXGLOBAL=NO

Exemple de formulaire de paiement définissant le contrat commerçant utilisé:
<form method="POST" action="https://paiement.systempay.fr/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="4000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_contracts" value="CB=1231231;AMEXGLOBAL=949400444000 />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="SINGLE" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20140327145218" />
<input type="hidden" name="vads_trans_id" value="571381" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="7mjGsUAcl4Ox6p5WZ8RNN7ROsxlJ0py3SMtSzdfbHEM="/>
<input type="submit" name="payer" value="Payer"/>
</form>