Générer un formulaire de paiement
<form method="POST" action="https://paiement.systempay.fr/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://paiement.systempay.fr/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 pour envoyer 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 :
Exemple :
{"name1":45,"name2":"value2", "name3":false}
|
| bool | Booléen. Peut prendre la valeur true ou 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 :
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 |