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) Nom Format Exemple Remarques Code redirect_success_timeout n..3 5 Exprimé en secondes 34 redirect_success_message ans..255 Vous allez 35 être redirigé vers votre site marchand redirect_error_timeout n..3 Exprimé en secondes 36 redirect_error_message ans..255 Vous allez 37 être redirigé vers votre site marchand return_mode GET/POST /NONE GET 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 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 Code Exprimé en secondes 34 vads_redirect_success_timeout n..3 5 vads_redirect_success_message vads_redirect_error_timeout vads_redirect_error_message vads_return_mode ans..255 n..3 ans..255 GET/POST /NONE Vous allez être redirigé vers votre site marchand Vous allez être redirigé vers votre site marchand GET Retour automatique à la boutique Lyra Network- 2/3 Exprimé en secondes Valeur conseillée 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 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. 35 36 37 48
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