Plateforme Systempay Descriptif de l interface avec la page de paiement

Please download to get full document.

View again

of 23
333 views
PDF
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Document Description
Plateforme Systempay Descriptif de l interface avec la page de paiement Version 1.13 Rubrique Aide : https://systempay.cyberpluspaiement.com Rédaction, Vérification, Approbation Rédaction Vérification
Document Share
Documents Related
Document Transcript
Plateforme Systempay Descriptif de l interface avec la page de paiement Version 1.13 Rubrique Aide : https://systempay.cyberpluspaiement.com Rédaction, Vérification, Approbation Rédaction Vérification Approbation Nom Date/Visa Nom Date/Visa Nom Date/Visa Lyra-Network 17/12/2008 Historique du document Version Auteur Date Commentaires 1.13 Lyra-Network 10/12/2010 Précision sur le champ trans_date, qui doit être exprimé au format horaire 24h Lyra-Network 09/07/2010 Précision sur trans_date, qui doit être exprimée en GMT/UTC. Mise à jour des exemples de code php en conséquence Lyra-Network 23/06/2010 Dans le code php exemple l identifiant boutique et le certificat sont donné en exemple et ne permette pas de faire un test de paiement. Dans le code est indiqué qu il faut saisir ses propres valeurs Lyra-Network 21/06/2010 Suppression des limitations des ports possibles pour les URL de retour suit e à modification de la plateforme de paiement. 1.9 Lyra-Network 18/06/2010 Modification du code php Ajout commentaire pour l url serveur 1.8 Lyra-Network 01/03/ Dans la redirection vers la plateforme de paiement, ajout du paramètre contracts - Dans le retour vers le site marchand, ajout du paramètre contract_used 1.7 Lyra-Network 27/01/ Dans la redirection vers la plateforme de paiement, ajout des paramètres contrib, order_info2, order_info3, payment_src ; user_info, theme_config dans la redirection vers la plateforme de paiement - Dans le retour vers le site marchand, ajout des paramètres order_info2, order_info3, payment_src ; user_info, theme_config, language - Ajout de valorisations pour le paramètre extra_result - Modification de la longueur du paramètre order_info 1.6 Lyra-Network 27/01/2010 Complément information sur les ports possible pour les URL de retour (80 et 443 ) Complément d information sur la variable payment_card Ajout code php pour le retour boutique 1.5 Lyra-Network 07/12/2009 Mise à jour de la procédure de téléchargement de logo Acceptation URL de retour serveur les url de type https 1.4 Lyra-Network 26/11/2009 Information complémentaire pour l URL serveur Information complémentaire pour les paiements de test Information complémentaire pour la variable trans_id 1.3 Lyra-Network 26/10/2009 Modification calcul URL calcul signature URL serveur (positionnement de la valeur hash) 1.2 Lyra-Network 13/10/2009 Ajout rubrique logo Correction EUR par le code monnaie 978 Ajout des paramètres pour calcul signature URL serveur Ajout information sur la définition du trans_id Complément d information sur URL retour (refus https ) Complément d information sur le type de carte Correction language japonais ja = jp Ajout contact problème d accès outils de gestion de caisse 1.1 Lyra-Network 13/05/2009 Ajout du paramètre Extra_result dans le retour vers le site marchand 0.90 Lyra-Network 05/03/2009 Mise à jour avant mise en production Lyra-Network 17/12/2008 Mise en forme, ajout d un exemple de code Lyra-Network 16/12/2008 Version initiale. 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 GENERAL Cinématique des échanges Les pages standard de la plateforme de paiement Sécurité REDIRECTION VERS LA PLATEFORME DE PAIEMENT Format et codage des paramètres Liste des paramètres Signature RETOUR VERS LE SITE MARCHAND Liste des paramètres Signature Réponse de serveur à serveur EXEMPLE DE CONTROLE DE LA SIGNATURE (Java) EXEMPLE D INTEGRATION (php) EXEMPLE CONTROLE SIGNATURE (php)- Retour vers boutique COMMENT ACTIVER LA BOUTIQUE EN PRODUCTION? Phase de test Récupération du certificat de test et de l identifiant du site (site_id) Réalisation des tests Transmission du PV de recette Activation de la boutique en production Récupération du certificat de production Réalisation d une première transaction en production MISE EN PLACE DU LOGO SUR LA PAGE DE PAIEMENT ASSISTANCE TECHNIQUE...27 1. PRINCIPE GENERAL 1.1. Cinématique des échanges La cinématique d'échange est la suivante : 1) Une fois la commande de l'internaute complète, le site marchand redirige celui-ci vers la plateforme de paiement. Cette redirection prendra la forme d'un formulaire HTTP POST en HTTPS contenant des paramètres décrits dans le chapitre suivant. 2) La plateforme de paiement, après vérification des paramètres et de leur signature, présentera soit une page de sélection du type de carte, soit directement la saisie correspondante à la carte lorsqu'il n'y a pas d'ambiguïté. 3) La plateforme de paiement affichera une page de saisie de numéro de carte, date d'expiration et cryptogramme visuel. En cas de validation, une redirection vers un ACS 3D-Secure aura éventuellement lieu, puis une demande d'autorisation sera effectuée auprès de l'acquéreur concerné, en plus des contrôles de fraude internes de la plateforme de paiement. 4) Une page de résumé sera présentée en cas de succès ou d'échec, avec un bouton de retour vers le site marchand. Si l option est active, un de confirmation de transaction sera envoyé à l'internaute. Lyra Network- 1/27 1.2. Les pages standard de la plateforme de paiement Sélection du type de carte : Saisie des informations de la carte : Lyra Network- 2/27 Compte-rendu d'une transaction réussie : Message d'échec de transaction : Lyra Network- 3/27 1.3. Sécurité Dans la communication entre la plateforme de paiement et le site marchand, un mécanisme de signature est à mettre en place. Les échanges étant effectués par paramètres de formulaire, l'un de ces paramètres sera la signature. La signature sera générée comme suit : - Création d'une chaîne de caractère représentant la concaténation de valeurs de certaines données du formulaire, séparées par le caractère + . - Ajout à cette chaîne d'un certificat numérique (de test ou de production selon le contexte). - Hachage de la chaîne résultante avec l'algorithme SHA1. La plateforme de paiement effectuera obligatoirement la vérification de la signature. Il est de la responsabilité du commerçant de vérifier à son tour les données transmises en retour, notamment pour mettre en œuvre un mécanisme de validation de commande. Lyra Network- 4/27 2. REDIRECTION VERS LA PLATEFORME DE PAIEMENT Cette redirection est effectuée via un formulaire HTTP POST. Le formulaire contient des champs décrits ci-dessous, ainsi qu'une signature basée sur une partie de ces champs. L URL de la plateforme de paiement est la suivante : https://systempay.cyberpluspaiement.com/vads-payment/ 2.1. Format et codage des paramètres Aux chapitres suivants, les paramètres et leur format sont listés dans des tableaux, dont voici la légende : - Nom : indique le nom du paramètre, tel qu ils seront utilisés dans les requêtes HTTP. - Format : indique le format des données, selon la codification suivante : 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 3 Longueur fixe de 3 caractères 12 Longueur variable jusqu à 12 caractères - Exemple : représente un exemple de codage correct des données. - Obligatoire : indique si la présence du paramètre est obligatoire. Attention, un paramètre obligatoire peut être vide. - Signature : indique si ce paramètre est utilisé dans le calcul de la signature. - Remarques : remarques sur l utilisation de ce paramètre. - Code : en cas d erreur dans l interfaçage entre le site marchand et la plateforme de paiement, cette dernière indiquera par un code numérique le paramètre fautif Liste des paramètres Nom Format Exemple Obligatoire Signature Remarques Code amount n oui oui 09 capture_delay n..3 3 oui oui vide : valeur 06 configurée par défaut, sinon, nombre de jours contrib ans currency n3 978 oui oui norme ISO pour EURO cust_address an cust_country a2 FR norme cust_ an cust_id an cust_name an Lyra Network- 5/27 Nom Format Exemple Obligatoire Signature Remarques Code cust_phone an cust_title an cust_city an cust_zip an ctx_mode TEST oui oui TEST ou 11 PRODUCTION language a2 fr norme ISO order_id an..32 Le tiret est 13 accepté. order_info an order_info2 an order_info3 an payment_cards an..127 VISA;MA STERCA RD oui oui Valorisation à vide conseillée «;» payment_config oui oui SINGLE ou MULTI (avec des paramètres). payment_src a..5 MOTO Vide, BO, MOTO, CC ou OTHER signature an40 7e4cd326 5ce8f475 35a52e19 c4446d2f e4fc8acb site_id n8 oui oui 02 theme_config ans trans_date n oui oui trans_id n6 oui oui Compris entre et validation_mode n..1 oui oui vide : valeur configurée par défaut 0 : validation automatique 1 : validation manuelle 05 version V1 oui oui 01 url_success ans url_referral ans url_refused ans url_cancel ans url_error ans url_return ans user_info ans contracts ans oui amount Paramètre obligatoire. Montant de la transaction exprimé en son unité indivisible (exemple : en cents pour l'euro) Lyra Network- 6/27 capture_delay Paramètre obligatoire indiquant le délai en nombre de jours avant remise en banque. Si ce paramètre est vide (il doit néanmoins être transmis), alors la valeur par défaut sera utilisée. Cette dernière est paramétrable dans l outil de gestion de caisse Cyberplus Paiement par toutes les personnes dûment habilitées. contracts Paramètre facultatif permettant de spécifier pour chaque réseau, le contrat à utiliser. Le formalisme du paramètre est le suivant : RESEAU1=contratReseau1;RESEAU2=contratReseau2;RESEAU3=contratReseau3 Les différents réseaux étant : Réseau American Express CB Valorisation contracts AMEX CB contrib Information complémentaire facultative destinée à indiquer le nom de la contribution utilisée lors du paiement (joomla, oscommerce...). currency Paramètre obligatoire indiquant la monnaie à utiliser, selon la norme ISO 4217 (code numérique). Pour l Euro, la valeur est 978. cust_ Adresse du client, nécessaire pour lui envoyer un mail récapitulatif de la transaction. Paramètre optionnel. cust_id Paramètre facultatif correspondant à un identifiant client pour le marchand. cust_name, cust_title, cust_address, cust_zip, cust_city, cust_phone Paramètres optionnels concernant le client, et correspondant respectivement à : cust_name : nom du client cust_title : civilité du client cust_address : adresse du client cust_zip : code postal du client cust_city : vile du client cust_phone : numéro de téléphone du client cust_country Code pays du client à la norme ISO Paramètre optionnel. Pour la France, le code est FR. Lyra Network- 7/27 ctx_mode Paramètre obligatoire indiquant le mode de sollicitation de la plateforme de paiement : - TEST : utilisation du mode test, nécessite d employer le certificat de test pour la signature. - PRODUCTION : utilisation du mode production, nécessite d employer le certificat de production pour la signature. language Paramètre optionnel indiquant la langue de la page de paiement (norme ISO 639-1). Les langues possibles sont les suivantes : Langue Codification ISO Allemand de Anglais en Chinois zh Espagnol es Français fr Italien it Japonais jp Par défaut, le français est sélectionné. order_id Ce paramètre est optionnel. Il correspond à un numéro de commande qui pourra être rappelé dans l' adressé au client. Sa taille maximale est de 12 caractères alphanumériques. order_info, order_info2, order_info3 Ces paramètres optionnels sont des champs libres. Ils peuvent par exemple servir à stocker un résumé de la commande. payment_cards Ce paramètre obligatoire contient la liste des types de cartes disponibles pour ce site, séparés par des ; . Si la liste ne contient qu'un type de carte, la page de saisie des données du paiement sera directement présentée. Sinon la page de sélection du moyen de paiement sera présentée. Si ce paramètre est vide alors l ensemble des moyens de paiement défini dans l outil de gestion de caisse sera présenté en sélection. Par défaut la valeur VIDE est conseillée. Les différents types de carte possibles sont : Réseau de la carte Amex CB Eurocard / MasterCard Valorisation payment_cards AMEX CB MASTERCARD Lyra Network- 8/27 Visa Maestro e-carte bleue VISA MAESTRO E-CARTEBLEUE payment_config Ce paramètre obligatoire indique le type du paiement : - SINGLE indique un paiement unitaire. - MULTI indique un paiement en plusieurs fois. Dans ce cas, le paramètre est constitué de la chaîne «MULTI:», suivi par des paires clés/valeurs séparées par des «;». Les paramètres sont les suivants : o «first» indique le montant du premier paiement. o «count» indique le nombre de paiements total. o «period» indique l intervalle en nombre de jours entre 2 paiements. Exemple : currency=978 amount=10000 payment_config=multi:first=5000;count=3;period=30 Dans cette configuration : - Un premier paiement de 50 euros sera effectué à aujourd hui + «capture_delay» jours. - Un deuxième paiement de 25 euros sera effectué à aujourd hui + «capture_delay» + 30 jours. - Un troisième et dernier paiement de 25 euros sera effectué à aujourd hui + «capture_delay» + 60 jours. Remarque : si la date de validité de la carte ne permet pas de réaliser le dernier paiement, la demande sera refusée par la plateforme. payment_src Paramètre facultatif définissant la source du paiement : - Paramètre non défini ou valeur vide, indique un paiement de type ecommerce. Dans ce cas, la garantie de paiement est calculée conformément aux options du commerce concerné. - BO indique un paiement effectué depuis le «Back Office» (saisie manuelle), dans ce cas il n y a pas de garantie de paiement. - MOTO indique un paiement effectué par un opérateur suite à une commande par téléphone ou (Mail Or Telephone Order). - CC indique un paiement effectué via un centre d appel (Call Center). - OTHER indique un paiement effectué par toute autre source que celles précédemment définies. Des informations complémentaires sur l origine du paiement peuvent être définies dans le paramètre user_info. NB : L utilisation de ce paramétrage n est permise que pour les commerçants ayant souscrit une offre adéquate. Merci de contacter votre chargé de clientèle bancaire pour plus d informations. signature Paramètre obligatoire permettant à la plateforme de vérifier la validité de la requête transmise (voir le chapitre suivant). Lyra Network- 9/27 site_id Paramètre obligatoire attribué lors de l'inscription à la plateforme de paiement. Sa valeur est consultable sur l interface de l outil de gestion de caisse Cyberplus Paiement dans l onglet «Paramétrages» / «Boutique» par toutes les personnes habilitées. theme_config Paramètre facultatif permettant de personnaliser certains paramètres de la page de paiement standard, comme les logos, bandeaux et certains messages. Contacter le support technique pour plus d informations. trans_date Ce paramètre est obligatoire. Correspond à l horodatage au format AAAAMMJJHHMMSS. L horodatage doit nécessairement correspondre à la date et heure courants, dans le fuseau GMT (ou UTC) au format horaire 24h. trans_id Ce paramètre est obligatoire. Il est constitué de 6 caractères numériques et doit être unique pour chaque transaction sur un site donné sur la journée. En effet l'identifiant unique de transaction au niveau de la plateforme de paiement est constitué du site_id, de trans_date restreint à la valeur de la journée (partie correspondant à AAAAMMJJ) et de trans_id. Il est à la charge du site marchand de garantir cette unicité sur la journée. Il doit être impérativement compris entre et La tranche et est interdite. validation_mode Paramètre obligatoire indiquant si cette transaction devra faire l'objet d'une validation manuelle de la part du commerçant. Si ce paramètre est vide alors la configuration par défaut du site sera prise. Cette dernière est paramétrable dans l outil de gestion de caisse Cyberplus Paiement par toutes les personnes dûment habilitées. version Paramètre obligatoire. La version actuelle est V1. url_success URL facultative où sera redirigé le client en cas de succès du paiement, après appui du bouton retourner à la boutique . url_referral URL facultative où sera redirigé le client en cas de refus d autorisation avec le code 02 «referral», après appui du bouton retourner à la boutique . url_refused URL facultative où sera redirigé le client en cas de refus pour toute autre cause que le referral , après appui du bouton retourner à la boutique . Lyra Network- 10/27 url_cancel URL facultative où sera redirigé le client si celui-ci appuie sur annuler et retourner à la boutique avant d'avoir procédé au paiement. url_error URL facultative où sera redirigé le client en cas d'erreur de traitement interne. url_return URL facultative où sera redirigé par défaut le client après un appui sur le bouton retourner à la boutique , si les URL correspondantes aux cas de figure vus précédemment ne sont pas renseignées. Si cette URL n est pas présente dans la requête, alors c est la configuration dans l outil de gestion de caisse qui sera prise en compte. En effet il est possible de configurer des URL de retour, en mode TEST et en mode PRODUCTION. Ces paramètres sont nommés «URL de retour de la boutique» et «URL de retour de la boutique en mode test» respectivement, et sont accessibles dans l onglet «Configuration» lors du paramétrage d une boutique. Si toutefois aucune URL n est présente, que ce soit dans la requête ou dans le paramétrage de la boutique, alors le bouton «retourner à la boutique» redirigera vers l URL générique de la boutique (paramètre nommé «URL» dans la configuration de la boutique). user_info Paramètre facultatif spécifiant des informations complémentaires quant au paiement. Dans le cas d un paiement via une saisie manuelle, ce paramètre contient l identifiant de l utilisateur à l origine de la transaction. Dans les autres cas de paiement ( , téléphone ) tels que définis par le paramètre payment_src, ce paramètre doit servir à identifier l opérateur à l origine de la transaction Signature La signature sera constituée des champs suivants : - version - site_id - ctx_mode - trans_id - trans_date - validation_mode - capture_delay - payment_config - payment_cards - amount - currency Lyra Network- 11/27 - Valeur du certificat en fonction du mode Les valeurs de ces champs doivent être concaténées entre elles avec le caractère «+». L ordre des champs doit respecter la liste ci-dessus. Au résultat de cette concaténation, on concatènera la valeur du certificat employé (certificat de test ou de production). Exemple : si les paramètres de la requête sont les suivants : - version = V1 - site_id = ctx_mode = TEST - trans_id = trans_date = validation_mode = 1 - capture_delay = 3 - payment_config = SINGLE - payment_cards = VISA;MASTERCARD - amount = currency = Valeur du certificat en fonction du mode = Et que la valeur du certificat de test est , alors la chaîne à utiliser pour le hachage à l aide de l algorithme SHA1 sera la suivante : V TEST SINGLE+VISA;MASTERCARD Lyra Network- 12/27 3. RETOUR VERS LE SITE MARCHAND Cette redirection est effectuée via un formulaire HTTP POST. Le formulaire contient des champs décrits ci-dessous, ainsi qu'une signature basée sur la totalité de ces champs. Le certificat employé est le même que celui de la requête. Les champs optionnels de la requête sont renvoyés tels quels dans la réponse, mais ne font pas partie de la signature. Il est recommandé de ne pas faire dépendre un traitement critique de la valeur de
Search Related
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks
SAVE OUR EARTH

We need your sign to support Project to invent "SMART AND CONTROLLABLE REFLECTIVE BALLOONS" to cover the Sun and Save Our Earth.

More details...

Sign Now!

We are very appreciated for your Prompt Action!

x