Création du formulaire de paiement
Le serveur marchand reçoit une demande de paiement de la part de l'application mobile et doit la transmettre à la plateforme de paiement.
Pour cela, le site marchand va générer un formulaire de paiement HTML qu'il postera à la plateforme de paiement.
L'intégrité des données échangées est garantie par un échange de signatures alphanumériques entre la plateforme de paiement et le serveur marchand.
Le serveur marchand transmettra la signature alphanumérique dans le formulaire de paiement (voir chapitre Calculer la signature ).
- Utilisez l'ensemble des champs présents dans ce
tableau pour construire la demande de paiement.
Nom du champ Description Format Valeur vads_site_id Identifiant de la boutique n8 Ex : 12345678 vads_currency Code numérique de la monnaie à utiliser pour le paiement, selon la norme ISO 4217 (code numérique) n3 Ex : 953 pour le Franc CFP (XPF) vads_amount Montant du paiement dans sa plus petite unité monétaire n..12 Ex : 4525 pour 4525 XPF vads_cust_email Adresse e-mail de l’acheteur ans..150 Ex : abc@example.com vads_payment_cards Type de carte. String Ex: VISA (Consultez le Guide d'implémentation - API Formulaire pour connaître la liste des valeurs possibles).
vads_order_id Numéro de commande Peut être composé de majuscules ou de minuscules, chiffres ou tiret ([A-Z] [a-z], 0-9, _, -).
ans..64 Ex : 2-XQ001 vads_version Version du protocole d’échange avec la plateforme de paiement enum V2 vads_theme_config Permet de gagner en performances en désactivant des éléments de la page de paiement comme le sélecteur de langue, les logos du bas de page, etc. map SIMPLIFIED_DISPLAY=true
vads_trans_date Date et heure du formulaire de paiement dans le fuseau horaire UTC n14 Respectez le format AAAAMMJJHHMMSS
Ex : 20200101130025vads_trans_id Numéro de la transaction. Doit être unique sur une même journée (de 00:00:00 UTC à 23:59:59 UTC).
Attention : ce champ n'est pas sensible à la casse.
an6 Ex : xrT15p vads_payment_config Type de paiement enum SINGLE pour un paiement en 1 fois MULTI pour un paiement en plusieurs fois
vads_page_action Action à réaliser enum PAYMENT vads_ctx_mode Mode de communication avec la plateforme de paiement enum TEST ouPRODUCTION vads_action_mode Mode d’acquisition des données du moyen de paiement enum INTERACTIVE signature Signature garantissant l'intégrité des requêtes échangées entre le site marchand et la plateforme de paiement. Le calcul de sa valeur est précisé ici : Calculer la signature. ans44 Ex: NrHSHyBBBc+TtcauudspNHQ5cYcy4tS4IjvdC0ztFe8=
- Utilisez les champs ci-dessous pour gérer le retour
vers l'application mobile à la fin du paiement.
Un paiement peut aboutir sur 4 états différents :
Paiement accepté
Paiement refusé
Paiement en erreur
Paiement abandonné par l'acheteur.
Pour chaque état vous devez associer une URL:
Nom du champ Description Format Valeur vads_url_success URL où sera redirigé l’acheteur, en cas de succès.
ans..1024 Ex: http://webview.success
vads_url_refused URL où sera redirigé l’acheteur, en cas de refus.
ans..1024 Ex: http://webview.refused
vads_url_cancel URL où sera redirigé l’acheteur en cas d'abandon ou d'expiration (timeout).
ans..1024 Ex: http://webview.cancel
vads_url_error URL où sera redirigé l’acheteur en cas d'erreur.
ans..1024 Ex: http://webview.error
- Utilisez les champs ci-dessous pour configurer les
temps de redirection vers l'application mobile à la fin du
paiement:
Nom du champ Description Format vads_redirect_success_timeout Définit le délai d’attente avant redirection après un paiement réussi.
Ce délai est exprimé en seconde et doit être compris entre 0 et 300 secondes.Valorisez ce champ à "0" pour ne pas afficher le ticket de paiement et rediriger automatiquement l'acheteur vers l'application mobile.
n..3 vads_redirect_error_timeout Définit le délai d’attente avant redirection après un paiement refusé.
Ce délai est exprimé en seconde et doit être compris entre 0 et 300 secondes.Valorisez ce champ à "0" pour ne pas afficher la page de refus de paiement et rediriger automatiquement l'acheteur vers l'application mobile.
n..3 - Ajoutez les autres champs optionnels en fonction de vos besoins (voir sous chapitres suivants).