Générer un formulaire de paiement

Pour générer une demande de paiement, vous devez construire un formulaire html comme suit :
<form method="POST" action="https://secure.lyra.com/vads-payment/">
	<input type="hidden" name="parametre1" value="valeur1" />
	<input type="hidden" name="parametre2" value="valeur2" />
	<input type="hidden" name="parametre3" value="valeur3" />
	<input type="hidden" name="signature" value="signature"/>
	<input type="submit" name="payer" value="Payer"/>
</form>

Il contient :

Les éléments techniques suivants :

  • Les balises <form> et </form> qui permettent de créer un formulaire HTML.
  • L’attribut method="POST" qui spécifie la méthode utilisée pour envoyer les données.
  • L’attribut action="https://secure.lyra.com/vads-payment/" qui spécifie où envoyer les données du formulaire.

Les données du formulaire :

  • L’identifiant de la boutique.
  • Les caractéristiques du paiement en fonction du cas d’utilisation.
  • Les informations complémentaires en fonction de vos besoins.
  • La signature qui assure l'intégrité du formulaire.

Ces données sont ajoutées au formulaire en utilisant la balise <input> :

<input type="hidden" name="parametre1" value="valeur1" />

Pour valoriser les attributs name et value, référez-vous au Dictionnaire de données disponible également sur le site documentaire.

Toutes les données du formulaire doivent être encodées en UTF-8.

Les caractères spéciaux (accents, ponctuation etc.) seront ainsi correctement interprétés par la plateforme de paiement. Dans le cas contraire, le calcul de signature sera erroné et le formulaire sera rejeté.

Le bouton Payer qui va permettre l’envoi des données :

<input type="submit" name="payer" value="Payer"/>

Des cas d’utilisation sont présentés dans les chapitres suivants. Ils vous permettront de construire votre formulaire de paiement en fonction de vos besoins.

Le tableau suivant vous donne des indications sur les différents formats que vous pourrez rencontrer lors de la construction de votre formulaire.

Notation Description
a Caractères alphabétiques (de ‘A’ à ‘Z’ et de ‘a’ à ‘z’)
n Caractères numériques
s Caractères spéciaux
an Caractères alphanumériques
ans Caractères alphanumériques et spéciaux (à l'exception de "<" et ">")
3 Longueur fixe de 3 caractères
..12 Longueur variable jusqu’à 12 caractères
json JavaScript Object Notation.

Objet contenant des paires de clé/valeur séparées par une virgule.

Il commence par une accolade gauche " { et se termine par une accolade droite " } ".

Chaque paire clé/valeur contient le nom de la clé entre double-quotes suivi par " : ", suivi par une valeur.

Le nom de la clé doit être alphanumérique.

La valeur peut être :
  • une chaine de caractères (dans ce cas elle doit être encadrée par des doubles-quotes)
  • un nombre
  • un objet
  • un tableau
  • un booléen
  • vide
Exemple: {"name1":45,"name2":"value2", "name3"=false}
enum

Caractérise un champ possèdant un nombre fini de valeurs.

La liste des valeurs possibles est donnée dans la définition du champ.

liste d'enum Liste de valeurs séparées par un " ; ".

La liste des valeurs possibles est donnée dans la définition du champ.

Exemple: vads_payment_cards=VISA;MASTERCARD

map Liste de paires clé/valeur séparées par un " ; ".

Chaque paire clé/valeur contient le nom de la clé suivi par " = ", suivi par une valeur.

La valeur peut être :
  • une chaine de caractères
  • un booléen
  • un objet json
  • un objet xml

La liste des valeurs possibles pour chaque paire de clé/valeur est donnée dans la définition du champ.

Exemple: vads_theme_config=SIMPLIFIED_DISPLAY=true;RESPONSIVE_MODEL=Model_1