Web 2 - Systempay

Plateforme Systempay
Retour automatique à la boutique
Version 2.2
Rédaction, Vérification, Approbation
Rédaction
Vérification
Approbation
Nom
Date/Visa
Nom
Date/Visa
Nom
Date/Visa
Lyra-Network
24/05/2012
Lyra-Network
24/05/2012
Lyra-Network
24/05/2012
Historique du document
Version
Auteur
Date
Commentaires
2.2
Lyra-Network
24/05/2012
Note d’avertissement sur le timeout à 0
2.1
Lyra-Network
05/09/2011
Précision apportées sur les URL de redirection
2.0
Lyra-Network
05/04/2011
Ajout des paramètres pour la version V2
1.0
Lyra-Network
16/07/2010
Création du document
Confidentialité
Toutes les informations contenues dans ce document sont considérées comme
confidentielles. L’utilisation de celles-ci en dehors du cadre de cette consultation ou la
divulgation à des personnes extérieures est soumise à l’approbation préalable de Lyra
Network.
SOMMAIRE
1. Principe général ...................................................................1
2. Liste des paramètres ............................................................1
2.1. Vous implémentez la version V1 de la plateforme (version=V1) ....... 1
2.2. Vous implémentez la version V2 de la plateforme (version=V2) ....... 2
3. Exemple de formulaire pour version plateforme V2 ........3
1. Principe général
La plateforme de paiement Systempay permet le retour automatique à la boutique. A la
fin d’un paiement il est donc possible de revenir à la boutique sans que le client ne clique sur
le bouton retourner à la boutique.
Cette documentation décrit les paramètres supplémentaires qu’il est nécessaire de
poster dans le formulaire de paiement.
Attention : la méthode décrite dans ce document ne doit pas être utilisée pour
substituer le traitement de la commande via l’URL serveur.
2. Liste des paramètres
2.1. Vous implémentez la version V1 de la plateforme (version=V1)
Format
Exemple
redirect_success_timeout
redirect_success_message
Nom
n..3
ans..255
5
redirect_error_timeout
redirect_error_message
n..3
ans..255
return_mode
GET/POST
/NONE
Remarques
Code
Exprimé en secondes
34
35
Exprimé en secondes
36
37
Valeur conseillée GET
48
Vous
allez
être redirigé
vers
votre
site
marchand
Vous
allez
être redirigé
vers
votre
site
marchand
GET
ATTENTION : Si vous choisissez un timeout à zéro, votre redirection s’effectuera de la manière
suivante :
 Pour un paiement accepté, l’internaute sera redirigé sur url_success
 Pour tous les autres cas, refus ou annulation, l’internaute sera redirigé sur url_cancel si
cette variable est définie. Dans le cas contraire, l’internaute sera redirigé sur url_return
ou sur l’url de retour renseignée dans l’outil de gestion de caisse.
redirect_success_timeout
Ce paramètre permet de définir le délai d’attente avant redirection du client sur le site
marchand dans le cas d’un paiement réussi. Ce délai est exprimé en seconde et doit être
compris entre 0 et 300 secondes.
L’internaute sera redirigé vers l’URL de succès (url_success) ou à défaut sur l’URL de retour
(url_return).
Descriptif de l’interface vers la page de paiement
©Lyra Network- 1/3
redirect_success_message
Ce paramètre permet de définir le message d’attente avant la redirection vers le site
marchand dans le cas d’un paiement réussi.
redirect_error_timeout
Ce paramètre permet de définir le délai d’attente avant redirection du client sur le site
marchand dans le cas d’un paiement échoué. Ce délai est exprimé en seconde et doit être
compris entre 0 et 300 secondes.
En cas d’erreur ou d’annulation, l’internaute sera redirigé vers l’url d’annulation (url_cancel)
ou à défaut vers l’url de retour (url_return)
redirect_error_message
Ce paramètre permet de définir le message d’attente avant la redirection vers le site
marchand dans le cas d’un paiement échoué.
return_mode :
Ce paramètre défini dans quel mode seront retournés les paramètres vers la boutique
marchand.
Dans le cas de la redirection automatique, il est fortement conseillé de valoriser ce champ à
GET.
2.2. Vous implémentez la version V2 de la plateforme (version=V2)
La définition des paramètres est identique au chapitre précédent, seules les variables ont été
préfixées de vads_.
Nom
Format
Exemple
Remarques
Exprimé en
secondes
vads_redirect_success_timeout
n..3
5
vads_redirect_success_message
ans..255
Vous allez être
redirigé vers votre
site marchand
vads_redirect_error_timeout
n..3
vads_redirect_error_message
ans..255
Vous allez être
redirigé vers votre
site marchand
vads_return_mode
GET/POST
/NONE
GET
Code
34
35
Exprimé en
secondes
36
37
Valeur conseillée
GET
48
ATTENTION : Si vous choisissez un timeout à zéro, votre redirection s’effectuera de la manière
suivante :
 Pour un paiement accepté, l’internaute sera redirigé sur vads_url_success
 Pour tous les autres cas, refus ou annulation, l’internaute sera redirigé sur
vads_url_cancel si cette variable est définie. Dans le cas contraire, l’internaute sera
redirigé sur vads_url_return ou sur l’url de retour renseignée dans l’outil de gestion de
caisse.
Retour automatique à la boutique
©Lyra Network- 2/3
3. Exemple de formulaire pour version plateforme V2
<form method="POST" action="https://systempay.cyberpluspaiement.com/vads-payment/">
<input type="hidden" name="vads_redirect_success_timeout" value="5" />
<input type="hidden" name="vads_redirect_success_message" value="Redirection vers la boutique dans 5
sec"/>
<input type="hidden" name=" vads_redirect_error_timeout" value="5"/>
<input type="hidden" name=" vads_redirect_error_message" value=" Redirection vers la boutique dans 5
sec " />
<input type="hidden" name=" vads_return_mode" value="GET"/>
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_amount" value="1550" />
<input type="hidden" name="vads_capture_delay" value="" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_payment_cards" value="" />
<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="20100713111845" />
<input type="hidden" name="vads_trans_id" value="1212121" />
<input type="hidden" name="vads_validation_mode" value="" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_url_return" value="http://monsite.com/echec.php" />
<input type="hidden" name="vads_url_success" value="http://monsite.com/retour_ok.php" />
<input type="hidden" name="vads_order_info" value="4444444"/>
<input type="hidden" name="signature" value="8ecaa8074ffed2eb59ff8f8bf94981a45232121/>
<input type="submit" value="Payer" />
Attention ce formulaire est un exemple, si vous copier-coller ce formulaire, celui-ci
ne fonctionnera pas. En effet les paramètres vads_site_id et signature sont invalides.
Retour automatique à la boutique
©Lyra Network- 3/3