Ancienne solution: Questions fréquentes
Vue d'ensemble
Quels types de carte les Solutions de paiement par Internet de Desjardins acceptent-elles?
La majorité des cartes de crédit reconnues sont acceptées : VISA, MasterCard, American Express, Diners, Discover, JCB et Sears.
Quelles compétences techniques devrais-je avoir pour intégrer les Solutions de paiement par Internet de Desjardins?
En tant qu’intégrateur, vous êtes responsable d’intégrer le panier d’achat du marchand à la Solution de paiement par Internet de Desjardins. Il est donc fortement recommandé de posséder des connaissances techniques reliées à la création ou à l’utilisation d’un panier d’achat.
Il vous faudra notamment développer des scripts, des modules ainsi qu’un moyen de communication avec le serveur de paiement sécurisé Desjardins. Pour ce faire, vous devez posséder de très bonnes connaissances :
- XML;
- PHP, ASP classique, ASP.NET, VB.NET, C#, Java, Perl;
- HTML;
- http.
Quels sont les types d’intégration qui s’offrent à moi?
- Avec redirection
Ce type d’intégration permet d’intégrer les fonctions des Solutions de paiement par Internet de Desjardins de façon simple, rapide, abordable et sécuritaire.
- Sans redirection
Ce traitement, signifie que lors de l’achat, l’internaute demeure sur votre site tout au long de la transaction. Cette option est généralement choisie par les très grandes entreprises ou par les entreprises qui ont un nombre très élevé de transactions.
Est-il possible d’effectuer des transactions récurrentes?
Non. Pour le moment, les Solutions de paiement par Internet de Desjardins permettent d’effectuer des transactions uniques seulement. Elles n’offrent pas la possibilité d’effectuer des paiements sur une base récurrente.
Les transactions sont-elles traitées en temps réel?
Les achats sont entièrement traités en temps réel. Pour ce qui est des préautorisations et des remboursements, le différé est de deux minutes environ.
Est-ce que Desjardins fournit un outil de gestion au marchand afin qu’il soit en mesure de gérer ses transactions?
Un module d’administration en ligne multiusagers, d’accès privé et sécurisé, est offert à tous les marchands qui utilisent les Solutions de paiement par Internet de Desjardins.
Cet outil, livré sous forme de terminal virtuel, comprend un volet administratif et transactionnel. Une formation téléphonique de 60 minutes est également offerte afin d’en expliquer l’utilisation.
Combien de temps nécessite l’intégration des Solutions de paiement par Internet de Desjardins?
Le temps requis pour intégrer les Solutions de paiement par Internet peut varier en fonction :
- de l’expertise technique du programmeur;
- du travail déjà accompli sur le site du marchand.
En général, il est possible de compléter une intégration dans un délai de deux à trois semaines. Il est à noter que l’intégration du panier d’achat, qui relève de la responsabilité du marchand et de son intégrateur, n’est pas incluse dans ce délai. En effet, le marchand et son intégrateur doivent avoir intégré le panier d’achat avant de débuter l’intégration avec Desjardins.
Quelles sont les étapes d’une intégration aux Solutions de paiement par Internet de Desjardins?
- Envoi des codes de votre environnement de test (Desjardins)
- Envoi de la grille d’autoévaluation (Desjardins)
- Réception de l’information, lecture de la documentation (marchand/intégrateur)
- Développement de la portion de paiement (marchand/intégrateur)
- Tests unitaires, gestion des erreurs, tests de robustesse (marchand/intégrateur)
- Autoévaluation via la grille de certification (marchand/intégrateur)
* Reprendre les étapes 4 à 6, au besoin, si tous les points de la grille ne sont pas respectés (marchand/intégrateur)
- Envoi de la grille d’autoévaluation complétée à Desjardins (marchand/intégrateur)
- Première phase de certification (Desjardins)
- Envoi du rapport de certification (Desjardins)
* Reprendre les étapes 4 à 7, au besoin, si tous les points de la grille ne sont pas respectés (marchand/intégrateur)
- Demande de transfert en production (Desjardins)
- Envoi des codes de production (Desjardins)
- Ajout des codes de production (marchand/intégrateur)
Configuration
Quels sont les moyens à ma disposition pour effectuer un remboursement?
Nous suggérons le développement d’un script et l’utilisation du terminal virtuel (l’outil d’administration en ligne de Desjardins) pour répondre à tous les cas possibles nécessitant un remboursement.
L’information affichée sur la page de paiement sécurisée Desjardins n’est pas valide ou est incomplète. Que dois-je faire?
L’information qui apparaît sur la page de paiement Desjardins comporte des restrictions d’affichage. Si la longueur de ce qui est affiché ne vous convient pas, il suffit de communiquer avec le service à la clientèle ou de développer votre gabarit de page pour afficher l’information désirée. Il est préférable de vérifier cette information au début de l’intégration car elle sera utilisée lors de la mise en production.
De quelle façon dois-je procéder pour faire apparaître le logo du marchand sur la page de paiement sécurisée Desjardins?
Vous devez fournir l’URL pointant sur ce logo. Il ne faut pas envoyer le logo en fichier numérique par courriel à l’équipe d’intégration; le logo peut être en format gif, jpg ou png. Malgré qu’il n’y ait pas de taille ni de poids maximal, il est fortement recommandé d’utiliser un fichier de taille normale car cela pourrait affecter l’apparence de la page de paiement sécurisée Desjardins et son temps de chargement.
Tous les types de carte de crédit apparaissent sur la page de paiement sécurisée Desjardins.
Lorsque vous êtes en environnement de test, vous avez accès à toutes les cartes que les Solutions de paiement par Internet de Desjardins permettent. Lors de la mise en production, seules les cartes mentionnées par votre marchand à l’ouverture de son dossier apparaîtront et seront fonctionnelles.
Pourquoi les transactions ne peuvent-elles pas être approuvées lors des derniers échanges entre le serveur Desjardins et le serveur marchand possédant un certificat SSL?
Il est possible que votre certificat SSL ne soit pas supporté. Nous soutenons les certificats de VeriSign, Equifax, Thawte et Entrust. Malgré que nous ne puissions garantir leur fonctionnement, des certificats émis par d'autres CA pourraient être fonctionnels. Une demande doit être envoyée par courriel pour que des tests de compatibilité soient effectués sur nos environnements de développement et de production.
Pourquoi des erreurs de communication surviennent-elles en début de transaction ou en début de seconde portion de la transaction?
Dans ce cas, il suffit de valider que les ports de communication utilisés sont le 80 ou le 443.
Une fenêtre contextuelle apparaît dans la page de paiement pour signaler à l'utilisateur que des éléments de cette page ne sont pas sécurisés. Que se passe-t-il?
- Le marchand utilise un gabarit de page
Certains éléments de son gabarit ne sont pas sur un serveur sécurisé.
- Le marchand n'utilise pas de gabarit de page
Un script ou un élément externe se trouve sur la page de paiement, entre le serveur du marchand et le serveur de Desjardins, alors qu’il ne devrait pas y être.
Comment expliquer que la longueur des champs retournés par Desjardins, est différente en environnement de test de celles en environnement de production?
Veuillez vous référer au document "Annexes" pour la longueur des champs retournés en environnement de production.
Pourquoi est-ce que je n’arrive pas à compléter des transactions de remboursement?
Veuillez contacter l’équipe d’intégration afin de déterminer les causes possibles.
Lorsque je tente d’effectuer des transactions, je reçois le message : « WD09 (aucune carte supportée pour ce marchand) ». Que dois-je faire?
Veuillez contacter l’équipe d’intégration afin de déterminer les causes possibles.
Je reçois une confirmation positive pour une transaction de remboursement dans le « logfile », mais cette transaction apparaît comme étant non complétée dans le fichier de réponse et dans les « logs ». Pourquoi?
Veuillez contacter l’équipe d’intégration afin de déterminer les causes possibles.
J’éprouve un problème d’accès au serveur. Que dois-je faire?
- Vérifiez que votre script de paiement accède à l’adresse du serveur de développement : https://www.labdevtrx3.com/catch
- Vérifiez que votre réseautique permet l’accès au serveur directement sur les ports 80 et 443.
- Mettez à jour la définition des certificats sur le serveur marchand et spécifiez le chemin d'accès au ca-bundle.crt s’il s'agit d'un serveur Windows. Le site suivant possède la dernière version de CURL et LIBCURL, incluant la dernière version du ca-bundle à jour : http://curl.haxx.se/
Je n’arrive pas à faire de transactions, mais tout semble fonctionner correctement du côté des scripts. Pourquoi?
Veuillez contacter l’équipe d’intégration afin de déterminer les causes possibles.
Intégration
Lorsque le paiement est effectué, j'obtiens un message d'erreur et je suis redirigé vers ma page d'erreur. Pourquoi?
-Vérifier que votre fichier de réponse transmet l'acceptation de la transaction dans les délais et ce, conformément à l'échange XML requise, sinon vous pourriez obtenir une erreur de type WE12 ( Erreur de sauvegarde du fichier sur le serveur marchand) et une transaction approuvée serait alors renversée.
-Assurez-vous que votre fichier de réponse existe sur votre serveur, qu'il soit disponible et accessible à l'adresse URL définie et que les droits d'accès serveur à celui-ci soient correctement configurés.
Note: Votre serveur ne doit pas faire partie d'un réseau de développement en vase clos, il doit être accessible de l'externe via le port 80 ou 443, aucune redirection de ports n'est permise.
Des serveurs de test sont-ils disponibles?
Oui. L’adresse du serveur de test vous sera fournie lorsque la demande d’ouverture de compte sera acceptée.
Quelles sont les meilleures pratiques pour intégrer les Solutions de paiement par Internet de Desjardins?
- Desjardins recommande fortement à l’intégrateur de créer deux variables facilement modifiables pour la clé marchande ainsi que pour l’adresse URL où vous devrez communiquer pour envoyer vos requêtes de paiement. Comme ces deux variables seront modifiées lors de votre passage à l’environnement de production, il est important de les créer de façon à pouvoir les changer facilement.
- L’intégrateur devra concevoir et intégrer une gestion des erreurs possibles lorsqu’un problème survient au moment du paiement. En d’autres termes, vous devrez mettre en place un processus de gestion des erreurs liées à la logique d’affaires et aux erreurs possibles générées par votre panier d’achat.
- Desjardins recommande fortement d’inscrire le résultat de la transaction à l’intérieur d’une base de données, de façon à ce que votre application Web dispose d’un historique de vos transactions.
- Desjardins recommande d’inscrire le statut final de votre transaction dans votre base de données seulement lors de la réception de la dernière réponse provenant du serveur de Desjardins (étape 7 pour une solution avec redirection ou étape 8 pour une solution sans redirection). Si vous inscrivez le résultat de la transaction lors de la réception de la première réponse de Desjardins (étape 4 pour une solution sans redirection ou étape 5 pour une solution avec redirection), et que le serveur de paiement Desjardins ne reçoit pas votre accusé de réception, celui-ci renversera la transaction.
- Desjardins recommande de valider vos transactions acceptées via votre module d’administration en ligne. Vous recevrez une formation sur ce module lors de votre passage en production. Ce module permet aux marchands de générer des rapports, d’effectuer des transactions et de faire des recherches afin de retrouver des transactions.
- Desjardins suggère d’offrir aux clients internautes la possibilité de soumettre à nouveau une transaction non complétée, et ce, via un lien ou un bouton disponible à partir de la page affichant le relevé de transaction.
J’ai perdu ma clé marchande ou bien elle ne semble plus fonctionner. Que dois-je faire?
Contactez l’équipe d’intégration qui vous fournira une clé marchande valide ou une nouvelle clé s’il s’avère que la première a été corrompue.
Quelles cartes puis-je utiliser pour effectuer des transactions dans l’environnement de test?
Une liste contenant des numéros de cartes de test vous sera fournie par l’équipe d’intégration au début de votre intégration.
Dois-je ressaisir le numéro de la carte de crédit lorsque je souhaite annuler ou conclure une préautorisation ou effectuer un remboursement?
Il est possible d’annuler ou de conclure une préautorisation pendant sept jours à l’aide du mode automatisé via Internet, et ce, sans ressaisir le numéro de la carte de crédit. En utilisant le script de remboursement, il est possible durant la période de remboursement (configurable à 30, 60 ou 90 jours) d'effectuer un remboursement sans ressaisir le numéro de carte de crédit.
Pourquoi est-ce que j’obtiens toujours une erreur reliée à l’identifiant de transaction?
Assurez-vous d’incrémenter (dans le cas d'un numéro séquentiel) ou de mettre à jour correctement la valeur du champ Trx_id pour chaque nouvelle transaction afin de s'assurer de son unicité. Il est recommandé de ne pas utiliser de caractères spéciaux dans la structure des Trx_id.
L'erreur commune provient de l'utilisation du trait d'union dans le Trx_id, ce qui génère une erreur de type WX03. Il est cependant possible d’utiliser la barre de soulignement « _ ». Ex. : Trx_01.
Il y a une erreur de validation XML lors de la validation du montant. Que dois-je faire?
On ne doit pas inclure de "," ou de "." à l'intérieur de la balise montant.
J’éprouve un problème de format du trx_id ou encore d’un trx_id déjà utilisé. Pourquoi les erreurs de type « WX03 » sont-elles fréquentes?
Il est recommandé, aux intégrateurs, de ne pas utiliser de caractères spéciaux dans la structure des trx_id. L'erreur commune provient de l'utilisation de traits d'union dans le trx_id, ce qui génère une erreur de type WX03
Seule la barre de soulignement devrait être utilisée : "_".
J’éprouve des difficultés lorsque je tente de passer des paramètres dans les URL success, error et cancel. Que dois-je faire?
La solution de paiement par Internet de Desjardins permet de passer un seul paramètre par URL qui doit être retourné à Desjardins. Un seul paramètre alphanumérique contenant un maximum de 32 octets peut être fourni aux adresses URL; "response", "success", "cancel" et "error".Si vous désirez garder la trace de votre session, nous suggérons l’utilisation de la balise trx_id comme identifiant au lieu de tenter de passer votre identificateur de session à travers l’URL.
Au début de la transaction, j’obtiens un code d’erreur. Que dois-je faire?
Assurez-vous d’incrémenter (dans le cas d'un numéro séquentiel) ou de mettre à jour correctement la valeur du champ TRX_ID pour chaque nouvelle transaction. Assurez-vous également de ne pas utiliser de caractères spéciaux.
J’éprouve des difficultés avec mon script, ce qui cause des « Timeouts » ou des erreurs de validation XML. Que dois-je faire?
- Assurez-vous de bien incrémenter la valeur du TRX_ID à chaque transaction. Un timeout se produit généralement quand un problème de connexion ou de validation du script survient et que le délai de communication avec le serveur dépasse 25 secondes
- Validez que votre script ne possède pas d'erreur dans les balises et que toutes les balises sont bien fermées. Note : L’ordre des attributs du XML a de l’importance.
- Effectuez une vérification au niveau du CDATA pour vous assurer qu'il y a au moins un caractère dans le CDATA de details et details_text.
- Assurez-vous que vous avez encodé les caractères spéciaux inclus à l’intérieur de vos scripts. Exemple : é = é
- Dans le formatage de la balise details_text, l'utilisation des <br> est permise mais seulement en majuscules : <BR>.
Je peux me connecter à votre environnement mais la transaction disparaît ou cesse lors de la transmission de la description de la commande. Que se passe-t-il?
Assurez-vous de ne pas faire de requêtes SQL ou de traitements de programmation inutiles dans le chemin critique de la transaction.
Je ne suis pas capable d’initier une communication avec le serveur Desjardins. Que dois-je faire?
Vous devez mettre à jour la définition du ca-bundle sur votre serveur.
Le site suivant possède la dernière version de CURL et LIBCURL, incluant la dernière version du ca-bundle à jour : http://curl.haxx.se/
Normes et politiques
Un certificat SSL est-il absolument nécessaire pour le site du marchand?
Lorsqu'il s'agit d'une solution avec redirection, le marchand n'est pas obligé d'avoir un certificat SSL installé sur son serveur pour initier la communication sécurisée. Sa définition des certificats reconnus devra toutefois être à jour sur son serveur (ca-bundle.crt). À noter : Dans le cas d’une personnalisation avec un gabarit de la page de paiement, le fait de ne pas installer de certificat SSL sur le serveur aura comme effet d’ouvrir une fenêtre mentionnant à l’internaute qu’il sera redirigé vers un site non sécurisé au moment de la redirection du serveur de paiement Desjardins vers le site du marchand.
Dans le cadre de la solution sans redirection, il est impératif de posséder un certificat SSL.
De plus, veuillez noter que les bonnes pratiques du Web mentionnent aux usagers de ne pas insérer de données personnelles sur un site qui n’est pas sécurisé. Il faut donc prévoir un plus haut taux d’abandon de transactions pour un site qui ne possède pas de certificat SSL.
Quelle méthode dois-je utiliser pour faire savoir aux acheteurs que le paiement est possible via les Solutions de paiement par Internet de Desjardins?
Le logo « Paiement sécurisé Desjardins » doit être placé en évidence sur le site du marchand.
Quelles normes dois-je respecter pour l’affichage du reçu?
Veuillez consulter l’exemple du relevé de transaction inclus dans le Guide de certification.
