Guide de référence de l API pour les Services Web

Guide de référence de l API pour les Services Web juillet 2014 Version 1.0

Le présent manuel et le support électronique qui l accompagne sont des produits exclusifs de Paiements Optimal, S.A.R.L. Leur usage est réservé aux utilisateurs autorisés du produit. 1999 2014 Paiements Optimal, S.A.R.L. Tous droits réservés. Les renseignements que contient le présent document sont susceptibles d être modifiés sans préavis. Le logiciel décrit dans le présent document est fourni sous licence et ne peut être utilisé ou copié que conformément aux conditions du contrat de licence. Aucune partie du présent manuel ne peut être reproduite ni transférée sous quelque forme que ce soit ou par quelque moyen que ce soit sans le consentement écrit explicite de Paiements Optimal, S.A.R.L. Les autres noms, marques de commerce, et marques déposées appartiennent à leur propriétaire respectif. Paiements Optimal, S.A.R.L. n offre aucune garantie explicite ou implicite concernant ce produit, sa qualité marchande, ou son adéquation à un usage particulier autre que les garanties explicitement décrites dans le contrat de licence du produit. Pour obtenir de plus amples renseignements à ce sujet, veuillez communiquer avec Paiements Optimal, S.A.R.L. Siège social international 3500, boulevard de Maisonneuve Ouest, bureau 700 Montréal (Québec) H3Z 3C1 Canada Tél. : (514) 380-2700 Téléc. : (514) 380-2760 Courriel : info@optimalpayments.com Soutien technique : support@optimalpayments.com Site Web : www.optimalpayments.com Bureau du Royaume-Uni Compass House, Vision Park Chivers Way, Histon Cambridge CB24 9AD Royaume-Uni Courriel : info@netbanx.com Soutien technique : support@netbanx.com Site Web : www.netbanx.com Bureau des États-Unis 1209 Orange Street Wilmington, DE 19801 Bureau de Gatineau 75, Promenade du Portage Gatineau (Québec) J8X 2J9 Canada

Table des matières 1 Services Web de NETBANX Que sont les Services Web de NETBANX?................................................ 1-1 Les Services Web sont compatibles avec les prélèvements automatiques..................... 1-1 Les Services Web sont compatibles avec les cartes de crédit.............................. 1-2 Les Services Web sont compatibles avec le service de consultation des données............... 1-3 Exigences système.................................................................. 1-3 Accéder aux WSDL et aux liens NETBANX................................................ 1-4 Prélèvement automatique........................................................ 1-4 Carte de crédit................................................................ 1-4 Service de consultation des données................................................ 1-4 Tests des Services Web de NETBANX.................................................... 1-5 Caractéristiques de sécurité........................................................... 1-5 AVS........................................................................ 1-5 CVD........................................................................ 1-6 Base de données des éléments négatifs.............................................. 1-7 3D Secure................................................................... 1-7 Utilisation du présent guide........................................................... 1-7 Cible....................................................................... 1-7 Fonctionnalités................................................................ 1-7 Symboles.................................................................... 1-7 2 Transactions par prélèvement automatique (débit direct) Introduction....................................................................... 2-1 Exemple.NET.................................................................... 2-2 Bâtir des requêtes de facturation, de vérification ou de crédit.................................. 2-4 Exemple de facturation C#..................................................... 2-4 Diagramme de transaction ddcheckrequestv1........................................ 2-6 Éléments de transaction ddcheckrequestv1.......................................... 2-7 Considérations spéciales relatives aux éléments de prélèvement automatique............. 2-13 Création de requêtes updateshippinginfo................................................. 2-14 Exemple de transaction updateshippinginfo C#...................................... 2-14 Diagramme de transaction ddshippingrequestv1...................................... 2-16 Éléments de transaction ddshippingrequestv1........................................ 2-17 Création de lookuprequest (requêtes de consultation)....................................... 2-18 Exemple de transaction lookuprequest C#......................................... 2-18 Diagramme de transaction ddlookuprequestv1....................................... 2-20 Éléments de transaction ddlookuprequestv1......................................... 2-20 Création de mandaterequest pour BACS (requêtes de mandat)................................ 2-22 Guide de référence de l API pour les Services Web 1.0 III

juillet 2014 Création de mandaterequest pour SEPA (requêtes de mandat)............................ 2-23 Exemple de transaction mandaterequest C#........................................ 2-23 Diagramme de transaction ddmandaterequestv1...................................... 2-25 Éléments de transaction ddmandaterequestv1........................................ 2-26 Création de changestatusrequest (requêtes de modification d état)............................. 2-29 Exemple de transaction changestatusrequest C#.................................... 2-30 Diagramme de transaction ddchangestatusrequest.................................... 2-31 Éléments de transaction ddchangestatusrequestv1.................................... 2-31 Création de updatemandaterequest (mise à jour du mandat).................................. 2-32 Exemple de transaction updatemandaterequest C#.................................. 2-33 Diagramme de transaction ddupdatemandaterequestv1................................ 2-33 Éléments de transaction ddupdatemandaterequestv1.................................. 2-34 Traitement de la réponse............................................................. 2-35 3 Transactions par carte de crédit ou de débit Introduction....................................................................... 3-1.Exemple.NET.................................................................... 3-3 Bâtir des requêtes d achat, d autorisation ou de vérification................................... 3-5 Exemple de transaction d achat C#............................................... 3-5 Diagramme de transaction ccauthrequestv1......................................... 3-7 Éléments de transaction ccauthrequestv1........................................... 3-8 Paires étiquette/valeur addendumdata.............................................. 3-17 Bâtir des requêtes d inversion d autorisation............................................... 3-19 Exemple d une transaction d inversion d autorisation C#............................... 3-19 Diagramme de transaction ccauthreversalrequestv1................................... 3-20 Éléments de transaction ccauthreversalrequestv1..................................... 3-20 Bâtir des requêtes de règlement et de crédit............................................... 3-21 Exemple de règlement C#...................................................... 3-22 Diagramme de transaction ccpostauthrequestv1...................................... 3-23 Éléments de transaction ccpostauthrequestv1........................................ 3-24 Bâtir des requêtes de données mémorisées................................................ 3-26 Exemple d autorisation à partir de données mémorisées C#............................ 3-26 Diagramme de transaction ccstoreddatarequestv1.................................... 3-28 Éléments de transaction ccstoreddatarequestv1...................................... 3-28 Bâtir des requêtes d annulation........................................................ 3-30 Exemple d annulation de règlement C#............................................ 3-30 Diagramme de transaction cccancelrequestv1....................................... 3-32 Éléments de transaction cccancelrequestv1.......................................... 3-33 Bâtir des requêtes de paiement/crédit indépendant......................................... 3-34 Exemple de paiement C#...................................................... 3-34 Diagramme de transaction ccpaymentrequestv1...................................... 3-35 Éléments de transaction ccpaymentrequestv1........................................ 3-36 Bâtir des requêtes de consultation des données............................................ 3-39 Exemple de consultation des données C#.......................................... 3-40 Diagramme de transaction cctxnlookuprequestv1.................................... 3-41 IV

juillet 2014 Éléments de transaction cctxnlookuprequestv1...................................... 3-41 Bâtir des requêtes de consultation d inscription............................................ 3-43 Exemple de consultation d inscription C#.......................................... 3-43 Diagramme de transaction ccenrollmentlookuprequestv1............................... 3-45 Éléments de transaction ccenrollmentlookuprequestv1................................. 3-45 Bâtir des requêtes d authentification..................................................... 3-47 Exemple d authentification C#.................................................. 3-47 Diagramme de transaction ccauthenticaterequestv1................................... 3-48 Éléments de transaction ccauthenticaterequestv1..................................... 3-48 Traitement de la réponse............................................................. 3-50 Paires étiquette/valeur detail...................................................... 3-57 Paires étiquette/valeur pour addendumresponse...................................... 3-58 Codes de devises.............................................................. 3-58 4 Transactions du service de consultation des données Introduction....................................................................... 4-1 WSDL et liens ILS NETBANX..................................................... 4-1 Exemple.NET..................................................................... 4-2 Bâtir des requêtes ILS................................................................ 4-3 ILS C#..................................................................... 4-3 Diagramme de transaction ilslookuprequestv1....................................... 4-5 Éléments de transaction ilslookuprequestv1s........................................ 4-6 Traitement de la réponse............................................................. 4-8 Diagramme de transaction ilslookupresponsev1...................................... 4-10 Contenu de l élément de réponse.................................................. 4-13 Détails dans la réponse aux requêtes d autorisation................................. 4-13 Détails dans la réponse aux requêtes de règlement................................. 4-14 Détails dans la réponse aux requêtes de crédit..................................... 4-14 Détails dans la réponse aux requêtes de rétrofacturation............................. 4-15 Détails dans la réponse aux requêtes de prélèvement automatique (débit direct)........... 4-16 Codes de motif..................................................................... 4-17 Codes de motifs de rétrofacturation................................................ 4-17 Codes de motif de requête de récupération.......................................... 4-19 Codes de motifs de rétrofacturation et de requête de récupération pour Discover............. 4-19 A Utilisation de la méthode HTTP Post Introduction....................................................................... A-1 Requêtes relatives à un prélèvement automatique.......................................... A-1 facturation/vérification/crédit..................................................... A-1 Exemple HTML Facturation.................................................. A-2 updateshippinginfo............................................................ A-4 Exemple HTML updateshippinginfo........................................... A-4 ddlookuprequest............................................................. A-5 Exemple HTML lookuprequest............................................... A-6 Guide de référence de l API pour les Services Web 1.0 V

juillet 2014 ddmandaterequest............................................................ A-7 Exemple HTML mandaterequest............................................. A-8 changestatusrequest........................................................... A-9 Exemple HTML changestatusrequest.......................................... A-10 updatemandaterequest......................................................... A-10 Exemple HTML updatemandaterequest........................................ A-11 Requêtes relatives à une carte de crédit.................................................. A-12 Achat, autorisation et vérification.................................................. A-12 Exemple HTML Autorisation................................................. A-13 Inversion d autorisation......................................................... A-15 Exemple HTML Inversion d autorisation........................................ A-16 Règlement et crédit............................................................ A-16 Exemple HTML Règlement.................................................. A-17 Autorisation ou achat à partir de données mémorisées.................................. A-18 Exemple HTML Autorisation à partir de données mémorisées........................ A-19 Annuler un règlement, un crédit, un paiement, ou un crédit indépendant................... A-20 Exemple HTML Annuler.................................................... A-20 Requête de paiement........................................................... A-21 Exemple HTML Paiement................................................... A-22 Consultation des données........................................................ A-23 Exemple HTML Consultation des données...................................... A-24 Consultation d inscription........................................................ A-25 Exemple HTML Consultation d inscription....................................... A-26 Authentification............................................................... A-27 Exemple HTML Authentification.............................................. A-28 Requêtes relatives au service de consultation des données.................................... A-28 Exemple HTML ILS........................................................... A-29 HTTP Post Exemples............................................................... A-30 HTTP Post Réponses aux requêtes................................................ A-31 B Codes de réponse Aperçu........................................................................... B-1 Codes de réponse.............................................................. B-1 Codes d action................................................................ B-21 Codes de refus................................................................ B-21 C Codes géographiques Codes de province................................................................. C-1 Codes d état....................................................................... C-2 Codes de pays..................................................................... C-3 VI

CHAPITRE 1 Services Web de NETBANX Que sont les Services Web de NETBANX? Les Services Web reposent sur une technologie permettant aux applications de communiquer entre elles d une manière indépendante des plateformes et des langages de programmation. Un Service Web est une interface de logiciel qui décrit une collection d opérations auxquelles on peut accéder sur le réseau à l aide de messages XML uniformisés. Il utilise des protocoles écrits en langage XML pour décrire une opération à exécuter ou des données à échanger avec un autre Service Web. Les Services Web sont bâtis selon des normes ouvertes comme SOAP et WSDL. Les Services Web de NETBANX offrent les avantages suivants : Les marchands peuvent s intégrer facilement à l API des Services Web, en se servant de leur plateforme et de leur langage préférés. Les marchands peuvent automatiser les opérations afin d éviter de saisir les renseignements manuellement à l aide de la page Web de NETBANX. Les marchands peuvent fonctionner indépendamment des modifications et des mises à jour faites sur le site Web de NETBANX. Les Services Web sont compatibles avec les prélèvements automatiques NETBANX prend actuellement en charge les Services Web suivants en ce qui concerne les prélèvements automatiques : Tableau 1-1 : Opérations de prélèvement automatique Opération verify (vérification) charge (facturation) credit (crédit) updateshippinginfo lookuprequest mandaterequest changestatusrequest Description Vous permet de confirmer que le compte bancaire d un client est en règle, sans toutefois retirer de l argent du compte. Vous permet de transférer des fonds du compte bancaire d un client vers votre compte de marchand. Cette transaction se fait en temps réel, bien que le réseau bancaire ne transfère les fonds que trois à cinq jours plus tard. Vous permet de transférer des fonds de votre compte de marchand directement au compte bancaire du client. Cette transaction se fait en temps réel, bien que le réseau bancaire ne transfère les fonds que trois à cinq jours plus tard. Vous permet de transmettre l information d expédition, y compris le numéro de suivi, lorsque vous avez expédié la marchandise pour laquelle vous avez déjà traité une transaction de facturation. Vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les transactions de charge et de credit par prélèvement automatique qui sont traitées par votre compte de marchand. Vous permet de créer un mandat pour le compte bancaire d un client et de le déposer à sa banque, afin que vous puissiez transférer des fonds du compte bancaire du client vers votre compte commercial. Le réseau bancaire traite généralement le mandat en cinq jours. Vous permet de changer l état d une transaction de facturation, de crédit ou de mandat. Guide de référence de l API pour les Services Web 1.0 1-1

Services Web de NETBANX juillet 2014 Tableau 1-1 : Opérations de prélèvement automatique (suite) Opération updatemandaterequest Description Vous permet de mettre à jour les informations contenues dans un mandat existant. La disponibilité des types d opérations par prélèvement automatique est attribuée aux marchands sur une base individuelle, puisque ce ne sont pas toutes les banques des marchands qui acceptent toutes les opérations. Si vous avez des questions, communiquez avec votre gestionnaire de compte. Les Services Web sont compatibles avec les cartes de crédit NETBANX prend actuellement en charge les Services Web suivants pour les cartes de crédit : Tableau 1-2 : Opérations par carte de crédit Opération Authorization (autorisation) Purchase (achat) Verification (vérification) Authorization Reversal (inversion d autorisation) Credit (crédit) Settlement (règlement) Stored Data Authorization (autorisation à partir de données mémorisées) Stored Data Purchase (achat à partir de données mémorisées) Cancel (annulation) Payment (paiement) Independent Credit (crédit indépendant) Description Vous permet de confirmer qu une carte de crédit existe et que les fonds sont suffisants pour couvrir un achat, sans toutefois régler les fonds dans votre compte de marchand. Autorise et règle un montant demandé sur une carte de crédit. Vous permet d exécuter une vérification AVS ou CVD de la carte de crédit, sans imputer un montant sur cette carte. Vous permet d inverser une partie ou la totalité d une autorisation existante, pourvu qu aucun règlement (complet ou partiel) n ait été traité à l'égard de cette autorisation. Ce type de transaction ne fonctionne pas pour les transactions d'achat ; cette transaction n est utilisée que pour les autorisations. Vous permet d émettre un crédit pour un montant qui a déjà été réglé. Vous permet de régler le montant d une autorisation existante, en créditant le montant autorisé de la carte de crédit à votre compte de marchand. Vous permet d autoriser un montant sur la carte de crédit d un client à l aide des données sur le client qui sont mémorisées dans notre base de données. Vous n avez qu à fournir le minimum de renseignements, ce qui vous permet de gagner du temps et de réduire les efforts. Vous permet d autoriser et de régler un montant sur la carte de crédit d un client à l aide de données sur le client qui sont mémorisées dans notre base de données. Vous n avez qu à fournir le minimum de renseignements, ce qui vous permet de gagner du temps et de réduire les efforts. Vous permet d annuler une transaction de crédit, de règlement, de paiement, ou de crédit indépendant. Vous pouvez annuler une de ces transactions pourvu qu elle soit En attente, ce qui est habituellement le cas avant minuit le jour où la requête est faite. Dans certains cas, vous pouvez trouver des transactions de crédit plus anciennes En attente. Vous permet de créditer un montant sur la carte de crédit d un client. La transaction de paiement n est pas liée à une autorisation existante antérieure ; le montant de la transaction n est donc pas limité de cette manière. Vous permet de créditer un montant sur la carte de crédit d un client. La transaction de crédit indépendant n est pas liée à une autorisation existante antérieure ; le montant de la transaction n est donc pas limité de cette manière. 1-2

juillet 2014 Les Services Web sont compatibles avec le service de consultation des données Tableau 1-2 : Opérations par carte de crédit Opération Information Lookup (consultation des données) Enrollment Lookup (consultation d inscription) Authentication (authentification) Description Vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les transactions traités par un compte de marchand. Vous permet d établir si la carte de crédit du client est inscrite à notre programme 3D Secure. Vous permet d envoyer une requête d authentification afin qu un titulaire de carte inscrit au programme 3D Secure puisse authentifier sa carte auprès de l émetteur de la carte avant que vous traitiez une autorisation. La disponibilité des types d opérations pour les cartes de crédit est attribuée aux marchands sur une base individuelle, puisque ce ne sont pas toutes les banques des marchands qui acceptent toutes les opérations. Si vous avez des questions, communiquez avec votre gestionnaire de compte. Les Services Web sont compatibles avec le service de consultation des données NETBANX prend actuellement en charge les Services Web suivants : Tableau 1-3 : Opération du service de consultation des données Opération Information Lookup Service (service de consultation des données) Description Vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les autorisations, les règlements, les crédits et les rétrofacturations traités par un compte de marchand. Exigences système L API de SOAP a été testé dans les environnements clients suivants : Tableau 1-4 : Environnements clients Client SOAP Microsoft.NET 1.1 et 2.0 Framework Apache Axis 1.4 Environnement de programmation Microsoft Visual Studio.NET 2003 Java (J2SE 1.4.X et versions plus récentes) Environnement opérationnel Microsoft Windows Server 2003 et Windows XP Linux et Microsoft Windows XP, Server 2003 Apache Axis 2.0 Java (J2SE 1.4.X et 1.5.X) Linux et Microsoft Windows XP, Server 2003 Pour obtenir plus de détails : J2SE ou J2EE 1.3.1 ou version plus récente (1.4.X recommandée) Sun Microsystems, Inc. http://java.sun.com/downloads/index.html Guide de référence de l API pour les Services Web 1.0 1-3

Services Web de NETBANX juillet 2014 Apache Axis 1.4, The Apache Software Foundation http://www.apache.org/dyn/closer.cgi/ws/axis/1_4 Apache Axis2, 1.2, The Apache Software Foundation http://ws.apache.org/axis2/1_2/contents.html Microsoft.NET Framework Version 1.1/2.0 Microsoft Corporation http://www.microsoft.com/net Peu importe le client SOAP que vous choisissez, il doit prendre en charge la messagerie de style documents. Accéder aux WSDL et aux liens NETBANX Prélèvement automatique WSDL : https://webservices.optimalpayments.com/directdebitws/directdebitservice/v1?wsdl Service Web : https://webservices.optimalpayments.com/directdebitws/directdebitservice/v1 Publication HTTP : https://webservices.optimalpayments.com/directdebitws/directdebitservlet/v1 Carte de crédit WSDL : https://webservices.optimalpayments.com/creditcardws/creditcardservice/v1?wsdl Service Web : https://webservices.optimalpayments.com/creditcardws/creditcardservice/v1 Publication HTTP : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Service de consultation des données WSDL : https://webservices.optimalpayments.com/ilsws/ilsservice/v1?wsdl Service Web : https://webservices.optimalpayments.com/ilsws/ilsservice/v1 Publication HTTP : https://webservices.optimalpayments.com/ilsws/ilsservlet/v1 1-4

juillet 2014 Tests des Services Web de NETBANX Tests des Services Web de NETBANX Après avoir terminé la configuration de votre application orientée Services Web, veuillez communiquer avec notre équipe de soutien technique pour obtenir des instructions relatives au test des appels API. Courriel : support@optimalpayments.com Téléphone : 1 888 709-8753 Caractéristiques de sécurité Dans le cas de certaines transactions (achat, par exemple), NETBANX offre des caractéristiques supplémentaires qui permettent au marchand de se prémunir contre l utilisation frauduleuse des cartes. Système de vérification d adresse (AVS) Données de validation des cartes (CVD) Base de données des éléments négatifs 3D Secure AVS NETBANX gère les vérifications d adresse (AVS) lorsque la banque émettrice prend cette caractéristique en charge. Le système AVS vérifie si l adresse fournie par le client qui se sert d une carte correspond à l adresse de facturation associée à cette carte par la banque émettrice. Il est plus difficile de se servir d une carte de manière frauduleuse puisque pour se servir d une carte volée, il faut aussi connaître l adresse de facturation associée à la carte. En outre, si les marchandises doivent être livrées, le marchand peut exiger qu elles le soient à l adresse de facturation associée à la carte. NETBANX configure chaque mode de paiement avec un ensemble acceptable de codes de retour AVS. Si la banque retourne un code qui n est pas acceptable compte tenu du mode de paiement, la requête est alors rejetée en renvoyant une erreur Échec d autorisation. Lorsqu une erreur Échec d autorisation est retournée en réponse à une requête de transaction et qu un numéro d autorisation est inclus dans la réponse, l échec a été causé par la vérification AVS. Vous pouvez consulter le code AVS retourné pour établir le motif exact pour lequel la vérification AVS a échoué. NETBANX retourne les codes suivants, dans l élément avsresponse, à l application du marchand en réponse à la requête de transaction ; les codes A, N et E indiquent un échec AVS : Tableau 1-5 : Codes AVS Lettre du code A B E M N Q Explication L adresse correspond, mais le code Zip ne correspond pas. La vérification AVS n a pas été faite pour la transaction internationale. Le format du code postal est invalide ou l'information relative à l'adresse n'a pas été fournie. Le système AVS ne prend pas cette industrie en charge. Correspondance de l adresse et du code postal pour les transactions internationales. Aucun élément de l adresse ne correspond. Réponse inconnue de l'émetteur/banknet switch. Guide de référence de l API pour les Services Web 1.0 1-5

Services Web de NETBANX juillet 2014 Tableau 1-5 : Codes AVS (suite) Lettre du code R S U W X Y Z Explication Réessayer. Le système est incapable de faire le traitement. L AVS n est pas pris en charge. L information sur l adresse n est pas disponible. Le code Zip de neuf chiffres correspond, mais l adresse ne correspond pas. Exact. Correspondance entre le code Zip de neuf chiffres et l adresse. Oui. Correspondance entre le code Zip de cinq chiffres et l adresse. Le code Zip de cinq chiffres correspond, mais l adresse ne correspond pas. Lorsque vous vous êtes inscrit à NETBANX, votre compte a été configuré pour faire des vérifications AVS automatiques. NETBANX n accepte les transactions que si les codes de retour AVS permis sont retournés. Il existe trois exceptions AVS, ce qui peut avoir un effet sur les décisions que vous prenez à l égard des vérifications AVS ayant échoué : Le système AVS n est pas toujours fiable. De faux résultats peuvent être retournés si la personne a déménagé, par exemple, ou parce que certaines personnes inscrivent des codes Zip à cinq chiffres tandis que d autres inscrivent des codes Zip à neuf chiffres. Le système AVS offre une prise en charge internationale limitée. Par conséquent, si vous décidez de n expédier qu aux adresses qui retournent de bons résultats AVS, vous pourriez exclure par ailleurs des transactions valides. Plusieurs banques émettrices aux États-Unis, mais pas toutes, prennent AVS en charge. Par conséquent, même si vous ne faites des affaires qu avec des clients américains, vous ne pourrez pas toujours vous fier à la disponibilité du système AVS. CVD La valeur CVD est un nombre à trois ou quatre chiffres imprimé sur la carte de crédit, mais qui n apparaît pas sur la bande magnétique. Par conséquent, la valeur n est pas imprimée sur les reçus ou les états de compte, ce qui réduit la possibilité de fraude en se servant de l information imprimée. La caractéristique CVD, conçue précisément pour les transactions où une carte n est pas utilisée, est une exigence de NETBANX. Nous prenons en charge la caractéristique CVD partout où les banques émettrices le font. Lorsqu un client saisit les renseignements relatifs à sa carte et au titulaire de la carte, la valeur CVD est demandée en même temps. Un indicateur parmi les quatre indicateurs suivants signale l état d une requête CVD : Not provided (non fournie) Le client n a pas fourni la valeur CVD. Provided (fournie) Le client a fourni la valeur CVD. Lorsque cet indicateur est choisi, la valeur CVD est fournie. Illegible (illisible) Le client prétend que la valeur CVD est illisible. Not present (absent) Le client prétend que la valeur CVD n apparaît pas sur la carte. 1-6

juillet 2014 Base de données des éléments négatifs Base de données des éléments négatifs 3D Secure NETBANX gère une base de données des éléments négatifs qui offre une protection supplémentaire contre la mauvaise utilisation des cartes et les requêtes de transaction inappropriées. Le numéro de la carte ou l'adresse de courriel est entré dans la base de données des éléments négatifs pour les motifs suivants : Une rétrofacturation liée au numéro de la carte ou à l adresse de courriel a été faite. Le numéro de la carte, ou l adresse de courriel, a été utilisé, ou vraisemblablement utilisé, dans le contexte d une activité frauduleuse. Votre compte est configuré pour la mise en œuvre automatique de cette caractéristique de sécurité et toutes les requêtes de transactions où on tente de se servir du numéro de la carte ou de l'adresse de courriel se trouvant dans la base de données des éléments négatifs ne seront pas traitées. NETBANX prend en charge 3D Secure, un programme d authentification des titulaires de cartes en ligne conçu pour rendre les transactions d achat sur Internet plus sécuritaires par la confirmation de l identité du titulaire au moment de l achat et avant que le marchand soumette la demande d autorisation. Le programme est actuellement compatible avec plusieurs types de cartes, notamment Visa (Vérifié par Visa), MasterCard (SecureCode) et JCB (J/Secure). Les autorisations traitées au moyen de 3D Secure sont garanties contre la plupart des types de litiges courants relativement à la rétrofacturation. Utilisation du présent guide Cible Le présent guide d utilisation décrit les fonctions importantes du système. Chaque section contient un aperçu des fonctions, lesquelles sont ensuite détaillées par procédures et selon la marche à suivre. Ce guide d utilisation s adresse aux marchands de NETBANX faisant usage de notre API des Services Web afin de traiter des demandes de transactions avec NETBANX. Fonctionnalités Symboles Il se peut que ce guide présente l explication de certaines caractéristiques auxquelles vous n avez pas accès. L accès auxdites fonctionnalités est octroyé aux marchands sur une base individuelle. Si vous avez des questions, communiquez avec votre gestionnaire de compte. Ce guide d utilisation fait appel aux symboles suivants pour mettre en évidence certains éléments importants : Guide de référence de l API pour les Services Web 1.0 1-7

Services Web de NETBANX juillet 2014 Tableau 1-6 : Symboles Symbole Description Cette icône remarque précède une astuce ou un conseil pour l utilisation de l application de traitement des transactions de manière plus efficace. Cette icône attention précède un avertissement relatif aux actions pouvant entraîner des conséquences importantes. 1-8

CHAPITRE 2 Transactions par prélèvement automatique (débit direct) Introduction Ce chapitre décrit comment traiter les transactions de prélèvement automatique à l aide du Service Web de NETBANX. Les opérations suivantes sont prises en charge : Tableau 2-1 : Opérations prises en charge Opération Description Pour Type de requête verify (vérification) Vous permet de confirmer que le compte bancaire d un client est en règle, sans toutefois retirer de l argent du compte. EFT ACH charge (facturation) credit (crédit) Vous permet de transférer des fonds du compte bancaire d un client vers votre compte de marchand. Cette transaction se fait en temps réel, bien que le réseau bancaire ne transfère les fonds que trois à cinq jours plus tard. Vous permet de transférer des fonds de votre compte de marchand directement au compte bancaire du client. Cette transaction se fait en temps réel, bien que le réseau bancaire ne transfère les fonds que trois à cinq jours plus tard. EFT ACH BACS SEPA* EFT ACH BACS SEPA Consultez la rubrique Bâtir des requêtes de facturation, de vérification ou de crédit à la page 2-4. updateshippinginfo Vous permet de transmettre l information d expédition, y compris le numéro de suivi, lorsque vous avez expédié la marchandise pour laquelle vous avez déjà traité une transaction de facturation. EFT ACH SEPA Consultez la rubrique Création de requêtes updateshippinginfo à la page 2-14. lookuprequest Vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les transactions de charge et de credit par prélèvement automatique qui sont traitées par votre compte de marchand. EFT ACH BACS SEPA Consultez la rubrique Création de lookuprequest (requêtes de consultation) à la page 2-18. mandaterequest Vous permet de créer un mandat pour le compte bancaire d un client et de le déposer à sa banque, afin que vous puissiez transférer des fonds du compte bancaire du client vers votre compte commercial. Le réseau bancaire traite généralement le mandat en cinq jours. BACS SEPA Consultez la rubrique Création de mandaterequest pour BACS (requêtes de mandat) à la page 2-22. Guide de référence de l API pour les Services Web 1.0 2-1

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-1 : Opérations prises en charge Opération Description Pour Type de requête changestatusrequest Vous permet de changer l état d une transaction de facturation, de crédit ou de mandat. EFT ACH BACS SEPA Consultez la rubrique Création de changestatusrequest (requêtes de modification d état) à la page 2-29. updatemandaterequest Vous permet de mettre à jour les informations contenues dans un mandat existant. SEPA Consultez la rubrique Création de updatemandaterequest (mise à jour du mandat) à la page 2-32. *SEPA = espace unique de paiement en euros La disponibilité des types d opérations par prélèvement automatique est attribuée aux marchands sur une base individuelle, puisque ce ne sont pas toutes les banques des marchands qui acceptent toutes les opérations. Si vous avez des questions, communiquez avec votre gestionnaire de compte. Les transactions verify, charge et credit acceptent l objet de document ddcheckrequestv1. La transaction updateshippinginfo accepte l objet de document ddshippingrequestv1. La transaction lookup accepte l objet de document ddlookuprequestv1. La transaction mandat accepte l objet de document ddmandaterequestv1. La transaction changestatus accepte l objet de document ddchangestatusrequestv1. La transaction updatemandate accepte l objet de document ddupdatemandaterequestv1. Toutes les opérations retournent une réponse ddcheckresponsev1. Exemple.NET Pour bâtir l exemple pour.net : 1. Créez un nouveau projet. 2. Ajoutez une référence Web. 2-2

juillet 2014 Exemple.NET 3. Saisissez l URL WSDL et cliquez sur le bouton Ajouter une référence. Le client Web est maintenant créé. 4. Bâtissez la requête de prélèvement automatique et traitez la réponse. Consultez la rubrique Bâtir des requêtes de facturation, de vérification ou de crédit à la page 2-4. Consultez la rubrique Création de requêtes updateshippinginfo à la page 2-14. Guide de référence de l API pour les Services Web 1.0 2-3

Transactions par prélèvement automatique (débit direct) juillet 2014 Consultez la rubrique Traitement de la réponse à la page 2-35. Bâtir des requêtes de facturation, de vérification ou de crédit Les requêtes charge, verify et credit requièrent l objet de document ddcheckrequestv1. La présente rubrique décrit la structure d une requête ddcheckrequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 2-2 : Éléments de transaction ddcheckrequestv1 à la page 2-7. Exemple de facturation C# Voici un exemple de transaction charge en C#. Pour convertir cette requête en requête credit ou verify, il suffit de remplacer la valeur «charge» (soulignée ci-dessous) par «credit» ou «verify» respectivement. // Prepare the call to the Direct Debit Web Service DDCheckRequestV1 ddcheckrequest = new DDCheckRequestV1(); ddcheckrequest.amount = "10.00"; MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ddcheckrequest.merchantaccount = merchantaccount; CheckV1 check = new CheckV1(); check.routingnum = "123456789"; check.accountnum = "987654321"; check.accounttype = BankAccountTypeV1.PC; check.bankname = "Chase"; check.checknum = 12; check.payee = "ACME Inc."; ddcheckrequest.check = check; BillingDetailsV1 billingdetails = new BillingDetailsV1(); billingdetails.firstname = "Jane"; billingdetails.lastname = "Jones"; billingdetails.street = "123 Main Street"; billingdetails.city = "LA"; billingdetails.country = CountryV1.US; billingdetails.zip = "90210"; billingdetails.phone = "555-555-5555"; billingdetails.checkpaymethod = CheckPayMethodV1.WEB; ddcheckrequest.billingdetails = billingdetails; //Perform the Web Services call to process the charge DirectDebitServiceV1 ddservice = new DirectDebitServiceV1(); DDCheckResponseV1 ddtxnresponse = ddservice.charge(ddcheckrequest); // Print out the result String responsetxt = ddtxnresponse.code + " - " + ddtxnresponse.decision + " - " + ddtxnresponse.description; responsetxt += "Details:" + Environment.NewLine; if (ddtxnresponse.detail!= null) { for (int i = 0; i < ddtxnresponse.detail.length; i++) { 2-4

juillet 2014 Exemple de facturation C# responsetxt += " - " + ddtxnresponse.detail[i].tag + " - " + ddtxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ddTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + ddtxnresponse.decision); } Guide de référence de l API pour les Services Web 1.0 2-5

Transactions par prélèvement automatique (débit direct) juillet 2014 Diagramme de transaction ddcheckrequestv1 L objet de document ddcheckrequestv1 respecte la structure suivante : 2-6

juillet 2014 Éléments de transaction ddcheckrequestv1 Éléments de transaction ddcheckrequestv1 Ce type de requête est utilisé dans le cadre de divers plans de prélèvements automatiques. Consultez le Tableau 2-3 : Exigences supplémentaires pour les éléments de prélèvement automatique à la page 2-13 pour en savoir plus sur les différents éléments requis. L objet de document ddcheckrequestv1 peut contenir les éléments suivants : Tableau 2-2 : Éléments de transaction ddcheckrequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 merchantrefnum Conditionnel Chaîne Max = 255 amount Oui Chaîne Max = 999999999.99 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Il s agit du montant de la requête de transaction. check accounttype Oui Énumération Il s agit du type de compte chèque utilisé pour la transaction. Les valeurs possibles sont : PC (Compte chèque personnel) PS (Compte épargne personnel) PL (Compte prêt personnel) BC (Compte chèque commercial) BS (Compte épargne commercial) BL (Compte prêt commercial) bankname Oui Chaîne Max = 40 checknum Oui Long Max = 8 accountnum Oui Chaîne Max = 17 Si IBAN, Max = 32 Il s agit du nom de la banque du client, là où cette transaction est publiée. Il s agit du numéro de série du chèque fourni au moment de la requête de transaction. REMARQUE : L élément checknum est requis pour l opération verify où il sert de numéro d identification unique de la transaction même si aucune somme n est transférée entre les comptes durant cette opération. Il s agit du numéro du compte bancaire du client. Pour les transactions SEPA, il s agit du numéro IBAN (numéro de compte bancaire international) du client. Guide de référence de l API pour les Services Web 1.0 2-7

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-2 : Éléments de transaction ddcheckrequestv1 (suite) Élément Élément enfant Requis Type Description routingnum Oui Chaîne Min = 6 Max = 9 Si BIC, Min = 8 Max = 11 payee Conditionnel Chaîne Max = 81 Pour les comptes en dollars américains, il s agit du numéro d acheminement à neuf chiffres de la banque du client. Pour les comptes en livres anglaises, il s agit du code de tri à six chiffres de la banque du client. Pour les comptes en dollars canadiens, ce numéro est composé de l'id de l'institution à trois chiffres suivi du numéro de transit à cinq chiffres de la succursale bancaire du client. Ils doivent être saisis dans cet ordre. N insérez pas d espaces ou de tirets. Pour les transactions SEPA, il s agit du code BIC (code identificateur de banque) du compte bancaire du client. Il s agit du descripteur qui apparaîtra sur le relevé bancaire du client. Il n est requis que pour les transactions credit et verify. Si vous entrez une valeur pour ce champ, celleci servira de descripteur sur le relevé. Si vous n entrez pas une valeur pour ce champ, une valeur par défaut, configurée pour le compte de marchand, servira de descripteur sur le relevé. bankcountry Conditionnel Énumération Il s agit du pays dans lequel la banque est située. Consultez la rubrique Codes de pays à la page C-3 pour connaître les bons codes à utiliser. Cet élément n est requis que pour certains pays. bankcity Conditionnel Chaîne Max = 40 mandatereference Conditionnel Chaîne Max = 10 Pour SEPA, Max = 35 Il s agit de la ville dans laquelle la banque est située. Cet élément n est requis que pour certains pays. Ceci est la référence du mandat permettant de porter les frais au compte bancaire. Cette valeur est retournée pour le paramètre mandatereference en réponse à la ddmandaterequestv1. Pour SEPA cet élément est requis. billingdetails checkpaymethod Oui Énumération Il s agit du type de paiement. Les valeurs possibles sont : WEB (compte chèque personnel seulement) TEL (compte chèque personnel seulement) PPD (compte chèque personnel seulement) CCD (compte chèque commercial seulement) firstname Conditionnel Chaîne Max = 40 lastname Conditionnel Chaîne Max = 40 Il s agit du prénom du client. Requis si checkpaymethod est réglé à WEB ou TEL. Il s agit du nom de famille du client. Requis si checkpaymethod est réglé à WEB ou TEL. 2-8

juillet 2014 Éléments de transaction ddcheckrequestv1 Tableau 2-2 : Éléments de transaction ddcheckrequestv1 (suite) Élément Élément enfant Requis Type Description companyname Conditionnel Chaîne Max = 50 street Oui Chaîne Max = 50 street2 Facultatif Chaîne Max = 50 city Oui Chaîne Max = 40 state/region Conditionnel Si state (État), alors Énumération Si region (région), alors chaîne Max = 40 Il s agit du nom de l entreprise. Requis si checkpaymethod est un chèque commercial. Il s agit de la première ligne de l adresse municipale du client. Il s agit de la deuxième ligne de l adresse municipale du client. Il s agit de la ville de résidence du client. Il s agit de l État, de la province ou de la région de résidence du client. Fournir la liste des États ou provinces pour les adresses à l intérieur des États-Unis ou du Canada. Fournir la liste des régions pour les adresses à l extérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. country Oui Énumération Il s agit du pays de résidence du client. Consultez la rubrique Codes de pays à la page C-3 pour connaître les bons codes à utiliser. zip Facultatif Chaîne Max = 10 phone Oui Chaîne Max = 40 email Facultatif Chaîne Max = 100 personalid idnumber Facultatif Chaîne Max = 20 Si le pays est États-Unis, il s'agit du code Zip du client ; sinon, il s'agit de son code postal. Il s agit du numéro de téléphone du client. Il s agit de l adresse de courriel du client. Il s agit du numéro de l ID fourni pour l élément idtype. idtype Facultatif Énumération Il s agit du type d ID utilisé pour identifier le propriétaire du compte bancaire. Les valeurs possibles sont : DL (permis de conduire) SS (ID gouvernemental) MI (ID militaire) GN (ID général) Guide de référence de l API pour les Services Web 1.0 2-9

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-2 : Éléments de transaction ddcheckrequestv1 (suite) Élément Élément enfant Requis Type Description state/region Facultatif Si state (État), alors Énumération Si region (région), alors Chaîne Max = 40 country Facultatif Chaîne Longueur = 2 Il s agit de l État, de la province ou de la région qui a émis l ID. Fournir la liste des États ou provinces pour les adresses à l intérieur des États-Unis ou du Canada. Fournir la liste des régions pour les adresses à l extérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. Il s agit du pays d émission de l ID. Les valeurs possibles sont : CA (Canada) US (États-Unis) expiry Facultatif L élément enfant expiry a trois autres éléments enfants. Élément enfant de expiry day Facultatif Entier Longueur = 2 month Facultatif Entier Longueur = 2 year Conditionnel Entier Longueur = 4 socialsecuritynumber Facultatif Chaîne Max = 12 Il s agit du jour d expiration de l ID. Il s agit du mois d expiration de l ID. Il s agit de l année d expiration de l ID. Cet élément est requis si l élément expiry est inclus. Il s agit du numéro d assurance sociale du client. dateofbirth Facultatif Il s agit de la date de naissance du client. year Conditionnel Chaîne Max = 4 1900 9999 month Conditionnel Chaîne Max = 12 day Conditionnel Chaîne Max = 31 Il s agit de l année de naissance du client. Il s agit du mois de naissance du client. Il s agit du jour de naissance du client. shippingdetails carrier Facultatif Énumération Il s agit du transporteur de l envoi. Les valeurs possibles sont : APC = APC Overnight APS = AnPost CAD = Service postal du Canada DHL FEX = FedEx RML = Royal Mail UPS = United Parcel Service USPS = United States Postal Service OTHER = Autre 2-10

juillet 2014 Éléments de transaction ddcheckrequestv1 Tableau 2-2 : Éléments de transaction ddcheckrequestv1 (suite) Élément Élément enfant Requis Type Description trackingnumber Facultatif Chaîne Max = 50 Il s agit du numéro de suivi d expédition fourni par le transporteur. shipmethod Facultatif Énumération Il s agit du mode d expédition. Les valeurs possibles sont : N = Jour suivant/de nuit T = Deux jours C = Coût le plus bas O = Autre firstname Facultatif Chaîne Max = 40 lastname Facultatif Chaîne Max = 40 street Facultatif Chaîne Max = 50 street2 Facultatif Chaîne Max = 50 city Facultatif Chaîne Max = 40 state/region Facultatif Si state (État), alors Énumération Si region (région), alors Chaîne Max = 40 Il s agit du prénom du destinataire. Il s agit du nom de famille du destinataire. Il s agit de la première ligne de l adresse municipale du destinataire. Il s agit de la deuxième ligne de l adresse municipale du destinataire. Il s agit de la ville de résidence du destinataire. Il s agit de l État, de la province ou de la région de résidence du destinataire. Fournir la liste des États ou provinces pour les adresses à l intérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. country Facultatif Énumération Il s agit du pays de résidence du destinataire. Consultez la rubrique Codes de pays à la page C-3 pour connaître les bons codes à utiliser. zip Facultatif Chaîne Max = 10 phone Facultatif Chaîne Max = 40 email Facultatif Chaîne Max = 100 customerip Facultatif Chaîne Max = 50 Si le pays est États-Unis, il s'agit du code Zip du destinataire ; sinon, il s'agit de son code postal. Il s agit du numéro de téléphone du destinataire. Il s agit de l adresse de courriel du destinataire. Il s agit de l adresse IP du client. Guide de référence de l API pour les Services Web 1.0 2-11

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-2 : Éléments de transaction ddcheckrequestv1 (suite) Élément Élément enfant Requis Type Description producttype Facultatif Énumération Il s agit du type de produit vendu. Les valeurs possibles sont : P(Biens matériels) D(Produits numériques) C (Contenu numérisé) G (Bon-cadeau ou argent électronique) S (Logiciel contributif) M (Numérique et Matériel) R (Réapprovisionnement de compte) txnappliedto Non Cet élément ne s applique pas aux transactions par prélèvement automatique. confirmationnumber Conditionnel Chaîne Max = 20 Il s agit du numéro de confirmation retourné par NETBANX en réponse à la requête initiale charge. N incluez cet élément que si vous utilisez ddcheckrequestv1 pour traiter une requête credit. targetvirtualaccount Non Cet élément ne s applique pas aux transactions par prélèvement automatique. checkriskservice Non Cet élément ne s applique pas aux transactions par prélèvement automatique. txndate Facultatif datetime Il s agit de la date et de l heure auxquelles la transaction a eu lieu. Pour les charge, credit, ou mandaterequest, cette valeur peut indiquer la date et l heure à laquelle la transaction aura lieu. Pour les transactions SEPA, cette valeur indique la prochaine date de paiement. Celle-ci est obligatoire et doit accorder un délai d au moins six jours ouvrables pour les First (premières) transactions ou les transactions One-Off (uniques), et d au moins trois jours ouvrables pour les transactions Recurring (récurrentes) ou les Final (finales) transactions. REMARQUE : La date de paiement sera retournée dans la paire tag/value, dans l élément detail de la réponse (consultez le Tableau 2-10 : Éléments de réponse ddcheckresponsev1 à la page 2-36). sdk version Conditionnel Chaîne Max = 20 platform Conditionnel Chaîne Max = 10 Il s agit de la version de SDK utilisée, le cas échéant. Requis si l élément sdk est fourni. Il s agit de la langue d intégration de SDK utilisée (par ex., Java,.NET). Requis si l élément sdk est fourni. 2-12

juillet 2014 Éléments de transaction ddcheckrequestv1 Tableau 2-2 : Éléments de transaction ddcheckrequestv1 (suite) Élément Élément enfant Requis Type Description provider Conditionnel Chaîne Max = 20 Il s agit de l auteur de SDK utilisé. Réglez cette valeur à «op» lorsque le SDK est fourni par NETBANX. Requis si l élément sdk est fourni. origin Facultatif Énumération Il s'agit de l origine de la requête. Les valeurs possibles sont : Sans fil Réseau filaire addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit de données supplémentaires que le marchand peut inclure dans la requête de transaction. Il s agit de données supplémentaires que le marchand peut inclure dans la requête de transaction. Considérations spéciales relatives aux éléments de prélèvement automatique Certains marchands sont intégrés à des processeurs ayant des exigences concernant certains éléments obligatoires. Si tel est le cas, les règles suivantes s appliquent: Tableau 2-3 : Exigences supplémentaires pour les éléments de prélèvement automatique Élément Transactions réguliers Transactions garanties Transactions SEPA check.accounttype Requis Requis Facultatif check.bankname Requis Requis Facultatif check.checknum Requis Requis Facultatif check.payee Facultatif Facultatif Requis check.bankcountry Conditionnel Conditionnel Facultatif check.bankcity Conditionnel Conditionnel Facultatif check.mandatereference Conditionnel Conditionnel Requis billingdetails.firstname Conditionnel Requis Requis billingdetails.lastname Conditionnel Requis Requis billingdetails.companyname Conditionnel Conditionnel Facultatif billingdetails.state Conditionnel Requis Facultatif billingdetails.zip Facultatif Requis Requis billingdetails.phone Facultatif Requis Facultatif billingdetails.email Facultatif Requis Requis customerip Facultatif Requis Facultatif dateofbirth.year Facultatif Requis Facultatif dateofbirth.month Facultatif Requis Facultatif Guide de référence de l API pour les Services Web 1.0 2-13

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-3 : Exigences supplémentaires pour les éléments de prélèvement automatique (suite) Élément Transactions réguliers Transactions garanties Transactions SEPA dateofbirth.day Facultatif Requis Facultatif personalid.idnumber Facultatif Requis Facultatif personalid.state Facultatif Requis Facultatif socialsecuritynumber Facultatif Requis Facultatif txndate Facultatif Facultatif Requis Votre gestionnaire de compte vous informera si vous êtes intégré à ce type de processeur et si vous êtes admissible au traitement par prélèvement automatique garantie. Création de requêtes updateshippinginfo Tous les éléments facultatifs qui requièrent des types de données non nullables (ordinaires) (par ex., int ou enum) doivent avoir leur attribut specified établi à true lorsque les valeurs sont fixées pour ces éléments. Consultez l élément shipmethod dans l exemple ci-dessous. La transaction updateshippinginfo requiert l objet de document ddshippingrequestv1. La présente rubrique décrit la structure d une requête ddshippingrequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 2-4 : Éléments de transaction ddshippingrequestv1 à la page 2-17. Exemple de transaction updateshippinginfo C# Voici un exemple de transaction updateshippinginfo en C#. // Prepare the call to the Direct Debit Web Service DDShippingRequestV1 ddshippingrequest = new DDShippingRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ddshippingrequest.merchantaccount = merchantaccount; ddshippingrequest.confirmationnumber = "123456"; // A valid confirmation number from a previous settle auth or purchase ddshippingrequest.carrier = CarrierV1.FEX; // Fedex ddshippingrequest.shipmethod = ShipMethodV1.T; ddshippingrequest.shipmethodspecified = true; ddshippingrequest.trackingnumber = "555666888999"; ddshippingrequest.firstname = "Jeanne"; ddshippingrequest.lastname = "Tremblay"; ddshippingrequest.street = "123 rue Principale"; ddshippingrequest.city = "Alma"; ddshippingrequest.country = CountryV1.CA; ddshippingrequest.countryspecified = true; ddshippingrequest.zip = "G0W 1G0"; ddshippingrequest.email = "jeannetremblay@emailserver.com"; //Perform the Web Services call to update the shipping info 2-14

juillet 2014 Exemple de transaction updateshippinginfo C# DirectDebitServiceV1 ddservice = new DirectDebitServiceV1(); DDCheckResponseV1 ddtxnresponse = ddservice.updateshippinginfo(ddshippingrequest); // Print out the result String responsetxt = ddtxnresponse.code + " - " + ddtxnresponse.decision + " - " + ddtxnresponse.description; responsetxt += "Details:" + Environment.NewLine; if (ddtxnresponse.detail!= null) { for (int i = 0; i < ddtxnresponse.detail.length; i++) { responsetxt += " - " + ddtxnresponse.detail[i].tag + " - " + ddtxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ddTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + ddtxnresponse.decision); } Guide de référence de l API pour les Services Web 1.0 2-15

Transactions par prélèvement automatique (débit direct) juillet 2014 Diagramme de transaction ddshippingrequestv1 L objet de document ddshippingrequestv1 respecte la structure suivante : 2-16

juillet 2014 Éléments de transaction ddshippingrequestv1 Éléments de transaction ddshippingrequestv1 L objet de document ddshippingrequestv1 peut contenir les éléments suivants : Tableau 2-4 : Éléments de transaction ddshippingrequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. carrier Oui Énumération Il s agit du transporteur de l envoi. Les valeurs possibles sont : APC = APC Overnight APS = AnPost CAD = Service postal du Canada DHL FEX = FedEx RML = Royal Mail UPS = United Parcel Service USPS = United States Postal Service AUTRE trackingnumber Oui Chaîne Max = 50 confirmationnumber Oui Chaîne Max = 20 Il s agit du numéro de suivi d expédition fourni par le transporteur. Il s agit du numéro de confirmation retourné par NETBANX. shipmethod Facultatif Énumération Il s agit du mode d expédition. Les valeurs possibles sont : N = Jour suivant/de nuit T = Deux jours C = Coût le plus bas O = Autre firstname Facultatif Chaîne Max = 40 lastname Facultatif Chaîne Max = 40 street Facultatif Chaîne Max = 50 street2 Facultatif Chaîne Max = 50 Il s agit du prénom du client. Il s agit du nom de famille du client. Il s agit de la première ligne de l adresse municipale du client. Il s agit de la deuxième ligne de l adresse municipale du client. Guide de référence de l API pour les Services Web 1.0 2-17

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-4 : Éléments de transaction ddshippingrequestv1 (suite) Élément Élément enfant Requis Type Description city Facultatif Chaîne Max = 40 state/region Facultatif Si state (État), alors Énumération Si region (région), alors Chaîne Max = 40 Il s agit de la ville de résidence du client. Il s agit de l État, de la province ou de la région de résidence du client. Fournir la liste des États ou provinces pour les adresses à l intérieur des États-Unis ou du Canada. Fournir la liste des régions pour les adresses à l extérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. country Facultatif Énumération Il s agit du pays de résidence du client. Consultez la rubrique Codes de pays à la page C-3 pour connaître les bons codes à utiliser. zip Facultatif Chaîne Max = 10 phone Facultatif Chaîne Max = 40 email Facultatif Chaîne Max = 100 Si le pays est États-Unis, il s'agit du code Zip du client ; sinon, il s'agit de son code postal. Il s agit du numéro de téléphone du client. Il s agit de l adresse de courriel du client. Création de lookuprequest (requêtes de consultation) La requête de consultation du prélèvement automatique vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les transactions de facturation et de crédit par prélèvement automatique qui sont traitées par votre compte de marchand. Exemple de transaction lookuprequest C# Voici un exemple de transaction ddlookuprequest en C#. // Prepare the call to the Direct Debit Web Service DDLookupRequestV1 ddlookuprequest = new DDLookupRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ddlookuprequest.merchantaccount = merchantaccount; ddlookuprequest.confirmationnumber = "123456789"; DateV1 startdate = new DateV1(); startdate.year = "2012"; startdate.month = "08"; startdate.day = "15"; startdate.hour = "11"; 2-18

juillet 2014 Exemple de transaction lookuprequest C# startdate.minute = "00"; startdate.second = "00"; ddlookuprequest.startdate = startdate; ddlookuprequest.startdatespecified = true; DateV1 enddate = new DateV1(); enddate.year = "2012"; enddate.month = "08"; enddate.day = "15"; enddate.hour = "14"; enddate.minute = "00"; enddate.second = "00"; ddlookuprequest.enddate = enddate; ddlookuprequest.enddatespecified = true; //Perform the Web Services call to process the charge DirectDebitServiceV1 ddservice = new DirectDebitServiceV1(); DDCheckResponseV1 ddcheckresponse = ddservice.lookup(ddlookuprequest); // Print out the result String responsetxt = ddcheckresponse.code + " - " + ddcheckresponse.decision; responsetxt += "Transactions:" + Environment.NewLine; if (ddcheckresponse.transaction!= null) { for (int i = 0; i < ddcheckresponse.transaction.length; i++) { responsetxt += " - confirmationnumber: " + ddcheckresponse.transaction[i].confirmationnumber + Environment.NewLine; responsetxt += " - merchantrefnum: " + ddcheckresponse.transaction[i].merchantrefnum + Environment.NewLine; responsetxt += " - txntime: " + ddcheckresponse.transaction[i].txntime + Environment.NewLine; responsetxt += " - amount: " + ddcheckresponse.transaction[i].amount + Environment.NewLine; StatusV1 status = ddcheckresponse.transaction[i].status; if (status!= null){ responsetxt += " - status: " + status.code + Environment.NewLine; responsetxt += " - status effective date:" + status.effectivedate + Environment.NewLine; } responsetxt += Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ddCheckResponse.decision)) { System.Console.WriteLine("Transaction Found."); } else { System.Console.WriteLine("Transaction Failed or Not Found with decision: " + ddcheckresponse.decision); } Guide de référence de l API pour les Services Web 1.0 2-19

Transactions par prélèvement automatique (débit direct) juillet 2014 Diagramme de transaction ddlookuprequestv1 L objet de document ddlookuprequestv1 respecte la structure suivante : Éléments de transaction ddlookuprequestv1 L objet de document ddlookuprequestv1 peut contenir les éléments suivants : Tableau 2-5 : Éléments de transaction ddlookuprequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. 2-20

juillet 2014 Éléments de transaction ddlookuprequestv1 Tableau 2-5 : Éléments de transaction ddlookuprequestv1 (suite) Élément Élément enfant Requis Type Description storepwd Oui Chaîne Max = 20 confirmationnumber Facultatif Chaîne Max = 20 merchantrefnum Conditionnel Chaîne Max = 255 startdate year Oui Int Max = 9999 month Oui Int Min = 1 Max = 12 day Oui Int Min = 1 Max = 31 hour Oui Int Min = 0 Max = 23 minute Oui Int Min = 0 Max = 59 second Oui Int Min = 0 Max = 59 enddate year Oui Int Max = 9999 month Oui Int Min = 1 Max = 12 day Oui Int Min = 1 Max = 31 Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du numéro de confirmation retourné par NETBANX en réponse à la requête initiale. N incluez cet élément que si vous voulez effectuer une recherche à l aide de ce champ. Ce champ a préséance sur le champ merchantrefnum. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Il s agit de l année fixée pour le début de la recherche. Il s agit du mois fixé pour le début de la recherche. Il s agit du jour fixé pour le début de la recherche. Il s agit de l heure fixée pour le début de la recherche. Il s agit de la minute fixée pour le début de la recherche. Il s agit de la seconde fixée pour le début de la recherche. Il s agit de l année fixée pour la fin de la recherche. Il s agit du mois fixé pour la fin de la recherche. Il s agit du jour fixé pour la fin de la recherche. Guide de référence de l API pour les Services Web 1.0 2-21

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-5 : Éléments de transaction ddlookuprequestv1 (suite) Élément Élément enfant Requis Type Description hour Oui Int Min = 0 Max = 23 minute Oui Int Min = 0 Max = 59 second Oui Int Min = 0 Max = 59 Il s agit de l heure fixée pour la fin de la recherche. Il s agit de la minute fixée pour la fin de la recherche. Il s agit de la seconde fixée pour la fin de la recherche. Création de mandaterequest pour BACS (requêtes de mandat) La demande de mandat de prélèvements automatiques vous permet de créer un mandat pour le compte bancaire d un client et de le déposer à sa banque, afin que vous puissiez transférer des fonds du compte bancaire du client vers votre compte commercial. Lorsque vous soumettez une ddmandaterequestv1, NETBANX retournera une valeur pour le paramètre confirmationnumber dans la réponse. Il s agit de la valeur entrée dans la requête ou une valeur générée automatiquement par le système NETBANX. Vous aurez besoin de cette valeur dans l élément mandatereference (qui est un élément enfant de l élément check) lorsque vous traiterez des demandes de facturation à l aide de la ddcheckrequestv1. La valeur mandatereference doit contenir dix caractères. Si vous entrez une valeur de moins de dix caractères, le système NETBANX insérera des chiffres 0 avant celle-ci jusqu à ce qu elle compte 10 caractères. Par exemple, la valeur ABCDEFG deviendra 000ABCDEFG. Si vous n entrez aucune valeur, le système NETBANX en générera une et la retournera dans la réponse. Initialement, l état du mandat est réglé à W (En attente). Lorsque ce dernier est mis en lot, l état passe à C (Lot complet). À ce stade, le mandat ne peut pas être utilisé pour effectuer des prélèvements automatiques. Le réseau bancaire traite généralement le mandat en cinq jours. Après ce délai, et une fois le mandat mis en lot, NETBANX fait passer l état du mandat à AP (Mandat approuvé). Le mandat peut alors être utilisé pour autoriser des prélèvements automatiques dans le compte bancaire à l intention duquel il a été créé. Si la facture est postdatée en définissant la valeur txndate dans la requête ddcheckrequestv1, le mandat peut être utilisé même s il n est pas activé, dans la mesure où la valeur txndate a été définie de façon à fixer un délai d au moins cinq jours ouvrables, le temps que le mandat devienne actif. Afin de faciliter ce processus, la date d activation du mandat est indiquée dans l élément effectivedate en réponse à la requête ddmandaterequestv1. Les mandats sont automatiquement mis en lot le jour ouvrable suivant, sauf si la valeur autosend n est pas réglée à Y, auquel cas le mandat demeurera à l état PCA (Approbation du client en attente). Cet état intermédiaire et facultatif, antérieur à l état W, vous donne l occasion d effectuer d autres vérifications relatives au client, ou encore permet au client de vérifier l information reçue par mandatereference avant de continuer. Vous pouvez ensuite faire passer l état du mandat de PCA à W en effectuant une requête changestatus ou en utilisant le module d administration du marchand de NETBANX. 2-22

juillet 2014 Création de mandaterequest pour SEPA (requêtes de mandat) Création de mandaterequest pour SEPA (requêtes de mandat) Avant d effectuer un prélèvement automatique SEPA, vous devez préalablement avoir établi une entente de mandat avec votre client et indiquer l ID de référence du mandat dans l élément mandatereference. L ID de référence du mandat peut contenir jusqu à 35 caractères. Les mandats de prélèvements automatiques SEPA sont activés dès qu ils sont créés par le marchand. Après avoir envoyé une requête ddmandaterequest, vous pouvez donc immédiatement envoyer une requête ddcheckrequest. Pour en savoir plus consultez le SEPA Direct Debit Merchant Implementation Guide (en anglais), qui contient plus d information sur la logique métier et les processus associés au prélèvement automatique SEPA. Exemple de transaction mandaterequest C# Voici un exemple de transaction ddmandaterequest en C#. // Prepare the call to the Direct Debit Web Service DDMandateRequestV1 ddmandaterequest = new DDMandateRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ddcheckrequest.merchantaccount = merchantaccount; CheckV1 check = new CheckV1(); check.routingnum = "123456789"; check.accountnum = "987654321"; check.bankname = "Chase"; check.payee = "ACME Inc."; ddmandaterequest.check = check; BillingDetailsV1 billingdetails = new BillingDetailsV1(); billingdetails.firstname = "Jeanne"; billingdetails.lastname = "Tremblay"; billingdetails.street = "123 rue Principale"; billingdetails.city = "Alma"; billingdetails.country = CountryV1.CA; billingdetails.zip = "G0W 1G0"; billingdetails.phone = "555-555-5555"; billingdetails.checkpaymethod = CheckPayMethodV1.WEB; ddmandaterequest.billingdetails = billingdetails; ddmandaterequest.autosend = "Y"; //Perform the Web Services call to process the charge DirectDebitServiceV1 ddservice = new DirectDebitServiceV1(); DDCheckResponseV1 ddtxnresponse = ddservice.mandate(ddcheckrequest); // Print out the result String responsetxt = ddtxnresponse.code + " - " + ddtxnresponse.decision + " - " + ddtxnresponse.description; responsetxt += "Details:" + Environment.NewLine; if (ddtxnresponse.detail!= null) { for (int i = 0; i < ddtxnresponse.detail.length; i++) { responsetxt += " - " + ddtxnresponse.detail[i].tag + " - " + ddtxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); Guide de référence de l API pour les Services Web 1.0 2-23

Transactions par prélèvement automatique (débit direct) juillet 2014 System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ddTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + ddtxnresponse.decision); } 2-24

juillet 2014 Diagramme de transaction ddmandaterequestv1 Diagramme de transaction ddmandaterequestv1 L objet de document ddmandaterequestv1 respecte la structure suivante : Guide de référence de l API pour les Services Web 1.0 2-25

Transactions par prélèvement automatique (débit direct) juillet 2014 Éléments de transaction ddmandaterequestv1 L objet de document ddmandaterequestv1 peut contenir les éléments suivants : Table 2-6: Éléments de transaction ddmandaterequestv1 Element Child Element Required Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 merchantrefnum Conditionnel Chaîne Max = 255 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. check accounttype Oui Énumération Il s agit du type de compte chèque utilisé pour la transaction. Les valeurs possibles sont : PC (Compte chèque personnel) PS (Compte épargne personnel) PL (Compte prêt personnel) BC (Compte chèque commercial) BS (Compte épargne commercial) BL (Compte prêt commercial) bankname Oui Chaîne Max = 40 checknum Oui Long Max = 8 accountnum Oui Chaîne Max = 17 routingnum Oui Chaîne Min = 6 Max = 9 Il s agit du nom de la banque du client, là où cette transaction est publiée. Il s agit du numéro de série du chèque fourni au moment de la requête de transaction. Il s agit du numéro du compte bancaire du client. Pour les transactions SEPA, il s agit du numéro IBAN (numéro de compte bancaire international) du client. Pour les comptes en livres anglaises, il s agit du code de tri à six chiffres de la banque du client. Pour les transactions SEPA, il s agit du code BIC (code identificateur de banque) du compte bancaire du client. 2-26

juillet 2014 Éléments de transaction ddmandaterequestv1 Table 2-6: Éléments de transaction ddmandaterequestv1 (suite) Element Child Element Required Type Description payee Facultatif Chaîne Max = 81 Il s agit du descripteur qui apparaîtra sur le relevé bancaire du client. Il n est requis que pour les transactions credit et verify. Si vous entrez une valeur pour ce champ, celle-ci servira de descripteur sur le relevé. Si vous n entrez pas une valeur pour ce champ, une valeur par défaut, configurée pour le compte de marchand, servira de descripteur sur le relevé. bankcountry Conditionnel Énumération Il s agit du pays dans lequel la banque est située. Consultez la rubrique Codes de pays à la page C-3 pour connaître les bons codes à utiliser. Cet élément n est requis que pour certains pays. bankcity Conditionnel Chaîne Max = 40 mandatereference Facultatif Chaîne Max = 10 Il s agit de la ville dans laquelle la banque est située. Cet élément n est requis que pour certains pays. Il s agit de la référence du mandat permettant de porter les frais au compte. Vous pouvez définir vous-même la valeur mandatereference lorsque vous effectuez la requête. Si vous n entrez aucune valeur dans ce champ, le système NETBANX en générera une et la retournera dans la réponse. Pour les transactions SEPA, cet élément est obligatoire. Le marchand doit créer sa propre valeur mandatereference. billingdetails checkpaymethod Facultatif Énumération Il s agit du type de paiement. Les valeurs possibles sont : WEB (compte chèque personnel seulement) TEL (compte chèque personnel seulement) PPD (compte chèque personnel seulement) CCD (compte chèque commercial seulement) firstname Conditionnel Chaîne Max = 40 lastname Conditionnel Chaîne Max = 40 companyname Conditionnel Chaîne Max = 50 Il s agit du prénom du client. Requis si checkpaymethod est réglé à WEB ou TEL. Il s agit du nom de famille du client. Requis si checkpaymethod est réglé à WEB ou TEL. Il s agit du nom de l entreprise. Requis si checkpaymethod est un chèque commercial. Guide de référence de l API pour les Services Web 1.0 2-27

Transactions par prélèvement automatique (débit direct) juillet 2014 Table 2-6: Éléments de transaction ddmandaterequestv1 (suite) Element Child Element Required Type Description street Facultatif Chaîne Max = 50 street2 Facultatif Chaîne Max = 50 city Facultatif Chaîne Max = 40 state/region Conditionnel Si state (État), alors Énumération Si region (région), alors chaîne Max = 40 Il s agit de la première ligne de l adresse municipale du client. Il s agit de la deuxième ligne de l adresse municipale du client. Il s agit de la ville de résidence du client. Il s agit de l État, de la province ou de la région de résidence du client. Fournir la liste des États ou provinces pour les adresses à l intérieur des États-Unis ou du Canada. Fournir la liste des régions pour les adresses à l extérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. country Facultatif Énumération Il s agit du pays de résidence du client. Consultez la rubrique Codes de pays à la page C-3 pour connaître les bons codes à utiliser. zip Facultatif Chaîne Max = 10 phone Facultatif Chaîne Max = 40 email Facultatif Chaîne Max = 100 customerip Facultatif Chaîne Max = 50 Si le pays est États-Unis, il s'agit du code Zip du client ; sinon, il s'agit de son code postal. Il s agit du numéro de téléphone du client. Il s agit de l adresse de courriel du client. Il s agit de l adresse IP du client. txndate Facultatif datetime Il s agit de la date et de l heure auxquelles la transaction a eu lieu. Pour les charge, credit, ou mandaterequest, cette valeur peut indiquer la date et l heure à laquelle la transaction aura lieu. 2-28

juillet 2014 Création de changestatusrequest (requêtes de modification d état) Table 2-6: Éléments de transaction ddmandaterequestv1 (suite) Element Child Element Required Type Description autosend Facultatif Booléen Ceci détermine le moment où le mandat sera envoyé à la banque. Les valeurs possibles sont : Y = Oui L état du mandat sera réglé à W (En attente), prêt à être envoyé à la banque. N = Non L état du mandat restera réglé à PCA (Approbation client en attente), et ce dernier ne sera pas envoyé à la banque. Si l état autosend est réglé à N, le mandat peut par la suite être changé pour W à l aide de la demande de changestatus. Le mandat sera alors acheminé à la banque lors du prochain envoi (consultez la rubrique Création de changestatusrequest (requêtes de modification d état) à la page 2-29). REMARQUE : Pour les transactions SEPA, cette valeur doit être réglée à Y. L état du mandat sera AP (Mandat approuvé). addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit de données supplémentaires que le marchand peut inclure dans la requête de transaction. Il s agit de données supplémentaires que le marchand peut inclure dans la requête de transaction. Création de changestatusrequest (requêtes de modification d état) Une demande de modification d état vous permet de modifier l état de certains prélèvements automatiques. Vous pouvez apporter les modifications suivantes : Tableau 2-7 : Modification d état Solution Type de requête État initial État obtenu Prélèvement automatique au Royaume-Uni (BACS) mandaterequest (mandat) PCA Approbation du client en attente W En attente X Annulée Prélèvement automatique au Royaume-Uni (BACS) charge (facturation) credit (crédit) mandaterequest (mandat) W En attente X Annulée Guide de référence de l API pour les Services Web 1.0 2-29

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-7 : Modification d état (suite) Solution Type de requête État initial État obtenu Prélèvement automatique au Royaume-Uni (marchands passerelle) charge (facturation) credit (crédit) mandaterequest (mandat) C Lot complet CL Transaction traitée RE Retournée REMARQUE : Utiliser seulement lorsque votre banque rejette la transaction et lorsque vous n avez pas obtenu de rapport BACS. Comptez 5 jours ouvrables après la fin de la transaction, puis communiquez avec le soutien technique avant d effectuer la demande de modification. EFT (TEF)/ACH (CCA) charge (facturation) credit (crédit) C Lot complet X Annulée REMARQUE : Possible seulement si la requête n a pas encore été envoyée à la banque. Prélèvement automatique SEPA mandaterequest (mandat) AP Active X Annulée Prélèvement automatique SEPA charge (facturation) W En attente C Lot complet X Annulée REMARQUE : Possible seulement jusqu à 5 jours après la compensation du prélèvement. NETBANX répond à votre demande de modification d état par une ddcheckresponsev1. Dans cette réponse, le confirmationnumber indique quelle demande a été mise à jour (charge, credit, ou mandaterequest), et vous permet de confirmer le nouvel état de la transaction que vous avez mise à jour. Pour obtenir plus de détails, consultez la rubrique Traitement de la réponse à la page 2-35. Exemple de transaction changestatusrequest C# Voici un exemple de transaction ddchangestatusrequest en C#. // Prepare the call to the Direct Debit Web Service DDChangeStatusRequestV1 ddchangestatusrequest = new DDChangeStatusRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ddchangestatusrequest.merchantaccount = merchantaccount; ddchangestatusrequest.confirmationnumber = "123456"; // A valid confirmation number from a previous mandate or echeck; ddchangestatusrequest.status = "C"; //Perform the Web Services call to process the charge DirectDebitServiceV1 ddservice = new DirectDebitServiceV1(); DDCheckResponseV1 ddtxnresponse = ddservice.changestatus(ddcheckrequest); // Print out the result String responsetxt = ddtxnresponse.code + " - " + ddtxnresponse.decision + " - " + ddtxnresponse.description; 2-30

juillet 2014 Diagramme de transaction ddchangestatusrequest responsetxt += "Details:" + Environment.NewLine; if (ddtxnresponse.detail!= null) { for (int i = 0; i < ddtxnresponse.detail.length; i++) { responsetxt += " - " + ddtxnresponse.detail[i].tag + " - " + ddtxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ddTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + ddtxnresponse.decision); } Diagramme de transaction ddchangestatusrequest L objet de document ddchangestatusrequestv1 respecte la structure suivante : Éléments de transaction ddchangestatusrequestv1 L objet de document ddchangestatusrequestv1 peut contenir les éléments suivants : Tableau 2-8 : Éléments de transaction ddchangestatusrequestv1 Element Child Element Required Type Description merchantaccount accountnum Oui Chaîne Max = 10 Il s agit du numéro de compte de marchand. Guide de référence de l API pour les Services Web 1.0 2-31

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-8 : Éléments de transaction ddchangestatusrequestv1 (suite) Element Child Element Required Type Description storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 confirmationnumber Conditionnel Chaîne Max = 20 Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Cette valeur indique la transaction pour laquelle vous avez demandé une modification d état. Il s agit du confirmationnumber retourné par NETBANX en réponse à la requête initiale. status Oui Énumération Il s agit du nouveau code d état de la transaction. Les valeurs possibles sont : C Complété RE Retourné W En attente X Annulée Création de updatemandaterequest (mise à jour du mandat) Seuls les marchands qui traitent des prélèvements automatiques SEPA peuvent effectuer ce type de requête. Vous pouvez modifier un mandat existant en effectuant une demande de modification de mandat. En réalité, vous créez un nouveau mandat à partir des informations du mandat existant, mais en y ajoutant de nouvelles informations (par exemple, un nouveau numéro de compte bancaire). Lorsque vous soumettez une requête ddupdatemandaterequestv1, NETBANX règle l état du mandat à T (Transférée). Un nouveau mandat est créé à partir des informations du mandat existant. Cependant, les trois valeurs suivantes ne sont pas modifiées si vous les précisez dans la demande de modification : mandatereference accountnum routingnum Si vous le précisez dans la demande, les nouvelles valeurs entrées relativement à ces éléments sont importées dans le nouveau mandat. L état du nouveau mandat sera identique à celui du mandat existant, soit PCA (Approbation du client en attente) ou AP (Mandat approuvé). Le nouveau mandat sera lié au mandat existant, de sorte que le système sache que les informations du mandat existant ont été transférées dans le nouveau mandat. 2-32

juillet 2014 Exemple de transaction updatemandaterequest C# NETBANX répond à votre demande de modification de mandat par une réponse ddcheckresponsev1. Dans cette réponse, la valeur confirmationnumber sert à identifier le nouveau mandat. Exemple de transaction updatemandaterequest C# Voici un exemple de transaction ddupdatemandaterequest en C#. // Prepare the call to the Direct Debit Web Service DDUpdateMandateRequestV1 ddupdatemandaterequest = new DDUpdateMandateRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ddupdatemandaterequest.merchantaccount = merchantaccount; ddupdatemandaterequest.confirmationnumber = "123456"; // A valid confirmation number from a previous mandate or echeck; ddupdatemandaterequest.mandatereference = "NL95ZZZ999999991458_TEST7A"; //Perform the Web Services call to process the charge DirectDebitServiceV1 ddservice = new DirectDebitServiceV1(); DDCheckResponseV1 ddtxnresponse = ddservice.updatemandate(ddcheckrequest); // Print out the result String responsetxt = ddtxnresponse.code + " - " + ddtxnresponse.decision + " - " + ddtxnresponse.description; responsetxt += "Details:" + Environment.NewLine; if (ddtxnresponse.detail!= null) { for (int i = 0; i < ddtxnresponse.detail.length; i++) { responsetxt += " - " + ddtxnresponse.detail[i].tag + " - " + ddtxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ddTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + ddtxnresponse.decision); } Diagramme de transaction ddupdatemandaterequestv1 L objet de document ddupdatemandaterequestv1 respecte la structure suivante : Guide de référence de l API pour les Services Web 1.0 2-33

Transactions par prélèvement automatique (débit direct) juillet 2014 Éléments de transaction ddupdatemandaterequestv1 L objet de document ddupdatemandaterequestv1 peut contenir les éléments suivants : Tableau 2-9 : Éléments de transaction ddupdatemandaterequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 confirmationnumber Facultatif Chaîne Max = 20 mandatereference Facultatif Chaîne Max = 10 Pour SEPA, Max = 35 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Cette valeur indique le mandat que vous voulez modifier. Il s agit du numéro de confirmation retourné par NETBANX en réponse à la requête initiale. Il s agit de la référence du mandat permettant de porter les frais au compte. Cette valeur est retournée pour le paramètre mandatereference en réponse à la requête ddmandaterequestv1. Vous devrez peut-être modifier la valeur mandatereference, par exemple, si les modalités de facturation ont changé et que les autres informations dans le mandat demeurent identiques. 2-34

juillet 2014 Traitement de la réponse Tableau 2-9 : Éléments de transaction ddupdatemandaterequestv1 (suite) Élément Élément enfant Requis Type Description accountnum Conditionnel Chaîne Max = 17 Si IBAN, Max = 32 routingnum Conditionnel Chaîne Min = 6 Max = 9 Si BIC, Min = 8 Max = 11 Pour les transactions SEPA, il s agit du numéro IBAN (numéro de compte bancaire international) du client. Vous devrez peut-être modifier la valeur accountnum, par exemple, si les frais sont désormais portés à un compte différent de la même banque (c.-à-d., il n est pas nécessaire de modifier le code BIC). Pour les transactions SEPA, il s agit du code BIC (code identificateur de banque) du compte bancaire du client. Vous devrez peut-être modifier la valeur routingnum, par exemple, si un client a changé de banque. Dans ce cas, il faudra aussi modifier la valeur accountnum. * Au moins un des trois éléments suivants doit être indiqué dans la requête : mandatereference, accountnum ou routingnum. Traitement de la réponse Une transaction ddcheckresponsev1 respecte la structure suivante : Guide de référence de l API pour les Services Web 1.0 2-35

Transactions par prélèvement automatique (débit direct) juillet 2014 Les éléments suivants sont pertinents dans le cas d une réponse ddcheckresponsev1 : Tableau 2-10 : Éléments de réponse ddcheckresponsev1 Élément Élément enfant Requis Type Description requestid Facultatif Il s agit du seul numéro d identification unique envoyé par NETBANX pour un enregistrement si ce dernier a été traité dans un fichier séquentiel. confirmationnumber Oui Chaîne Max = 20 Il s agit du numéro de confirmation retourné par NETBANX. Si cette valeur est retournée en réponse à une ddmandaterequestv1, elle sert à identifier le nouveau mandat. 2-36

juillet 2014 Traitement de la réponse Tableau 2-10 : Éléments de réponse ddcheckresponsev1 (suite) Élément Élément enfant Requis Type Description merchantrefnum Conditionnel Chaîne Max = 255 mandatereference Oui Chaîne Max = 20 Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Cette valeur n est retournée qu en réponse à une lookuprequest. Ceci est la référence du mandat retournée par NETBANX. Il s agit de la valeur entrée dans la requête ou, si celle-ci était erronée, d une valeur générée par le système NETBANX. Pour les transactions SEPA, ceci est la référence du mandat créée par le marchand dans la requête. decision Oui Énumération Il s agit de l état de la transaction. Une des valeurs suivantes sera retournée : Accepted La transaction a été traitée. Error La tentative de transaction a échoué en raison d une erreur. Declined La transaction a été refusée avant qu elle soit envoyée pour traitement. Not Found La requête de consultation ne correspond à aucun résultat. code Oui Entier Il s agit d un code numérique servant à catégoriser la réponse. Consultez la rubrique Codes de réponse à la page B-1. actioncode Facultatif Énumération Cela indique l action à effectuer. Les valeurs suivantes sont possibles : C = Erreur de paramètre du client. Les renseignements fournis par le client sont incorrects. Confirmez les renseignements auprès du client. D = Ne pas réessayer. Les tentatives subséquentes échoueront. M = Erreur de paramètre du marchand. Les renseignements fournis par votre application sont incorrects. Vérifiez vos renseignements. R = Réessayer. Le problème est temporaire. La prochaine tentative réussira probablement. description Facultatif Chaîne Max = 100 Il s agit de la description accessible à l utilisateur de l élément code. Guide de référence de l API pour les Services Web 1.0 2-37

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-10 : Éléments de réponse ddcheckresponsev1 (suite) Élément Élément enfant Requis Type Description detail tag Facultatif Chaîne Max = 1024 value Facultatif Chaîne Max = 30 Il s agit de la classification de l élément détail. Il s agit de la description du détail. txntime Oui datetime Il s agit de la date et de l heure du traitement de la transaction par NETBANX. status Facultatif code Conditionnel Énumération Il s agit de l état de la première transaction qui correspond à la requête de consultation. Les valeurs possibles sont : AP Mandat approuvé (Approved mandate) C Lot complet (Complete batch) CB Récupérée (Clawed back) CL Transaction traitée (Cleared transaction) DE Refusée (Declined) DI Contestée (Disputed) E Erreur lot (Error batch) EX Expirée (Expired) F Échec (Failed) GR Bon pour renversement (Good for reversal) MI Intervention manuelle requise (Manual intervention required) PCA Approbation du client en attente (Pending customer approval) PR1 Re-Présentée 1 (Re-Presented 1) PR2 Re-Présentée 2 (Re-Presented 2) PX Annulation en attente (Pending cancel) RE Retournée (Returned) REF Rejet définitif (Rejected final) RV Inversée (Reversed) T Transférée (Transferred) W En attente (Pending) X Annulée (Cancelled) 2-38

juillet 2014 Traitement de la réponse Tableau 2-10 : Éléments de réponse ddcheckresponsev1 (suite) Élément Élément enfant Requis Type Description effectivedate Conditionnel datetime Il s agit de la date et de l heure où l état de la requête de consultation entre en vigueur. Lorsqu elle est indiquée dans la paire tag/value pour l élément detail d une réponse à une requête de mandat, ceci est la date à laquelle le mandat devient actif (cinq jours après la mise en lot). Vous pouvez soumettre une demande de prélèvement à cette date à minuit ou postdater le prélèvement en réglant la valeur txntime à cette date ou à une date ultérieure. Si vous soumettez une demande de prélèvement dont la date est antérieure à la date d entrée en vigueur du mandat, indiquée par la valeur effectivedate, vous obtiendrez un message d erreur. currency Facultatif Chaîne La valeur figure dans les codes de devises du Tableau 3-15 : Codes de devises à la page 3-58. Cette valeur n est retournée qu en réponse à une lookuprequest. amount Facultatif Chaîne Max = 999999999,99 Il s agit du montant de la première transaction qui correspond à la requête de consultation. transaction Facultatif Cette valeur n est retournée qu en réponse à une lookuprequest. Toutes les transactions qui correspondent à la requête de consultation sont retournées ici. confirmationnumber Conditionnel Chaîne Max = 20 merchantrefnum Facultatif Chaîne Max = 255 Il s agit du numéro de confirmation retourné par NETBANX pour une transaction précédente. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Cette valeur n est retournée qu en réponse à une lookuprequest. txntime Conditionnel datetime Il s agit de la date et de l heure du traitement de la transaction par NETBANX. status Conditionnel On retrouve les éléments code et effectivedate pour la transaction. Pour obtenir des détails, consultez l élément status présenté dans le tableau cidessus. Guide de référence de l API pour les Services Web 1.0 2-39

Transactions par prélèvement automatique (débit direct) juillet 2014 Tableau 2-10 : Éléments de réponse ddcheckresponsev1 (suite) Élément Élément enfant Requis Type Description amount Conditionnel Chaîne Max = 999999999,99 Il s agit du montant de la requête de transaction. Pour traiter la réponse : 1. Obtenez les détails de la réponse qui sont accessibles à partir des modes get() de la réponse. String responsetxt = ddtxnresponse.code + " - " + ddtxnresponse.decision + " - " + ddtxnresponse.description; responsetxt += "Details:" + Environment.NewLine; if (ddtxnresponse.detail!= null) { for (int i = 0; i < ddtxnresponse.detail.length; i++) { responsetxt += " - " + ddtxnresponse.detail[i].tag + " - " + ddtxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ddTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + ddtxnresponse.decision); } 2. Traitez la réponse en fonction de l élément decision. Vous insérez le code de gestion approprié à votre application. Vous pouvez également consulter l élément code pour obtenir un contrôle plus serré de votre application. Pour obtenir plus de détails, consultez la rubrique Codes de réponse à la page B-1. 2-40

CHAPITRE 3 Transactions par carte de crédit ou de débit Introduction Ce chapitre décrit comment traiter les transactions par carte de crédit ou de débit à l aide du Service Web de traitement des transactions. Les opérations suivantes sont prises en charge : Tableau 3-1 : Opérations prises en charge Opération Description Type de requête Authorization (autorisation) Purchase (achat) Verification (vérification) Authorization Reversal (inversion d autorisation) Credit (crédit) Settlement (règlement) Stored Data Authorization (autorisation à partir de données mémorisées) Stored Data Purchase (achat partir de données mémorisées) Vous permet d autoriser un montant sur la carte de crédit ou de débit d un client. Le montant autorisé doit être réglé au cours d une transaction de règlement ultérieure. Vous permet d autoriser et de régler un montant sur la carte de crédit ou de débit d un client à l aide d une seule transaction. Vous permet d exécuter une vérification AVS ou CVD sur la carte de crédit d un client, sans imputer de montant sur cette carte. Vous permet d inverser une partie ou la totalité d une autorisation existante, pourvu qu aucun règlement (complet ou partiel) n ait été traité à l'égard de cette autorisation. Ce type de transaction ne fonctionne pas pour les transactions d'achat ; cette transaction n est utilisée que pour les autorisations. Vous permet d annuler le débit d un montant déjà réglé sur une carte de crédit ou de débit. Vous pouvez créditer la totalité ou une partie d un règlement existant. Vous permet de régler un montant qui a préalablement été autorisé sur une carte de crédit ou de débit. Vous pouvez régler la totalité ou une partie d une autorisation existante. Vous permet d autoriser un montant sur la carte de crédit ou de débit d un client à l aide des données sur le client qui sont mémorisées dans notre base de données. Vous n avez qu à fournir le minimum de renseignements, ce qui vous permet de gagner du temps et de réduire les efforts. Vous permet d autoriser et de régler un montant sur la carte de crédit ou de débit d un client à l aide de données sur le client qui sont mémorisées dans notre base de données. Vous n avez qu à fournir le minimum de renseignements, ce qui vous permet de gagner du temps et de réduire les efforts. Consultez la rubrique Bâtir des requêtes d achat, d autorisation ou de vérification à la page 3-5. Consultez la rubrique Bâtir des requêtes d inversion d autorisation à la page 3-19. Consultez la rubrique Bâtir des requêtes de règlement et de crédit à la page 3-21. Consultez la rubrique Bâtir des requêtes de données mémorisées à la page 3-26. Guide de référence de l API pour les Services Web 1.0 3-1

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-1 : Opérations prises en charge Opération Description Type de requête Cancel (annulation) Payment (paiement) Independent Credit (crédit indépendant) Information Lookup (consultation des données) Enrollment Lookup (consultation d inscription) Authentication (authentification) Vous permet d annuler une transaction de crédit, de règlement, de paiement, ou de crédit indépendant. Vous pouvez annuler une de ces transactions pourvu qu elle soit En attente, ce qui est habituellement le cas avant minuit le jour où la requête est faite. Dans certains cas, vous pouvez trouver des transactions de crédit plus anciennes En attente. Vous permet de créditer un montant sur la carte de crédit ou de débit d un client. La transaction de paiement n est pas liée à une autorisation existante antérieure ; le montant de la transaction n est donc pas limité de cette manière. Vous permet de créditer un montant sur la carte de crédit d un client. La transaction de crédit indépendant n est pas liée à une autorisation existante antérieure ; le montant de la transaction n est donc pas limité de cette manière. Vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les transactions traités par un compte de marchand. Vous permet d établir si la carte de crédit du client est inscrite à notre programme 3D Secure. Vous permet d'envoyer une requête d'authentification, afin de valider le mot de passe d un titulaire de carte dans le cas des cartes de crédit inscrites au programme 3D Secure. Consultez la rubrique Bâtir des requêtes d annulation à la page 3-30. Consultez la rubrique Bâtir des requêtes de paiement/crédit indépendant à la page 3-34. Consultez la rubrique Bâtir des requêtes de consultation des données à la page 3-39. Consultez la rubrique Bâtir des requêtes de consultation d inscription à la page 3-43. Consultez la rubrique Bâtir des requêtes d authentification à la page 3-47. La disponibilité des types d opérations pour les cartes de crédit est attribuée aux marchands sur une base individuelle, puisque ce ne sont pas toutes les banques des marchands qui acceptent toutes les opérations. Si vous avez des questions, communiquez avec votre gestionnaire de compte. Les opérations Authorization, Purchase et Verification acceptent l objet de document ccauthrequestv1. Les opérations Authorization Reversal acceptent l objet de document ccauthreversalrequestv1. Les opérations de Settlement et Credit acceptent l objet de document ccpostauthrequestv1. Les opérations Stored Data acceptent l objet de document ccstoreddatarequestv1. Les opérations Cancel Settle, Cancel credit et Cancel payment acceptent l objet de document cccancelrequestv1. L opération Payment et Independent Credit acceptent l objet de document ccpaymentrequestv1. L opération Information Lookup accepte l objet de document cctxnlookuprequestv1. L opération Enrollment Lookup accepte l objet de document ccenrollmentlookuprequestv1. L opération Authentication accepte l objet de document ccauthenticaterequestv1. Toutes les opérations retournent une réponse cctxnresponsev1. 3-2

juillet 2014.Exemple.NET.Exemple.NET Pour bâtir l exemple pour.net : 1. Créez un nouveau projet. 2. Ajoutez une référence Web. Guide de référence de l API pour les Services Web 1.0 3-3

Transactions par carte de crédit ou de débit juillet 2014 3. Saisissez l URL WSDL et cliquez sur le bouton Ajouter une référence. Le client Web est maintenant créé. 4. Bâtissez la requête et traitez la réponse : Consultez la rubrique Bâtir des requêtes d achat, d autorisation ou de vérification àla page 3-5. Consultez la rubrique Bâtir des requêtes d inversion d autorisation à la page 3-19. Consultez la rubrique Bâtir des requêtes de règlement et de crédit à la page 3-21. Consultez la rubrique Bâtir des requêtes de données mémorisées à la page 3-26. Consultez la rubrique Bâtir des requêtes d annulation àla page 3-30. Consultez la rubrique Bâtir des requêtes de paiement/crédit indépendant à la page 3-34. Consultez la rubrique Bâtir des requêtes de consultation d inscription à la page 3-43. Consultez la rubrique Bâtir des requêtes d authentification à la page 3-47. Consultez la rubrique Traitement de la réponse à la page 3-50. 3-4

juillet 2014 Bâtir des requêtes d achat, d autorisation ou de vérification Bâtir des requêtes d achat, d autorisation ou de vérification Les requêtes Purchase, Authorization et Verification requièrent l objet de document ccauthrequestv1. La présente rubrique décrit la structure d une ccauthrequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-2 : Éléments de transaction ccauthrequestv1 à la page 3-8. Exemple de transaction d achat C# Tous les éléments facultatifs qui requièrent des types de données non nullables (ordinaires) (par ex., int ou enum) doivent avoir leur attribut specified établi à true lorsque les valeurs sont fixées pour ces éléments. Consultez l élément cardtype dans l exemple ci-dessous. Voici un exemple de transaction d achat en C#. Pour convertir cette requête en requête d autorisation ou de vérification, il suffit de remplacer la valeur «ccpurchase» (soulignée ci-dessous) par «ccauthorize» ou «ccverification» respectivement. //Prepare the call to the Credit Card Web Service CCAuthRequestV1 ccauthrequest = new CCAuthRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ccauthrequest.merchantaccount = merchantaccount; ccauthrequest.merchantrefnum = "Ref-12345"; ccauthrequest.amount = "10.00"; CardV1 card = new CardV1(); card.cardnum = "4653111111111111"; CardExpiryV1 cardexpiry = new CardExpiryV1(); cardexpiry.month = 11; cardexpiry.year = 2006; card.cardexpiry = cardexpiry; card.cardtype = CardTypeV1.VI; card.cardtypespecified = true; card.cvdindicator = 1; card.cvdindicatorspecified = true; card.cvd = "111"; ccauthrequest.card = card; BillingDetailsV1 billingdetails = new BillingDetailsV1(); billingdetails.cardpaymethod = CardPayMethodV1.WEB; //WEB = Card Number Provided billingdetails.cardpaymethodspecified = true; billingdetails.firstname = "Jeanne"; billingdetails.lastname = "Tremblay"; billingdetails.street = "123 rue Principale"; billingdetails.city = "Alma"; billingdetails.item = (object) StateV1.QC; // Québec billingdetails.country = CountryV1.CA; // Canada billingdetails.countryspecified = true; billingdetails.zip = "G0W 1G0"; billingdetails.phone = "555-555-5555"; billingdetails.email = "jeannetremblay@emailserver.com"; ccauthrequest.billingdetails = billingdetails; ccauthrequest.customerip = "127.0.0.1"; Guide de référence de l API pour les Services Web 1.0 3-5

Transactions par carte de crédit ou de débit juillet 2014 ccauthrequest.producttype = ProductTypeV1.M; //M = Both Digital and Physical(e.g., software downloaded followed by media shipment) ccauthrequest.producttypespecified = true; // Perform the Web Services call for the purchase CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.ccpurchase(ccauthrequest); // Print out the result String responsetxt = cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description + Environment.NewLine; if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } 3-6

juillet 2014 Diagramme de transaction ccauthrequestv1 Diagramme de transaction ccauthrequestv1 Une transaction ccauthrequestv1 respecte la structure suivante : Guide de référence de l API pour les Services Web 1.0 3-7

Transactions par carte de crédit ou de débit juillet 2014 Éléments de transaction ccauthrequestv1 L objet de document ccauthrequestv1 peut contenir les éléments suivants : Tableau 3-2 : Éléments de transaction ccauthrequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 merchantrefnum Oui Chaîne Max = 255 customertokenid amount Oui Chaîne Max = 999999999.99 card cardnum Oui Chaîne Min = 8 Max = 20 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Pour usage interne seulement. Il s agit du montant de la requête de transaction. REMARQUE : Bien qu elle soit obligatoire, cette valeur sera ignorée dans le cas d une transaction ccverification. Il s agit du numéro de la carte utilisée pour la transaction. cardexpiry Oui L'élément enfant cardexpiry a deux autres éléments enfants month et year. Élément enfant de cardexpiry month Oui Entier Max = 2 year Oui Entier Longueur = 4 Il s agit du mois d expiration de la carte de crédit. Il s agit de l année d expiration de la carte de crédit. 3-8

juillet 2014 Éléments de transaction ccauthrequestv1 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description cardtype Facultatif Énumération Il s agit du type de carte utilisée pour la transaction. Les valeurs possibles sont : AM = American Express DC = Diners Club DI = Discover JC = JCB LA = Laser MC = MasterCard MD = Maestro SF = Swiff SO = Solo SW = Switch VD = Visa Debit VE = Visa Electron VI = Visa issuenum Facultatif Entier Max = 2 cvdindicator Facultatif Entier Longueur = 1 cvd Conditionnel Chaîne Longueur = 3 ou 4 Le numéro à un ou deux chiffres situé à l avant de la carte, après son numéro. REMARQUE : L élément issuenum peut uniquement être utilisé lorsque cardtype correspond à MD (Maestro), SO (Solo) ou SW (Switch). Il s agit de l état de l information de la valeur CVD. Les valeurs possibles sont : 0 Le client n a pas fourni de valeur. 1 Le client a fourni une valeur. 2 La valeur est illisible. 3 La valeur n apparaît pas sur la carte. REMARQUE : L élément cvdindicator est obligatoire dans le cas d une transaction ccverification. Aussi, veuillez prendre note que même si cet élément est facultatif, il est requis lorsque plusieurs vérifications sont liées aux risques et nous vous conseillons fortement de l inclure pour éviter les transactions en échec. Le code de sécurité à trois ou quatre chiffres situé sur la carte, après son numéro. Ce code n apparaît pas sur les documents imprimés. REMARQUE : L élément cvd est obligatoire lorsque la valeur de l élément cvdindicator est 1. Guide de référence de l API pour les Services Web 1.0 3-9

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description authentication Utilisez cet élément uniquement dans le cas des requêtes ccauthorize ou ccpurchase. indicator Facultatif Entier Valeur = 1 cavv Facultatif Chaîne Max = 80 xid Facultatif Chaîne Max = 80 Il s agit du code indicateur de commerce électronique, une valeur à deux chiffres retournée par l émetteur de la carte de crédit indiquant si le titulaire de la carte a été authentifié avec succès. Les valeurs possibles sont : Visa/JCB 05 Identifie une transaction authentifiée avec succès. 06 Identifie une tentative de transaction authentifiée. 07 Identifie une transaction qui n a pas été authentifiée. MasterCard 01 Identifie une transaction qui n a pas été authentifiée. 02 Identifie une transaction authentifiée avec succès. Cette valeur est retournée dans l élément enfant eci de l élément tdsauthenticateresponse de la réponse cctxnresponsev1 à votre requête ccauthenticaterequestv1. Il s agit de la valeur de vérification de l authentification du titulaire de la carte. Cette valeur est retournée dans l élément enfant cavv de l élément tdsauthenticateresponse de la réponse cctxnresponsev1 à votre requête ccauthenticaterequestv1. Il s agit de l identifiant de transaction retourné par l émetteur de la carte. Cette valeur est retournée dans l élément enfant xid de l élément tdsauthenticateresponse de la réponse cctxnresponsev1 à votre requête ccauthenticaterequestv1. enrollmentstatus Facultatif Énumération Cela indique si le titulaire de la carte est inscrit ou non à 3D Secure. Les valeurs possibles sont : Y Authentification disponible N Titulaire de la carte non inscrit U Authentification non disponible E Erreur 3-10

juillet 2014 Éléments de transaction ccauthrequestv1 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description authenticationstatus Facultatif Énumération Cela indique le résultat de la requête d authentification. Les valeurs possibles sont : Y Le titulaire de la carte a authentifié avec succès sa carte auprès de l émetteur. A Le titulaire de la carte a tenté de l'authentifier. N Le titulaire de la carte n a pas réussi à authentifier sa carte auprès de l émetteur. U L authentification par l émetteur de la carte n était pas disponible. E Erreur authcode Facultatif Chaîne Max = 50 Il s agit du code d autorisation attribué par la banque émettrice et retourné par NETBANX pour une transaction antérieure. REMARQUE : N incluez cet élément que si NETBANX vous demande de le faire. billingdetails cardpaymethod Facultatif Énumération Il s agit de comment la carte a été présentée pour la transaction. Les valeurs possibles sont : WEB Numéro de la carte fourni en ligne TEL Numéro de la carte fourni par téléphone P Transaction avec carte PD Transaction avec carte différé D Différé REMARQUE : N incluez cet élément que si NETBANX vous demande de le faire. firstname Facultatif Chaîne Max = 40 lastname Facultatif Chaîne Max = 40 street Facultatif Chaîne Max = 50 street2 Facultatif Chaîne Max = 50 city Facultatif Chaîne Max = 40 Il s agit du prénom du client. Il s agit du nom de famille du client. Il s agit de la première ligne de l adresse municipale du client. REMARQUE : L élément street est obligatoire lorsque vous faites le traitement d une transaction ccverification. Il s agit de la deuxième ligne de l adresse municipale du client. Il s agit de la ville de résidence du client. Guide de référence de l API pour les Services Web 1.0 3-11

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description state/region Facultatif Si state (État), Énumération Si region (région), alors Chaîne Max = 40 Il s agit de l État, de la province ou de la région de résidence du client. Fournir la liste des États ou provinces pour les adresses à l intérieur des États- Unis ou du Canada. Fournir la liste des régions pour les adresses à l extérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. country Facultatif Énumération Il s agit du pays de résidence du client. Consultez la rubrique Codes de pays àla page C-3 pour connaître les bons codes à utiliser. zip Obligatoire Chaîne Max = 10 phone Facultatif Chaîne Max = 40 email Facultatif Chaîne Max = 100 Si le pays est États-Unis, il s'agit du code Zip du client ; sinon, il s'agit de son code postal. Il s agit du numéro de téléphone du client. Il s agit de l adresse de courriel du client. shippingdetails carrier Facultatif Énumération Il s agit du transporteur de l envoi. Les valeurs possibles sont : APC = APC Overnight APS = AnPost CAD = Service postal du Canada DHL FEX = FedEx RML = Royal Mail UPS = United Parcel Service USPS = United States Postal Service AUTRE shipmethod Facultatif Énumération Le mode d'expédition. Les valeurs possibles sont : N = Jour suivant/de nuit T = Deux jours C = Coût le plus bas O = Autre firstname Facultatif Chaîne Max = 40 lastname Facultatif Chaîne Max = 40 street Facultatif Chaîne Max = 50 street2 Facultatif Chaîne Max = 50 Il s agit du prénom du destinataire. Il s agit du nom de famille du destinataire. Il s agit de la première ligne de l adresse municipale du destinataire. Il s agit de la deuxième ligne de l adresse municipale du destinataire. 3-12

juillet 2014 Éléments de transaction ccauthrequestv1 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description city Facultatif Chaîne Max = 40 state/region Facultatif Si state (État), Énumération Si region (région), alors Chaîne Max = 40 Il s agit de la ville de résidence du destinataire. Il s agit de l État, de la province ou de la région de résidence du destinataire. Fournir la liste des États ou provinces pour les adresses à l intérieur des États- Unis ou du Canada. Fournir la liste des régions pour les adresses à l extérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. country Facultatif Énumération Il s agit du pays de résidence du destinataire. zip Facultatif Chaîne Max = 10 phone Facultatif Chaîne Max = 40 email Facultatif Chaîne Max = 100 Si le pays est États-Unis, il s'agit du code Zip du destinataire ; sinon, il s'agit de son code postal. Il s agit du numéro de téléphone du destinataire. Il s agit de l adresse de courriel du destinataire. recurring Facultatif recurringindicator Conditionnel Énumération Utilisez ce paramètre pour indiquer s il s agit d une transaction initiale ou d une répétition de transaction d un client précis pour lequel vous traiterez des transactions récurrentes. Selon la passerelle de traitement que vous utilisez, si la valeur pour une répétition de transaction est fixée à R, la passerelle pourra être plus indulgente à l égard de certaines exigences comme les données CVD ou les renseignements concernant l adresse, en autorisant la requête sans ces données. Les valeurs possibles sont : I Initiale récurrente R Ultérieure récurrente originalconfirmationnumber Conditionnel Chaîne Max = 20 Si c est une transaction récurrente, il s agit du numéro de confirmation renvoyé par NETBANX pour la transaction initiale de la série. Si cette valeur est incluse, NETBANX pourra identifier de façon plus précise une Autorisation à régler ou un Règlement à créditer, si l une de ces transactions est requise à l avenir. Guide de référence de l API pour les Services Web 1.0 3-13

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description previousconfirmationnumber Conditionnel Chaîne Max = 20 customerip Facultatif Chaîne Max = 50 Si c est une transaction récurrente, il s agit du numéro de confirmation renvoyé par NETBANX pour la transaction la plus récente de la série. Si cette valeur est incluse, NETBANX pourra identifier de façon plus précise une Autorisation à régler ou un Règlement à créditer, si l une de ces transactions est requise à l avenir. Il s agit de l adresse IP du client. producttype Facultatif Énumération Il s agit du type de produit vendu. Les valeurs possibles sont : P(Biens matériels) D (Produits numériques) C (Contenu numérisé) G (Bon-cadeau ou argent électronique) S (Logiciel contributif) M (Numérique et Matériel) R (Réapprovisionnement de compte) targetvirtualaccount Non Cet élément ne s applique pas aux transactions de cartes de crédit. cardriskservice Non Pour fins à l interne seulement. dupecheck Facultatif Booléen Cela valide que la requête n est pas en double. On considère qu une requête est en double lorsque cardnum, amount et merchantrefnum sont identiques. sdk version Conditionnel Chaîne Max = 20 platform Conditionnel Chaîne Max = 10 provider Conditionnel Chaîne Max = 20 addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit de la version de SDK utilisée, le cas échéant. Requis si l élément sdk est fourni. Il s agit de la langue d intégration de SDK utilisée (par ex., Java,.NET). Requis si l élément sdk est fourni. Il s agit de l auteur de SDK utilisé. Réglez cette valeur à «op» lorsque le SDK est fourni par NETBANX. Requis si l élément sdk est fourni. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. 3-14

juillet 2014 Éléments de transaction ccauthrequestv1 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description merchantdescriptor REMARQUE : Ce paramètre n est pas pris en charge par toutes les passerelles de traitement. Communiquez avec votre gestionnaire de compte pour obtenir plus de détails. dynamicdescriptor Facultatif Chaîne Max = 25 phone Facultatif Chaîne Max = 13 Il s agit du descripteur du marchand qui apparaîtra sur le relevé de carte de crédit du client. Il s agit du numéro de téléphone du marchand qui sera joint au descripteur du marchand sur le relevé de carte de crédit du client. accordd REMARQUE : N incluez cet élément que si NETBANX vous demande de le faire. financingtype Conditionnel Énumération Ceci est le type de financement offert. Les valeurs possibles sont : D Financement par paiement différé E Financement en paiements égaux plan Conditionnel Chaîne Max = 3 graceperiod Facultatif Entier Max = 2 term Facultatif Entier Max = 2 description Facultatif Chaîne Max = 255 Ceci est le numéro du plan pour cette opération de financement. Ceci est la période de grâce, en mois, associée aux transactions de paiements différés. Ceci le nombre de paiements, à raison d un par mois, associé aux transactions de paiements égaux. Il s agit d une description de la transaction, fournie par le marchand. cardentrymode Facultatif Énumération Il s agit de la méthode utilisée pour recueillir les renseignements sur la carte. Les valeurs possibles sont : SWIPED Un lecteur de carte a été utilisé. MANUAL Le numéro de la carte a été saisi manuellement. geolocation Facultatif Il s agit de l emplacement géographique où la transaction mobile a été effectuée. latitude Conditionnel Chaîne Max = 24 longitude Conditionnel Chaîne Max = 24 Il s agit de la latitude à laquelle la transaction mobile a été effectuée (par ex., 44.903889). Il s agit de la longitude à laquelle la transaction mobile a été effectuée. (par ex., - 77.255123). wallettransactionid Pour usage interne seulement. profile dateofbirth Conditionnel Ce champ vous permet d enregistrer la date de naissance du titulaire, si vous en avez. Il peut être utilisé pour aider à authentifier l identité du client avec un service de validation par une tierce partie. Guide de référence de l API pour les Services Web 1.0 3-15

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description Élément enfant de dateofbirth day Oui Entier Min = 1 Max = 31 month Oui Entier Min = 1 Max = 12 year Oui Entier Min = 1900 Max = 9999 Il s agit du jour de naissance du client. Il s agit du mois de naissance du client. Il s agit de l année de naissance du client. visaadditionalauthdata REMARQUE : Le destinataire est réputé être la personne ou la partie ayant une relation contractuelle avec le marchand ou l institution financière. Celui-ci peut ne pas être le titulaire de la carte. Par exemple, il pourrait s agir d un parent qui verse des fonds dans le compte d épargne de son enfant. Par conséquent, les informations ne devraient pas être recueillies à partir de la page de titulaire de la carte, mais devraient plutôt être transmises en arrière-plan, à partir des dossiers du marchand. recipientdateofbirth Facultatif Élément enfant de recipientdateofbirth day Conditionnel Entier Min = 1 Max = 31 month Conditionnel Entier Min = 1 Max = 12 year Conditionnel Entier Min = 1900 Max = 9999 Il s agit du jour de naissance du destinataire. Il s agit du mois de naissance du destinataire. Il s agit de l année de naissance du destinataire. recipientzip Facultatif Chaîne Max = 10 recipientlastname Facultatif Chaîne Max = 40 Il s agit du code postal du destinataire. REMARQUE : Les trois derniers caractères ne sont pas transmis au réseau bancaire. Il s agit du nom de famille du destinataire. REMARQUE : Seuls les six premiers caractères sont transmis au réseau bancaire. 3-16

juillet 2014 Paires étiquette/valeur addendumdata Tableau 3-2 : Éléments de transaction ccauthrequestv1 (suite) Élément Élément enfant Requis Type Description recipientaccountnumber Facultatif Chaîne Max = 25 Il s agit du numéro du compte du destinataire, par exemple le numéro du contrat de prêt ou l ID de client. Si le destinataire utilise une carte prépayée, le numéro complet de la carte peut être transmis. REMARQUE : Seuls les six premiers caractères et les quatre derniers caractères sont envoyés au réseau bancaire. Ceux-ci sont masqués dans le module d administration et dans les rapports, conformément à la norme PCI (Payment Card Industry). masterpass Conditionnel Vous devez ajouter cela si vous acceptez MasterPass comme mode de paiement. Les valeurs correspondant aux éléments enfants masterpass sont retournées au marchand dans une réponse de MasterCard et doivent être indiquées ici afin de remplir cette demande. paypasswalletindicator Oui Chaîne Max = 3 Cette valeur de l indicateur du portefeuille est retournée par la plateforme du portefeuille. authenticationmethod Oui Énumération Il s agit de la méthode utilisée pour authentifier le titulaire de la carte lors du paiement. MERCHANT_ONLY 3DS cardenrollmentmethod Oui Énumération Il s agit de la méthode qui a été utilisée pour ajouter la carte au portefeuille. MANUAL DIRECT_PROVISIONED 3DS_MANUAL NFC_TAP mastercardassignedid Oui Chaîne Max = 50 Cette valeur est attribuée par MasterCard et représente des programmes directement associés aux cartes Maestro. Paires étiquette/valeur addendumdata Certaines passerelles de traitement peuvent ne pas prendre en charge toutes les paires étiquette/valeur addendumdata. Communiquez avec votre gestionnaire de compte pour obtenir plus de détails. Le tableau suivant contient les paires étiquette/valeur compatibles avec l élément addendumdata. Guide de référence de l API pour les Services Web 1.0 3-17

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-3 : Paires étiquette/valeur addendumdata Étiquette CUST_ACCT_OPEN_DATE CUSTOMER_ID CUSTOMER_SESSION_ID KEYWORD MERCHANT_COUNTRY_CODE MERCHANT_SIC_CODE MERCHANT_ZIP_CODE Valeur Il s agit de la date à laquelle le compte de marchand a été ouvert. Format = aaaammjj Il s agit d un numéro d identification utilisé par le marchand. Longueur maximum de 64 caractères numériques. Cette chaîne est utilisée pour lancer un appel de consultation à l aide d un profileur de dispositif. La même chaîne doit être utilisée comme identifiant de session dans le JavaScript de profil sur la page HTML que vous présentez à votre client afin de profiler le dispositif. Les caractères acceptés sont : [a-z][a-z][_][-] Cette valeur peut correspondre au texte choisi par le marchand, par exemple, utilisé pour les fins de rapports dans le module d administration de NETBANX. Vous pouvez par exemple vous en servir comme étiquette pour identifier la transaction ou le produit acheté à votre site. Longueur maximum de 255 caractères alphanumériques. Peut être précisé plus d une fois en utilisant une valeur différente chaque fois. Valide pour les objets CCAuthRequestV1 et CCStoredDataRequestV1. Il s agit d un code de pays à deux caractères. La valeur n est pas validée. Il s agit du code ISO standard applicable à l industrie (SIC) du marchand. C est une chaîne numérique composée de quatre caractères. Longueur maximum de 10 caractères alphanumériques. PRODUCT_TYPE Il s agit du type de produit acheté. Les valeurs possibles sont : P Biens matériels D Produits numériques C Contenu numérisé G Bon-cadeau ou argent électronique S Logiciel contributif M Numérique et matériel R Réapprovisionnement de compte (par ex., renouvellement d abonnement) PRODUCT_CODE Il s agit du code de produit de l article acheté. Longueur maximum de 18 caractères alphanumériques. SERVICE_REQUEST_CURRENCY REMARQUE : Cette paire étiquette/valeur peut être ajoutée à l objet de document ccauthrequestv1 uniquement (c.-à-d. dans le cas des requêtes de transaction d autorisation, d achat et de vérification de carte). Ajoutez cette paire étiquette/valeur afin de faire inclure la devise du compte de marchand dans la réponse de transaction. Les valeurs possibles sont : on off USER_DATA_04 Il s agit d un champ défini par l utilisateur. Longueur maximum de 255 caractères alphanumériques. USER_DATA_05 Il s agit d un champ défini par l utilisateur. Longueur maximum de 255 caractères alphanumériques. USER_DATA_06 Il s agit d un champ défini par l utilisateur. Longueur maximum de 255 caractères alphanumériques. 3-18

juillet 2014 Bâtir des requêtes d inversion d autorisation Bâtir des requêtes d inversion d autorisation Les requêtes d inversion d autorisation vous permettent d inverser une partie ou la totalité d une autorisation existante, pourvu qu aucun règlement (complet ou partiel) n ait été traité à l'égard de cette autorisation. Vous pouvez seulement vous servir des transactions d inversion d autorisation pour inverser les autorisations. Vous ne pouvez pas inverser les transactions d achat. Les requêtes Authorization Reversal requièrent l objet de document ccauthreversalrequestv1. La présente rubrique décrit la structure d une requête ccauthreversalrequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-4 : Éléments de transaction ccauthreversalrequestv1 à la page 3-20. Exemple d une transaction d inversion d autorisation C# Voici un exemple de transaction d inversion d autorisation en C#. //Prepare the call to the Credit Card Web Service CCAuthReversalRequestV1 authreversalrequest = new CCAuthReversalRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; authreversalrequest.merchantaccount = merchantaccount; authreversalrequest.confirmationnumber = "115147689"; authreversalrequest.merchantrefnum = "AR2"; authreversalrequest.reversalamount = "18.00"; // Perform the Web Services call for the Auth Reversal CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.ccauthorizereversal(authreversalrequest); // Print out the result String responsetxt = cctxnresponse.confirmationnumber + " - " + cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description; responsetxt += Environment.NewLine; responsetxt += "Details:" + Environment.NewLine; if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); consoletextbox.text = responsetxt; if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } Guide de référence de l API pour les Services Web 1.0 3-19

Transactions par carte de crédit ou de débit juillet 2014 else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } Diagramme de transaction ccauthreversalrequestv1 Une transaction ccauthreversalrequestv1 respecte la structure suivante : Éléments de transaction ccauthreversalrequestv1 L objet de document ccauthreversalrequestv1 contient les éléments suivants : Tableau 3-4 : Éléments de transaction ccauthreversalrequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. 3-20

juillet 2014 Bâtir des requêtes de règlement et de crédit Tableau 3-4 : Éléments de transaction ccauthreversalrequestv1 (suite) Élément Élément enfant Requis Type Description storepwd Oui Chaîne Max = 20 confirmationnumber Oui Chaîne Max = 20 merchantrefnum Oui Chaîne Max = 255 reversalamount Facultatif Chaîne Max = 999999999.99 addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du numéro de confirmation renvoyé par NETBANX pour l autorisation que vous voulez inverser. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Il s agit du montant de l autorisation initiale que vous voulez inverser. Si vous omettez cet élément, le montant total de l autorisation initiale sera inversé. REMARQUE : Certaines passerelles de traitement peuvent ne pas prendre en charge les inversions d autorisation partielles. Communiquez avec votre gestionnaire de compte pour obtenir plus de détails. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. geolocation Facultatif Il s agit de l emplacement géographique où la transaction mobile a été effectuée. latitude Conditionnel Chaîne Max = 24 longitude Conditionnel Chaîne Max = 24 Il s agit de la latitude à laquelle la transaction mobile a été effectuée (par ex., 44.903889). Il s agit de la longitude à laquelle la transaction mobile a été effectuée. (par ex., -77.255123). Bâtir des requêtes de règlement et de crédit Les requêtes de règlement et de crédit requièrent l objet de document ccpostauthrequestv1. La présente rubrique décrit la structure d une requête ccpostauthrequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-5 : Éléments de transaction ccpostauthrequestv1 à la page 3-24. Guide de référence de l API pour les Services Web 1.0 3-21

Transactions par carte de crédit ou de débit juillet 2014 Exemple de règlement C# Voici un exemple de règlement en C#. Pour convertir cette requête en requête de crédit, il suffit de remplacer la valeur «ccsettlement» (souligné ci-dessous) par «cccredit». //Prepare the call to the Credit Card Web Service CCPostAuthRequestV1 ccpostauthrequest = new CCPostAuthRequestV1(); ccpostauthrequest.confirmationnumber = "123456"; MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid= "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ccpostauthrequest.merchantaccount = merchantaccount; ccpostauthrequest.merchantrefnum = "Ref-12345"; ccpostauthrequest.amount = "10.00"; // Perform the Web Service call for the Settlement CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.ccsettlement(ccpostauthrequest); // Print out the result String responsetxt = cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description ; responsetxt += "Details:" + Environment.NewLine; if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } 3-22

juillet 2014 Diagramme de transaction ccpostauthrequestv1 Diagramme de transaction ccpostauthrequestv1 L objet de document ccpostauthrequestv1 respecte la structure suivante : Guide de référence de l API pour les Services Web 1.0 3-23

Transactions par carte de crédit ou de débit juillet 2014 Éléments de transaction ccpostauthrequestv1 L objet de document ccpostauthrequestv1 peut contenir les éléments suivants : Tableau 3-5 : Éléments de transaction ccpostauthrequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 20 storepwd Oui Chaîne Max = 20 confirmationnumber Oui Chaîne Max = 20 merchantrefnum Oui Chaîne Max = 40 amount Facultatif Chaîne Max = 999999999.99 origmerchanttxn Conditionnel Chaîne Max = 255 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du numéro de confirmation retourné par NETBANX pour la requête initiale. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Il s agit du montant de la requête de transaction. Vous pouvez régler la totalité ou une partie d une autorisation. Vous pouvez créditer la totalité ou une partie d un règlement. Il s agit du numéro d identification de la transaction de règlement du marchand qui a été traitée au moyen de l API de paiement direct et qui est maintenant créditée au moyen de l'api des Services Web. dupecheck Facultatif Booléen Cela valide que la requête n est pas en double. On considère qu une requête est en double lorsque cardnum, amount et merchantrefnum sont identiques. sdk version Conditionnel Chaîne Max = 20 platform Conditionnel Chaîne Max = 10 Il s agit de la version de SDK utilisée, le cas échéant. Requis si l élément sdk est fourni. Il s agit de la langue d intégration de SDK utilisée (par ex., Java,.NET). Requis si l élément sdk est fourni. 3-24

juillet 2014 Éléments de transaction ccpostauthrequestv1 Tableau 3-5 : Éléments de transaction ccpostauthrequestv1 (suite) Élément Élément enfant Requis Type Description provider Conditionnel Chaîne Max = 20 addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit de l auteur de SDK utilisé. Réglez cette valeur à «op» lorsque le SDK est fourni par NETBANX. Requis si l élément sdk est fourni. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. geolocation Facultatif Il s agit de l emplacement géographique où la transaction mobile a été effectuée. latitude Conditionnel Chaîne Max = 24 longitude Conditionnel Chaîne Max = 24 Il s agit de la latitude à laquelle la transaction mobile a été effectuée (par ex., 44.903889). Il s agit de la longitud accordd REMARQUE : N incluez cet élément que si NETBANX vous demande de le faire. Facultatif e à laquelle la transaction mobile a été effectuée. (par ex., -77.255123). Vous pouvez inclure l élément accordd seulement si vous l avez déjà fourni dans la requête d autorisation que vous complétez actuellement et si vous voulez changer un ou plusieurs termes spécifiques dans les éléments enfants. financingtype Conditionnel Énumération Ceci est le type de financement offert. Les valeurs possibles sont : D Financement par paiement différé E Financement en paiements égaux plan Conditionnel Chaîne Max = 3 graceperiod Facultatif Entier Max = 2 term Facultatif Entier Max = 2 Ceci est le numéro du plan pour cette opération de financement. Ceci est la période de grâce, en mois, associée aux transactions de paiements différés. Ceci le nombre de paiements, à raison d un par mois, associé aux transactions de paiements égaux. Guide de référence de l API pour les Services Web 1.0 3-25

Transactions par carte de crédit ou de débit juillet 2014 Bâtir des requêtes de données mémorisées Les requêtes d'autorisation et d achat faites à partir de données mémorisées requièrent l objet de document ccstoreddatarequestv1. La présente rubrique décrit la structure d une requête ccstoreddatarequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-6 : Éléments de transaction ccstoreddatarequestv1 à la page 3-28. Les requêtes à partir de données mémorisées vous permettent d effectuer des autorisations de cartes de crédit et des achats en fournissant un minimum de renseignements sur le client. Les requêtes à partir de données mémorisées exigent un numéro de confirmation provenant d une autorisation et d un achat fait précédemment. Ce numéro de confirmation permet à NETBANX d obtenir de sa base de données la plupart des données requises pour la transaction. Exemple d autorisation à partir de données mémorisées C# Voici un exemple d autorisation à partir de données mémorisées en C#. Pour convertir cette requête en requête d achat à partir de données mémorisées, il suffit de remplacer la valeur «ccstoreddataauthorize» (soulignée ci-dessous) par «ccstoreddatapurchase». //Prepare the call to the Credit Card Web Service MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; CCStoredDataRequestV1 ccstoreddatarequest = new CCStoredDataRequestV1(); ccstoreddatarequest.confirmationnumber = "111374429"; ccstoreddatarequest.amount = "97.97"; ccstoreddatarequest.merchantrefnum = "jim55"; ccstoreddatarequest.merchantaccount = merchantaccount; // Perform the Web Service call for the Stored Data Transaction CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.ccstoreddataauthorize(ccstoreddatarequest); String responsetxt = ""; // Print out the result if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { 3-26

juillet 2014 Exemple d autorisation à partir de données mémorisées C# } System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); Guide de référence de l API pour les Services Web 1.0 3-27

Transactions par carte de crédit ou de débit juillet 2014 Diagramme de transaction ccstoreddatarequestv1 L'objet de document ccstoreddatarequestv1 respecte la structure suivante : Éléments de transaction ccstoreddatarequestv1 L objet de document ccstoreddatarequestv1 peut contenir les éléments suivants : Tableau 3-6 : Éléments de transaction ccstoreddatarequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Requis Chaîne Max = 10 storeid Requis Chaîne Max = 20 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. 3-28

juillet 2014 Éléments de transaction ccstoreddatarequestv1 Tableau 3-6 : Éléments de transaction ccstoreddatarequestv1 (suite) Élément Élément enfant Requis Type Description storepwd Requis Chaîne Max = 20 merchantrefnum Requis Chaîne Max = 255 confirmationnumber Requis Chaîne Max = 20 amount Requis Chaîne Max = 999999999.99 cardexpiry month Facultatif Entier Max = 2 year Facultatif Entier Longueur = 4 cvdindicator Facultatif Entier Longueur = 1 Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Il s agit du numéro de confirmation retourné par NETBANX pour la requête initiale. REMARQUE : Le confirmationnumber peut avoir une période maximale de 13 mois. Il s agit du montant de la requête de transaction. Il s agit du mois d expiration de la carte de crédit. Utilisez cet élément pour inclure l information mise à jour sur la date d expiration de la carte de crédit, lorsque requise, qui sera incluse avec le reste des données de la transaction. Il s agit de l année d expiration de la carte de crédit. Utilisez cet élément pour inclure l information mise à jour sur la date d expiration de la carte de crédit, lorsque requise, qui sera incluse avec le reste des données de la transaction. Il s agit de l état de l information de la valeur CVD. Les valeurs possibles sont : 0 Le client n a pas fourni de valeur. 1 Le client a fourni une valeur. 2 La valeur est illisible. 3 La valeur n apparaît pas sur la carte. Guide de référence de l API pour les Services Web 1.0 3-29

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-6 : Éléments de transaction ccstoreddatarequestv1 (suite) Élément Élément enfant Requis Type Description cvd Conditionnel Chaîne Longueur = 3 ou 4 addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Le code de sécurité à trois ou quatre chiffres situé sur la carte, après son numéro. Ce code n apparaît pas sur les documents imprimés. Lorsque l on fournit la valeur CVD pour effectuer une requête à partir de données mémorisées, la transaction bénéficie de la protection complète offerte par le procédé CVD. Cependant, vous ne devez jamais enregistrer les données CVD des clients : elles doivent être fournies par le client pour chaque requête. REMARQUE : L élément cvd est obligatoire lorsque la valeur de l élément cvdindicator est 1. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Bâtir des requêtes d annulation Utilisez l objet de document cccancelrequestv1 pour annuler les transactions Settle, Credit, Payment, and Independent Credit. La présente rubrique décrit la structure d une requête cccancelrequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-7 : Éléments de transaction cccancelrequestv1 à la page 3-33. Exemple d annulation de règlement C# Voici un exemple d annulation de règlement en C#. Pour convertir cette requête en requête d annulation de crédit, de paiement, ou de crédit indépendant, il suffit de remplacer la valeur «cccancelsettle» (souligné ci-dessous) par «cccancelcredit», «cccancelpayment», ou «cccancelindependentcredit» respectivement. //Prepare the call to the Credit Card Web Service CCCancelRequestV1 cccancelrequest = new CCCancelRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid= "mystoreid"; merchantaccount.storepwd = "mystorepwd"; cccancelrequest.merchantaccount = merchantaccount; cccancelrequest.confirmationnumber = "123456"; 3-30

juillet 2014 Exemple d annulation de règlement C# // Perform the Web Services call for the cancel settle CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.cccancelsettle(cccancelrequest); // Print out the result String responsetxt = cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description ; responsetxt += "Details:" + Environment.NewLine; if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } Guide de référence de l API pour les Services Web 1.0 3-31

Transactions par carte de crédit ou de débit juillet 2014 Diagramme de transaction cccancelrequestv1 L objet de document cccancelrequestv1 respecte la structure suivante : 3-32

juillet 2014 Éléments de transaction cccancelrequestv1 Éléments de transaction cccancelrequestv1 L objet de document cccancelrequestv1 peut contenir les éléments suivants : Tableau 3-7 : Éléments de transaction cccancelrequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 20 storepwd Oui Chaîne Max = 20 confirmationnumber Oui Chaîne Max = 20 sdk version Conditionnel Chaîne Max = 20 platform Conditionnel Chaîne Max = 10 provider Conditionnel Chaîne Max = 20 addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du numéro de confirmation retourné par NETBANX pour la requête initiale de règlement ou de crédit. Il s agit de la version de SDK utilisée, le cas échéant. Requis si l élément sdk est fourni. Il s agit de la langue d intégration de SDK utilisée (par ex., Java,.NET). Requis si l élément sdk est fourni. Il s agit de l auteur de SDK utilisé. Réglez cette valeur à «op» lorsque le SDK est fourni par NETBANX. Requis si l élément sdk est fourni. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. geolocation Facultatif Il s agit de l emplacement géographique où la transaction mobile a été effectuée. latitude Conditionnel Chaîne Max = 24 Il s agit de la latitude à laquelle la transaction mobile a été effectuée (par ex., 44.903889). Guide de référence de l API pour les Services Web 1.0 3-33

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-7 : Éléments de transaction cccancelrequestv1 (suite) Élément Élément enfant Requis Type Description longitude Conditionnel Chaîne Max = 24 Il s agit de la longitude à laquelle la transaction mobile a été effectuée. (par ex., - 77.255123). Bâtir des requêtes de paiement/crédit indépendant Le paiement et le crédit indépendant requièrent l objet de document ccpaymentrequestv1. La présente rubrique décrit la structure d une requête ccpaymentrequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-8 : Éléments de transaction ccpaymentrequestv1 à la page 3-36. Exemple de paiement C# Tous les éléments facultatifs qui requièrent des types de données non nullables (ordinaires) (par ex., int ou enum) doivent avoir leur attribut specified établi à true lorsque les valeurs sont fixées pour ces éléments. Consultez l élément cardtype dans l exemple ci-dessous. Voici un exemple de paiement en C#. Pour convertir cette requête en requête de crédit indépendant, il suffit de remplacer la valeur «ccpayment» (souligné ci-dessous) par «ccindependentcredit». //Prepare the call to the Credit Card Web Service CCPaymentRequestV1 ccpaymentrequest = new CCPaymentRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; ccpaymentrequest.merchantaccount = merchantaccount; ccpaymentrequest.merchantrefnum = "Ref-12345"; ccpaymentrequest.amount = "10.00"; CardV1 card = new CardV1(); card.cardnum = "4653111111111111"; CardExpiryV1 cardexpiry = new CardExpiryV1(); cardexpiry.month = 11; cardexpiry.year = 2006; card.cardexpiry = cardexpiry; card.cardtype = CardTypeV1.VI; card.cardtypespecified = true; card.cvdindicator = 1; card.cvdindicatorspecified = true; card.cvd = "111"; ccpaymentrequest.card = card; BillingDetailsV1 billingdetails = new BillingDetailsV1(); billingdetails.cardpaymethod = CardPayMethodV1.WEB; //WEB = Card Number Provided billingdetails.cardpaymethodspecified = true; billingdetails.firstname = "Jeanne"; billingdetails.lastname = "Tremblay"; billingdetails.street = "123 rue Principale"; 3-34

juillet 2014 Diagramme de transaction ccpaymentrequestv1 billingdetails.city = "Alma"; billingdetails.item = (object)statev1.qc; // Québec billingdetails.country = CountryV1.CA; // Canada billingdetails.countryspecified = true; billingdetails.zip = "90210"; billingdetails.phone = "555-555-5555"; billingdetails.email = "jeannetremblay@emailserver.com"; ccpaymentrequest.billingdetails = billingdetails; // Perform the Web Services call for the payment request CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.ccpayment(ccpaymentrequest); // Print out the result String responsetxt cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description ; responsetxt += "Details:" + Environment.NewLine; if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } } catch (WebException we) { consoletextbox.text += we.message.tostring(); consoletextbox.refresh(); } Diagramme de transaction ccpaymentrequestv1 Une transaction ccpaymentrequestv1 respecte la structure suivante : Guide de référence de l API pour les Services Web 1.0 3-35

Transactions par carte de crédit ou de débit juillet 2014 Éléments de transaction ccpaymentrequestv1 L objet de document ccpaymentrequestv1 peut contenir les éléments suivants : Tableau 3-8 : Éléments de transaction ccpaymentrequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 merchantrefnum Oui Chaîne Max = 40 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. 3-36

juillet 2014 Éléments de transaction ccpaymentrequestv1 Tableau 3-8 : Éléments de transaction ccpaymentrequestv1 (suite) Élément Élément enfant Requis Type Description amount Oui Chaîne Il s agit du montant de la requête de transaction. Le montant maximum pour les marchands est configuré sur une base individuelle. Il s applique à chaque transaction et au maximum quotidien de la carte de crédit. Communiquez avec votre gestionnaire de compte pour obtenir plus de détails. card cardnum Oui Chaîne Min = 8 Max = 20 Il s agit du numéro de la carte utilisée pour la transaction. cardexpiry Oui L'élément enfant cardexpiry a deux autres éléments enfants month et year. Élément enfant de cardexpiry month Oui Entier Max = 2 year Oui Entier Longueur = 4 Il s agit du mois d expiration de la carte de crédit. Il s agit de l année d expiration de la carte de crédit. cardtype Facultatif Énumération Il s agit du type de carte utilisée pour la transaction. Les valeurs possibles sont : AM = American Express DC = Diners Club DI = Discover JC = JCB LA = Laser MC = MasterCard MD = Maestro SO = Solo SW = Switch VD = Visa Debit VE = Visa Electron VI = Visa issuenum Facultatif Entier Max = 2 Le numéro à un ou deux chiffres situé à l avant de la carte, après son numéro. REMARQUE : L élément issuenum peut uniquement être utilisé lorsque cardtype correspond à MD (Maestro), SO (Solo) ou SW (Switch). Guide de référence de l API pour les Services Web 1.0 3-37

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-8 : Éléments de transaction ccpaymentrequestv1 (suite) Élément Élément enfant Requis Type Description cvdindicator Facultatif Entier Longueur = 1 cvd Conditionnel Chaîne Longueur = 3 ou 4 Il s agit de l état de l information de la valeur CVD. Les valeurs possibles sont : 0 Le client n a pas fourni de valeur. 1 Le client a fourni une valeur. 2 La valeur est illisible. 3 La valeur n apparaît pas sur la carte. REMARQUE : Même si cet élément est facultatif, il est requis dans le cas de plusieurs vérifications liées aux risques et nous vous conseillons fortement de l inclure pour éviter les transactions en échec. Le code de sécurité à trois ou quatre chiffres situé sur la carte, après son numéro. Ce code n apparaît pas sur les documents imprimés. REMARQUE : L élément cvd est obligatoire lorsque la valeur de l élément cvdindicator est 1. billingdetails cardpaymethod Pour usage interne seulement. firstname Facultatif Chaîne Max = 40 lastname Facultatif Chaîne Max = 40 street Facultatif Chaîne Max = 50 street2 Facultatif Chaîne Max = 50 city Facultatif Chaîne Max = 40 state/region Facultatif Si state (État), Énumération Si region (région), alors Chaîne Max = 40 Il s agit du prénom du client. Il s agit du nom de famille du client. Il s agit de la première ligne de l adresse municipale du client. Il s agit de la deuxième ligne de l adresse municipale du client. Il s agit de la ville de résidence du client. Il s agit de l État, de la province ou de la région de résidence du client. Fournir la liste des États ou provinces pour les adresses à l intérieur des États-Unis ou du Canada. Fournir la liste des régions pour les adresses à l extérieur des États-Unis ou du Canada. Consultez la rubrique Annexe C : Codes géographiques pour connaître les bons codes à utiliser. country Facultatif Énumération Il s agit du pays de résidence du client. Consultez la rubrique Codes de pays àla page C-3 pour connaître les bons codes à utiliser. zip Obligatoire Chaîne Max = 10 Si le pays est États-Unis, il s'agit du code Zip du client ; sinon, il s'agit de son code postal. 3-38

juillet 2014 Bâtir des requêtes de consultation des données Tableau 3-8 : Éléments de transaction ccpaymentrequestv1 (suite) Élément Élément enfant Requis Type Description phone Facultatif Chaîne Max = 40 email Facultatif Chaîne Max = 100 sdk version Conditionnel Chaîne Max = 20 platform Conditionnel Chaîne Max = 10 provider Conditionnel Chaîne Max = 20 addendumdata tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit du numéro de téléphone du client. Il s agit de l adresse de courriel du client. Il s agit de la version de SDK utilisée, le cas échéant. Requis si l élément sdk est fourni. Il s agit de la langue d intégration de SDK utilisée (par ex., Java,.NET). Requis si l élément sdk est fourni. Il s agit de l auteur de SDK utilisé. Réglez cette valeur à «op» lorsque le SDK est fourni par NETBANX. Requis si l élément sdk est fourni. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Il s agit de données supplémentaires qui peuvent être incluses dans la requête de transaction. Consultez la rubrique Paires étiquette/valeur addendumdata à la page 3-17 pour obtenir plus de détails. Bâtir des requêtes de consultation des données La requête de consultation des données vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les transactions traités par votre compte de marchand. Par exemple, vous pouvez vouloir déterminer le résultat d une transaction qui a eu un temps mort, n ayant pas de retour de réponse, ou le résultat d une transaction en lot qui est refusée à une date ultérieure. Vous pouvez rechercher les types de transactions suivants : autorisation achat règlement crédit paiement/crédit indépendant Guide de référence de l API pour les Services Web 1.0 3-39

Transactions par carte de crédit ou de débit juillet 2014 Exemple de consultation des données C# Voici un exemple de consultation des données en C#. // Prepare the call to the Credit Card Web Service CCTxnLookupRequestV1 cctxnlookuprequest = new CCTxnLookupRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; cctxnlookuprequest.merchantaccount = merchantaccount; cctxnlookuprequest.merchantrefnum = "123456789"; DateV1 startdate = new DateV1(); startdate.year = "2012"; startdate.month = "08"; startdate.day = "15"; startdate.hour = "11"; startdate.minute = "00"; startdate.second = "00"; cctxnlookuprequest.startdate = startdate; DateV1 enddate = new DateV1(); enddate.year = "2012"; enddate.month = "08"; enddate.day = "15"; enddate.hour = "14"; enddate.minute = "00"; enddate.second = "00"; cctxnlookuprequest.enddate = enddate; //Perform the Web Services call to process the request CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.cctxnlookup(cctxnlookuprequest); // Print out the result String responsetxt = cctxnresponse.code + " - " + cctxnresponse.decision; responsetxt += "Transactions:" + Environment.NewLine; if (cctxnresponse.transaction!= null) { for (int i = 0; i < cctxnresponse.txnlookupresult.length; i++) { responsetxt += " - confirmationnumber: " + cctxnresponse.txnlookupresult[i].confirmationnumber + Environment.NewLine; responsetxt += " - decison: " + cctxnresponse.txnlookupresult[i].decision + Environment.NewLine; responsetxt += " - code: " + cctxnresponse.txnlookupresult[i].code + Environment.NewLine; responsetxt += " - transaction type: " + cctxnresponse.txnlookupresult[i].trantype + Environment.NewLine; responsetxt += " - transaction time: " + cctxnresponse.txnlookupresult[i].txntime + Environment.NewLine; responsetxt += " - merchantrefnum: " + cctxnresponse.txnlookupresult[i].merchantrefnum + Environment.NewLine; responsetxt += " - card ending: " + cctxnresponse.txnlookupresult[i].cardending + Environment.NewLine; responsetxt += " - card ending: " + cctxnresponse.txnlookupresult[i].cardending + Environment.NewLine; 3-40

juillet 2014 Diagramme de transaction cctxnlookuprequestv1 CardExpiryV1 expiry = cctxnresponse.txnlookupresult[i].cardexpiry; responsetxt += " - card expiry: " + expiry.month + "/" + expiry.year + Environment.NewLine; } responsetxt += Environment.NewLine + Environment.NewLine; } System.Console.WriteLine(responseTxt); Diagramme de transaction cctxnlookuprequestv1 Une transaction cctxnlookuprequestv1 respecte la structure suivante : Éléments de transaction cctxnlookuprequestv1 L objet de document cctxnlookuprequestv1 peut contenir les éléments suivants : Guide de référence de l API pour les Services Web 1.0 3-41

Transactions par carte de crédit ou de débit juillet 2014 Table 3-9: Éléments de transaction cctxnlookuprequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 20 storepwd Oui Chaîne Max = 20 confirmationnumber Facultatif Chaîne Max = 20 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. This is the confirmation number returned by NETBANX in response to the original request. Include this element only if you want to search using this field. This field takes precedence over the merchantrefnum field. REMARQUE : Si vous incluez cet élément, vous n avez pas à spécifier les éléments startdate ou enddate. netbanxreference Facultatif Chaîne Il s agit d un numéro de transaction utilisé pour identifier certaines transactions existantes. REMARQUE : Si vous incluez cet element, vous devez spécifier les éléments startdate et enddate. merchantrefnum Facultatif Chaîne Max = 255 startdate year Conditionnel Int Max = 9999 month Conditionnel Int Min = 1 Max = 12 day Conditionnel Int Min = 1 Max = 31 hour Conditionnel Int Min = 0 Max = 23 Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. REMARQUE : Si vous incluez cet element, vous devez spécifier les éléments startdate et enddate. Il s agit de l année fixée pour le début de la recherche. Il s agit du mois fixé pour le début de la recherche. Il s agit du jour fixé pour le début de la recherche. Il s agit de l heure fixée pour le début de la recherche. 3-42

juillet 2014 Bâtir des requêtes de consultation d inscription Table 3-9: Éléments de transaction cctxnlookuprequestv1 (suite) Élément Élément enfant Requis Type Description minute Conditionnel Int Min = 0 Max = 59 second Conditionnel Int Min = 0 Max = 59 enddate year Conditionnel Int Max = 9999 month Conditionnel Int Min = 1 Max = 12 day Conditionnel Int Min = 1 Max = 31 hour Conditionnel Int Min = 0 Max = 23 minute Conditionnel Int Min = 0 Max = 59 second Conditionnel Int Min = 0 Max = 59 Il s agit de la minute fixée pour le début de la recherche. Il s agit de la seconde fixée pour le début de la recherche. Il s agit de l année fixée pour la fin de la recherche. Il s agit du mois fixé pour la fin de la recherche. Il s agit du jour fixé pour la fin de la recherche. Il s agit de l heure fixée pour la fin de la recherche. Il s agit de la minute fixée pour la fin de la recherche. Il s agit de la seconde fixée pour la fin de la recherche. Bâtir des requêtes de consultation d inscription Utilisez la requête de consultation d inscription afin d établir si la carte de crédit du titulaire de la carte est inscrite au programme 3D Secure. Les requêtes de consultation d inscription exigent l objet de document ccenrollmentlookuprequestv1. La présente rubrique décrit la structure d une requête ccenrollmentlookuprequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-10 : Éléments de transaction ccenrollmentlookuprequestv1 àla page 3-46. Exemple de consultation d inscription C# Voici un exemple de consultation d inscription en C#. Tous les éléments facultatifs qui requièrent des types de données non nullables (ordinaires) (par ex., int ou enum) doivent avoir leur attribut specified établi à true lorsque les valeurs sont fixées pour ces éléments. Consultez l élément cardtype dans l exemple ci-dessous. Guide de référence de l API pour les Services Web 1.0 3-43

Transactions par carte de crédit ou de débit juillet 2014 //Prepare the call to the Credit Card Web Service CCEnrollmentLookupRequestV1 enrollmentlookuprequest = new CCEnrollmentLookupRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; enrollmentlookuprequest.merchantaccount = merchantaccount; enrollmentlookuprequest.merchantrefnum = "Ref-12345"; enrollmentlookuprequest.amount = "97.97"; CardV1 card = new CardV1(); card.cardnum = "4653111111111111"; CardExpiryV1 cardexpiry = new CardExpiryV1(); cardexpiry.month = 11; cardexpiry.year = 2013; card.cardexpiry = cardexpiry; card.cardtype = CardTypeV1.VI; card.cardtypespecified = true; enrollmentlookuprequest.card = card; // Perform the Web Services call for the TDS Enrollment Lookup CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.cctdslookup(enrollmentlookuprequest); // Print out the result String responsetxt = cctxnresponse.confirmationnumber + " - " + cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description; responsetxt += Environment.NewLine; responsetxt += "Details:" + Environment.NewLine; if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt += "TDSResponse:" + Environment.NewLine; if (cctxnresponse.tdsresponse!= null) { responsetxt += " - " + cctxnresponse.tdsresponse.acsurl + Environment.NewLine; responsetxt += " - " + cctxnresponse.tdsresponse.paymentrequest + Environment.NewLine; responsetxt += " - " + cctxnresponse.tdsresponse.enrollmentstatus + Environment.NewLine; responsetxt += " - " + cctxnresponse.tdsresponse.eci + Environment.NewLine; } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); consoletextbox.text = responsetxt; if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } 3-44

juillet 2014 Diagramme de transaction ccenrollmentlookuprequestv1 else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } Diagramme de transaction ccenrollmentlookuprequestv1 Une transaction ccenrollmentlookuprequestv1 respecte la structure suivante : Éléments de transaction ccenrollmentlookuprequestv1 L objet de document ccenrollmentlookuprequestv1 peut contenir les éléments suivants : Guide de référence de l API pour les Services Web 1.0 3-45

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-10 : Éléments de transaction ccenrollmentlookuprequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 20 storepwd Oui Chaîne Max = 20 merchantrefnum Oui Chaîne Max = 255 amount Oui Chaîne Max = 999999999.99 card cardnum Oui Chaîne Min = 8 Max = 20 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction ; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Il s agit du montant de la requête de transaction. REMARQUE : Bien que l élément amount soit obligatoire dans le cas d une transaction Enrollment Lookup, le montant n est pas imputé à la carte de crédit. Il s agit du numéro de la carte utilisée pour la transaction. cardexpiry Oui L'élément enfant cardexpiry a deux autres éléments enfants month et year. Élément enfant de cardexpiry month Oui Entier Max = 2 year Oui Entier Longueur = 4 Il s agit du mois d expiration de la carte de crédit. Il s agit de l année d expiration de la carte de crédit. cardtype Facultatif Énumération Il s agit du type de carte utilisée pour la transaction. Les valeurs possibles sont : JC = JCB MC = MasterCard VI = Visa issuenum Facultatif Entier Max = 2 Le numéro à un ou deux chiffres situé à l avant de la carte, après son numéro. REMARQUE : L élément issuenum n est pas utilisé pour ce type de requête. 3-46

juillet 2014 Bâtir des requêtes d authentification Tableau 3-10 : Éléments de transaction ccenrollmentlookuprequestv1 (suite) Élément Élément enfant Requis Type Description cvdindicator Facultatif Entier Longueur = 1 cvd Conditionnel Chaîne Longueur = 3 ou 4 Il s agit de l état de l information de la valeur CVD. Les valeurs possibles sont : 0 Le client n a pas fourni de valeur. 1 Le client a fourni une valeur. 2 La valeur est illisible. 3 La valeur n apparaît pas sur la carte. REMARQUE : L élément cvdindicator n est pas utilisé pour ce type de requête. Le code de sécurité à trois ou quatre chiffres situé sur la carte, après son numéro. Ce code n apparaît pas sur les documents imprimés. REMARQUE : L élément cvd n est pas utilisé pour ce type de requête. Bâtir des requêtes d authentification Utilisez la requête d authentification pour permettre au titulaire de la carte d authentifier sa carte auprès de l émetteur et de récupérer les valeurs requises pour l élément authentication d une transaction ccauthrequestv1. Les requêtes d authentication requièrent l objet de document ccauthenticaterequestv1. La présente rubrique décrit la structure d une requête ccauthenticaterequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 3-11 : Éléments de transaction ccauthenticaterequestv1 à la page 3-49. Exemple d authentification C# Voici un exemple d authentification en C#. //Prepare the call to the Credit Card Web Service CCAuthenticateRequestV1 authenticaterequest = new CCAuthenticateRequestV1(); MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; authenticaterequest.merchantaccount = merchantaccount; authenticaterequest.confirmationnumber = "myconfirmationnumber"; authenticaterequest.paymentresponse = "mypaymentresponse"; // Perform the Web Services call for the authentication CreditCardServiceV1 ccservice = new CreditCardServiceV1(); CCTxnResponseV1 cctxnresponse = ccservice.cctdsauthenticate(authenticaterequest); // Print out the result String responsetxt = cctxnresponse.confirmationnumber + " - " + cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description; responsetxt += Environment.NewLine; responsetxt += "Details:" + Environment.NewLine; if (cctxnresponse.detail!= null) { Guide de référence de l API pour les Services Web 1.0 3-47

Transactions par carte de crédit ou de débit juillet 2014 for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); consoletextbox.text = responsetxt; if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } Diagramme de transaction ccauthenticaterequestv1 Une transaction ccauthenticaterequestv1 respecte la structure suivante : Éléments de transaction ccauthenticaterequestv1 L objet de document ccauthenticaterequestv1 peut contenir les éléments suivants : 3-48

juillet 2014 Éléments de transaction ccauthenticaterequestv1 Tableau 3-11 : Éléments de transaction ccauthenticaterequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 20 storepwd Oui Chaîne Max = 20 confirmationnumber Oui Chaîne Max = 20 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du numéro de confirmation de cctxnresponsev1 retourné par NETBANX en réponse à ccenrollmentlookuprequestv1. paymentresponse Oui Chaîne Il s agit de la réponse d authentification de paiement retournée par la banque émettrice au moyen du navigateur Web de votre client une fois qu il a fourni ses renseignements d authentification. Il s agit d une réponse codée générée par le logiciel d ACS de l émetteur. La signature électronique sera vérifiée par NETBANX pour s assurer qu elle a été générée par un émetteur légitime. merchantrefnum Facultatif Chaîne Max = 255 Il s agit d un numéro d identification (ID) unique, associé à chaque requête. La valeur est créée par le marchand et envoyée en tant qu élément de la requête. Guide de référence de l API pour les Services Web 1.0 3-49

Transactions par carte de crédit ou de débit juillet 2014 Traitement de la réponse Une transaction cctxnresponsev1 respecte la structure suivante : 3-50

juillet 2014 Traitement de la réponse Les éléments suivants sont pertinents dans le cas d une réponse cctxnresponsev1 : Tableau 3-12 : Éléments d une transaction cctxnresponsev1 Élément Élément enfant Requis Type Description confirmationnumber Oui Chaîne Max = 20 merchantrefnum Facultatif Chaîne Max = 255 childaccountnum Facultatif Chaîne Max = 10 Il s agit du numéro de confirmation retourné par NETBANX. Il s agit du numéro d identification unique qui a été créé par le marchand et soumis dans la requête. Il s agit du numéro de compte de marchand enfant et il n est fourni que si la transaction a été traitée au moyen d un compte principal. decision Oui Énumération Il s agit de l état de la transaction. Une des valeurs suivantes sera retournée : Accepted La transaction a été traitée. Error La tentative de transaction a échoué en raison d une erreur. Declined La transaction a été refusée avant qu elle soit envoyée pour traitement. Hold La transaction a été mis en attente en raison de considérations de risque. code Oui Entier Il s agit d un code numérique servant à catégoriser la réponse. Consultez la rubrique Codes de réponse àla page B-1. actioncode Facultatif Énumération Ceci indique l action que l appelant devrait effectuer. Les valeurs possibles sont : C = Erreur de paramètre du client. Les renseignements fournis par le client sont incorrects. Confirmez les renseignements auprès du client. D = Ne pas réessayer. Les tentatives subséquentes échoueront. M = Erreur de paramètre du marchand. Les renseignements fournis par votre application sont incorrects. Vérifiez vos renseignements. R = Réessayer. Le problème est temporaire. La prochaine tentative réussira probablement. description Oui Chaîne Max = 1024 authcode Facultatif Chaîne Max = 20 Il s agit de la description accessible à l utilisateur de l élément code. Il s agit du code d autorisation attribué par la banque émettrice et retourné par NETBANX. Guide de référence de l API pour les Services Web 1.0 3-51

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-12 : Éléments d une transaction cctxnresponsev1 (suite) Élément Élément enfant Requis Type Description avsresponse Facultatif Énumération Il s agit de la réponse AVS de l émetteur de la carte. Les valeurs possibles sont : X Exact. Correspondance entre le code Zip de neuf chiffres et l adresse. Y Oui. Correspondance entre le code Zip de cinq chiffres et l adresse. A L adresse correspond, mais le code Zip ne correspond pas. W Le code Zip de neuf chiffres correspond, mais l adresse ne correspond pas. Z Le code Zip de cinq chiffres correspond, mais l adresse ne correspond pas. N Aucun élément de l adresse ne correspond. U L information sur l adresse n est pas disponible. R Réessayer. Le système est incapable de faire le traitement. S L AVS n est pas pris en charge. E L AVS n est pas pris en charge dans le cas de cette industrie. B L AVS n a pas été exécuté. Q Réponse inconnue de l'émetteur/banknet switch. cvdresponse Facultatif Énumération Il s agit de la réponse à l élément cvdvalue soumis dans la requête de transaction. Les valeurs possibles sont : M (Match) La valeur CVD fournie correspond à la valeur CVD associée à la carte. N (No Match) La valeur CVD fournie ne correspond pas à la valeur CVD associée à la carte. P (Not Processed) La valeur CVD n a pas été traitée. Q (Unknown Response) Aucun résultat n a été reçu concernant la valeur CVD. S (Not Present) Le CVD devrait apparaître sur la carte. Toutefois, le titulaire de la carte a indiqué qu il n y était pas. U L émetteur n est pas certifié ou il n a pas fourni les clés de chiffrement Visa. detail tag Facultatif Chaîne Max = 30 value Facultatif Chaîne Max = 1024 Il s agit de la paire étiquette/valeur retournée comme composante de l élément detail. Consultez la rubrique Paires étiquette/valeur detail à la page 3-57 pour obtenir plus de détails. 3-52

juillet 2014 Traitement de la réponse Tableau 3-12 : Éléments d une transaction cctxnresponsev1 (suite) Élément Élément enfant Requis Type Description txntime Oui datetime Il s agit de la date et de l heure auxquelles la transaction a été traitée par NETBANX. duplicatefound Oui Booléen Cela indique si cette transaction est une transaction en double, lorsqu une vérification en double a été demandée. duplicatetransaction Response tdsresponse Cet élément et ses éléments enfants sont seulement retournés en réponse à la requête de transaction ccenrollmentlookup- RequestV1. Facultatif CCTxnResponseV1 Si un enregistrement en double est repéré, cet élément contient les détails de cet enregistrement. acsurl Facultatif Chaîne Max = 255 Cette URL est totalement qualifiée pour inviter le consommateur à exécuter la transaction Requête d authentification de paiement. paymentrequest Facultatif Chaîne Il s agit d une requête d authentification de paiement générée par le système de traitement de l authentification du marchand (MAPS). enrollmentstatus Oui Énumération Cela indique si le titulaire de la carte est inscrit ou non à 3D Secure. Les valeurs possibles sont : Y Authentification disponible N Titulaire de la carte non inscrit U Authentification non disponible E Erreur Guide de référence de l API pour les Services Web 1.0 3-53

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-12 : Éléments d une transaction cctxnresponsev1 (suite) Élément Élément enfant Requis Type Description tdsauthenticateresponse Cet élément et ses éléments enfants sont seulement retournés en réponse à la requête de transaction ccauthenticaterequestv1. eci Facultatif Énumération Visa/JCB 05 Identifie une transaction authentifiée avec succès. 06 Identifie une tentative de transaction authentifiée. 07 Identifie une transaction qui n a pas été authentifiée. MasterCard 01 Identifie une transaction qui n a pas été authentifiée. 02 Identifie une transaction authentifiée avec succès. Si le titulaire de la carte n est pas inscrit au système 3D Secure, vous pouvez utiliser la valeur de cet indicateur de commerce électronique pour l élément enfant de l indicateur indicator de l élément authentication dans votre requête d autorisation ou d achat ccauthrequestv1. Toutefois, si le titulaire de la carte est inscrit au système 3D Secure, utilisez la valeur eci de l élément tdsauthenticateresponse ci-dessous. status Oui Énumération Cela indique le résultat de la requête d authentification. Les valeurs possibles sont : Y Le titulaire de la carte a authentifié avec succès sa carte auprès de l émetteur. A Le titulaire de la carte a tenté de l'authentifier. N Le titulaire de la carte n a pas réussi à authentifier sa carte auprès de l émetteur. U L authentification par l émetteur de la carte n était pas disponible. E Erreur cavv Facultatif Chaîne Max = 80 Il s agit de la valeur de vérification de l authentification du titulaire de la carte qui a été retournée par l émetteur de la carte. Utilisez cette valeur pour l élément enfant de l indicateur indicator de l élément authentication dans une requête ccauthrequestv1. 3-54

juillet 2014 Traitement de la réponse Tableau 3-12 : Éléments d une transaction cctxnresponsev1 (suite) Élément Élément enfant Requis Type Description signatureverification Oui Énumération Cela indique si l élément paymentresponse qui a été soumis dans la requête d authentification a réussi les vérifications d intégrité. Les valeurs possibles sont : Y Toutes les vérifications de transaction et de signature ont été réussies. N Au moins une vérification de transaction ou de signature a échoué. xid Facultatif Chaîne Max = 80 Il s agit d un identifiant de transaction retourné en réponse à une requête d authentification ccauthenticaterequestv1. eci Facultatif Énumération Utilisez la valeur de l élément enfant de l indicateur de commerce électronique indicator de l élément authentication dans votre requête d autorisation ou d achat ccauthrequestv1. Visa/JCB 05 Identifie une transaction authentifiée avec succès. 06 Identifie une tentative de transaction authentifiée. 07 Identifie une transaction qui n a pas été authentifiée. MasterCard 01 Identifie une transaction qui n a pas été authentifiée. 02 Identifie une transaction authentifiée avec succès. lbcascading Facultatif Cet élément fournit l information concernant les transactions qui ont été essayées de nouveau à cause du partage de la charge. retrycount Conditionnel Entier Il s agit du nombre de fois que NETBANX a essayé la transaction de nouveau. originalcode Conditionnel Entier Le code de réponse original retourné par le système qui a poussé NETBANX à essayer la transaction de nouveau. addendumresponse Facultatif Cet élément permet à NETBANX de retourner au marchand certaines valeurs particulières à la passerelle. service Conditionnel Chaîne Max = 50 Il s agit du fournisseur de services qui fournit les valeurs pour la paire étiquette/valeur. detail Conditionnel Il peut exister plusieurs éléments detail, au besoin. Guide de référence de l API pour les Services Web 1.0 3-55

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-12 : Éléments d une transaction cctxnresponsev1 (suite) Élément Élément enfant Requis Type Description Élément enfant de detail tag Conditionnel Chaîne Max = 30 value Conditionnel Chaîne Max = 30 amount Facultatif Chaîne Max= 999999999,99 Il s agit de la paire étiquette/valeur retournée en tant qu élément de addendumresponse. Consultez la rubrique Paires étiquette/valeur pour addendumresponse à la page 3-58 pour obtenir plus de détails. Il s agit du montant de la requête de transaction. trantype REMARQUE : L élément trantype est renvoyée uniquement en réponse à une requête cctxnlookuprequestv1. Facultatif Énumération Il s agit du type de transaction pour laquelle vous avez fait une recherche. Les valeurs possibles sont : A Authorization (autorisation) S Settlement (règlement) P Purchase (achat) CR Credit (crédit) PY Payment (paiement) N Independent Credit (crédit indépendant) cardending REMARQUE : L élément cardending est renvoyée uniquement en réponse à une requête cctxnlookuprequestv1. Facultatif Chaîne Max = 4 Il s agit des quatre derniers chiffres de la carte utilisée pour cette transaction. cardexpiry REMARQUE : L élément cardexpiry est renvoyée uniquement en réponse à une requête cctxnlookuprequestv1. Facultatif month Conditionnel Entier Max = 2 year Conditionnel Entier Longueur = 4 Il s agit du mois d expiration de la carte de crédit. Il s agit de l année d expiration de la carte de crédit. netbanxreference REMARQUE : L élément netbanxreference est renvoyée uniquement en réponse à une requête cctxnlookuprequestv1. Facultatif Chaîne Max = 18 Il s agit d un numéro de transaction utilisé pour identifier certaines transactions existantes. txnlookupresult REMARQUE : L élément txnlookupresult est renvoyée uniquement en réponse à une requête cctxnlookuprequestv1. Conditionnel Ceci contient tous les éléments contenus dans la cctxnresponsev1 standard qui aurait été retournés dans la requête intiale, en plus des éléments dans cette table qui sont identifiés comme étant seulement retournés dans la réponse à cctxnlookuprequestv1 (par ex., trantype). 3-56

juillet 2014 Paires étiquette/valeur detail Tableau 3-12 : Éléments d une transaction cctxnresponsev1 (suite) Élément Élément enfant Requis Type Description profile id Facultatif Chaîne Max = 50 card Conditionnel Élément enfant de card id Conditionnel Chaîne Max = 50 Il s agit de l ID de la carte retournée par NETBANX, qui permet d identifier la carte du profil. lastfourdigits Conditionnel Entier Il s agit des quatre derniers chiffres du numéro de carte associé au profil. paymenttoken Conditionnel Chaîne Max = 50 Il s agit du jeton généré par NETBANX qui représente la carte. Pour traiter la réponse : 1. Obtenez les détails de la réponse qui sont accessibles à partir des modes get() de la réponse. String responsetxt = cctxnresponse.code + " - " + cctxnresponse.decision + " - " + cctxnresponse.description ; responsetxt += "Details:" + Environment.NewLine; if (cctxnresponse.detail!= null) { for (int i = 0; i < cctxnresponse.detail.length; i++) { responsetxt += " - " + cctxnresponse.detail[i].tag + " - " + cctxnresponse.detail[i].value + Environment.NewLine; } } responsetxt = responsetxt.replace("\n", Environment.NewLine); System.Console.WriteLine(responseTxt); if (DecisionV1.ACCEPTED.Equals(ccTxnResponse.decision)) { System.Console.WriteLine("Transaction Successful."); } else { System.Console.WriteLine("Transaction Failed with decision: " + cctxnresponse.decision); } 2. Traitez la réponse en fonction de l élément decision. Vous insérez le code de gestion approprié à votre application. Vous pouvez également consulter l élément code pour obtenir un contrôle plus serré de votre application. Pour obtenir plus de détails, consultez la rubrique Codes de réponse à la page B-1. Paires étiquette/valeur detail Certaines passerelles de traitement peuvent ne pas prendre en charge toutes les paires étiquette/valeur detail. Communiquez avec votre gestionnaire de compte pour obtenir plus de détails. Le tableau suivant contient les paires étiquette/valeur compatibles avec l élément data. Guide de référence de l API pour les Services Web 1.0 3-57

Transactions par carte de crédit ou de débit juillet 2014 Tableau 3-13 : Paires étiquette/valeur detail Étiquette Valeur CurrencyCode BalanceResponse Cette valeur est retournée si l élément étiquette addendumdata de la transaction initiale a été réglé à SERVICE_REQUEST_CURRENCY. La valeur figure dans les codes de devises du Tableau 3-15 : Codes de devises à la page 3-58. Cette valeur correspond au solde d une carte-cadeau, lorsqu'une cartecadeau a été utilisée pour la transaction initiale. Veuillez noter que le signe décimal des devises est sous-entendu ; par exemple, «16500» en dollars = 165,00 $. Paires étiquette/valeur pour addendumresponse Certaines passerelles de traitement peuvent ne pas prendre en charge toutes les paires étiquette/valeur pour addendumresponse. Communiquez avec votre gestionnaire de compte pour obtenir plus de détails. Le tableau suivant contient les paires étiquette/valeur compatibles avec l élément addendumresponse. Tableau 3-14 : Paires étiquette/valeur pour addendumresponse Étiquette Service Valeur BATCH_NUMBER DJN Il s agit de votre numéro de lot. EFFECTIVE_DATE DJN Il s agit de la date du dépôt bancaire associé à la transaction. Format = AAMMJJ SEQ_NUMBER DJN Il s agit de votre numéro de séquence. TERMINAL_ID DJN Il s agit de l ID de votre terminal. Codes de devises Tableau 3-15 : Codes de devises Code Devise ARS AUD BGN BRL CAD CHF CZK DKK EUR Peso argentin Dollar australien Lev bulgare Réal brésilien Dollar canadien Franc suisse Couronne tchèque Couronne danoise Euro 3-58

juillet 2014 Codes de devises Tableau 3-15 : Codes de devises (suite) Code Devise GBP HKD HUF ILS ISK JPY MXN NOK NZD PLN RON SEK SGD THB TWD USD ZAR Livre sterling Dollar de Hong Kong Forint hongrois Nouveau Shekel israélien Couronne islandaise Yen Peso mexicain Couronne norvégienne Dollar néo-zélandais Zloty polonais Leu roumain Couronne suédoise Dollar de Singapour Baht Nouveau dollar de Taïwan Dollar américain Rand Guide de référence de l API pour les Services Web 1.0 3-59

Transactions par carte de crédit ou de débit juillet 2014 3-60

CHAPITRE 4 Transactions du service de consultation des données Introduction L opération du service de consultation des données (ILS) vous permet de produire un rapport à l aide de l API pour une plage de temps que vous précisez, afin de recevoir les données concernant les autorisations, les règlements, les crédits et les rétrofacturations qui sont traités par un compte de marchand. Vous pouvez utiliser l élément type pour combiner un ou plusieurs types de transaction dans une même requête. Consultez le Tableau 4-1 : Éléments de transaction ilslookuprequestv1 à la page 4-6 pour en connaître davantage à propos de l élément type. Ce chapitre décrit comment traiter l opération ILS à l aide du Service Web de traitement des transactions. L opération ILS accepte un objet de document ilslookuprequestv1. L opération ILS retourne une réponse ilslookupresponsev1. La période maximale couverte dans une requête ILS est de 24 heures. WSDL et liens ILS NETBANX WSDL : https://webservices.optimalpayments.com/ilsws/ilsservice/v1?wsdl Service Web : https://webservices.optimalpayments.com/ilsws/ilsservice/v1 Publication HTTP : https://webservices.optimalpayments.com/ilsws/ilsservlet/v1 Guide de référence de l API pour les Services Web 1.0 4-1

Transactions du service de consultation des données juillet 2014 Exemple.NET Pour bâtir l exemple pour.net : 1. Créez un nouveau projet. 2. Ajoutez une référence Web. 4-2

juillet 2014 Bâtir des requêtes ILS 3. Saisissez l URL WSDL et cliquez sur le bouton Ajouter une référence. Le client Web est maintenant créé. 4. Bâtissez la requête et traitez la réponse : Consultez la rubrique Bâtir des requêtes ILS à la page 4-3. Bâtir des requêtes ILS Les requêtes ILS requièrent l objet de document ilslookuprequestv1. La présente rubrique décrit la structure d une requête ilslookuprequestv1 et la façon de la bâtir. Pour obtenir des détails sur les éléments requis, consultez le Tableau 4-1 : Éléments de transaction ilslookuprequestv1 à la page 4-6. ILS C# Voici un exemple de ILS en C#. //Prepare the call to the Credit Card Web Service ILSLookupRequestV1 ilslookuprequest = new ILSLookupRequestV1(); Guide de référence de l API pour les Services Web 1.0 4-3

Transactions du service de consultation des données juillet 2014 MerchantAccountV1 merchantaccount = new MerchantAccountV1(); merchantaccount.accountnum = "12345678"; merchantaccount.storeid = "mystoreid"; merchantaccount.storepwd = "mystorepwd"; DateV1 startdate = new DateV1(); startdate.year = 2008; startdate.month = 11; startdate.day = 3; startdate.hour = 0; startdate.minute = 0; startdate.second = 0; DateV1 enddate = new DateV1(); enddate.year = 2008; enddate.month = 11; enddate.day = 3; enddate.hour = 14; enddate.minute = 40; enddate.second = 59; RequestTypeV1[] txntypes = new RequestTypeV1[1]; txntypes[0] = RequestTypeV1.settlements; IlsLookupRequestV1 req = new IlsLookupRequestV1(); req.merchantaccount = merchantaccount; req.startdate = startdate; req.enddate = enddate; req.type = txntypes; System.Console.WriteLine("Sending request..."); IlsServiceV1 ilsservice = new IlsServiceV1(); IlsLookupResponseV1 response = null; response = ilsservice.ilslookup( req ); System.Console.WriteLine("Response received: "); String responsetxt = ""; if( response!= null ) { responsetxt += "Decision: " + response.decision + Environment.NewLine; responsetxt += "Description: " + response.description + Environment.NewLine; if( response.decision == DecisionV1.ACCEPTED ) { responsetxt += "Authorizations: " + response.transactions.authorizations + Environment.NewLine; responsetxt += "Settlements: " + response.transactions.settlements + Environment.NewLine; responsetxt += "Chargebacks: " + response.transactions.chargebacks + Environment.NewLine; responsetxt += "Credits: " + response.transactions.credits + Environment.NewLine; } } System.Console.WriteLine( responsetxt ); 4-4

juillet 2014 Diagramme de transaction ilslookuprequestv1 Diagramme de transaction ilslookuprequestv1 Une transaction ilslookuprequestv1 respecte la structure suivante : Guide de référence de l API pour les Services Web 1.0 4-5

Transactions du service de consultation des données juillet 2014 Éléments de transaction ilslookuprequestv1s L objet de document ilslookuprequestv1 contient les éléments suivants : Tableau 4-1 : Éléments de transaction ilslookuprequestv1 Élément Élément enfant Requis Type Description merchantaccount accountnum Oui Chaîne Max = 10 storeid Oui Chaîne Max = 80 storepwd Oui Chaîne Max = 20 startdate year Oui Entier Max = 9999 month Oui Entier Min = 1 Max = 12 day Oui Entier Min = 1 Max = 31 hour Oui Entier Min = 0 Max = 23 minute Oui Entier Min = 0 Max = 59 second Oui Entier Min = 0 Max = 59 enddate year Oui Entier Max = 9999 month Oui Entier Min = 1 Max = 12 day Oui Entier Min = 1 Max = 31 Il s agit du numéro de compte de marchand. Il s agit de l identifiant du magasin traitant la transaction; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit du mot de passe du magasin traitant la transaction; il sert à authentifier la requête. NETBANX le définit et le fournit au marchand comme élément du processus d intégration. Il s agit de l année fixée pour le début de la recherche. Il s agit du mois fixé pour le début de la recherche. Il s agit du jour fixé pour le début de la recherche. Il s agit de l heure fixée pour le début de la recherche. Il s agit de la minute fixée pour le début de la recherche. Il s agit de la seconde fixée pour le début de la recherche. Il s agit de l année fixée pour la fin de la recherche. Il s agit du mois fixé pour la fin de la recherche. Il s agit du jour fixé pour la fin de la recherche. 4-6

juillet 2014 Éléments de transaction ilslookuprequestv1s Tableau 4-1 : Éléments de transaction ilslookuprequestv1 (suite) Élément Élément enfant Requis Type Description hour Oui Entier Min = 0 Max = 23 minute Oui Entier Min = 0 Max = 59 second Oui Entier Min = 0 Max = 59 Il s agit de l heure fixée pour la fin de la recherche. Il s agit de la minute fixée pour la fin de la recherche. Il s agit de la seconde fixée pour la fin de la recherche. type Oui Énumération Il s agit du type de transaction pour laquelle vous faites une recherche de données. Les valeurs possibles sont : authorizations (autorisations) settlements (règlements) credits (crédits) chargebacks (rétrofacturations) dd-charge (facturation par débit direct) dd-credit (crédit par débit direct) dd-charge-bacs (retourne l élément mandatereference) dd-credit-bacs (retourne l élément mandatereference) dd-mandate-bacs (retourne les éléments mandatereference et effectivedate) ccoptions Facultatif Énumération Pour usage interne seulement. ddoptions Facultatif datetype Facultatif Énumération Ceci précise la nature de l état de la transaction recherchée. Les valeurs possibles sont : initiation La recherche sera effectuée sur toutes les vérifications présentées durant la période indiquée. Si la valeur datetype n est pas indiquée, il s agit de la valeur par défaut. status_change La recherche sera effectuée sur toutes les vérifications dont l'état a changé durant la période indiquée. Guide de référence de l API pour les Services Web 1.0 4-7

Transactions du service de consultation des données juillet 2014 Tableau 4-1 : Éléments de transaction ilslookuprequestv1 (suite) Élément Élément enfant Requis Type Description status Facultatif Énumération La requête de consultation n enverra que les transactions dont l état est indiqué ici. Lorsque cette valeur est combinée à l élément status_change, seuls les enregistrements ayant l état indiqué durant la période seront retournés. Si cet élément n est pas indiqué, les transactions sont retournées, quel que soit l état. Les valeurs possibles sont : Presented (Présentée) Represented (Représentée) Returned (Retournée) Pending Customer Approval (Approbation client en attente) Pending (En attente) Active (Actif) Declined (Refusée) Cancelled (Annulée) Failed (Échec) Cleared (Traitée) La période maximale couverte dans une requête ILS est de 24 heures. Traitement de la réponse Voici un exemple d une requête ilslookupresponsev1 typique concernant une transaction réussie. Consultez le Tableau 4-2 : Éléments de transaction ilslookupresponsev1 à la page 4-10 pour obtenir la description des paramètres retournés. <ilslookupresponsev1 xmlns="http://www.optimalpayments.com/ils/xmlschema/v1"> <decision>accepted</decision> <description/> <merchantaccount>10000400036</merchantaccount> <currency>usd</currency> <startdate> <year>2011</year> <month>2</month> <day>5</day> <hour>0</hour> <minute>0</minute> <second>0</second> </startdate> <enddate> <year>2011</year> <month>3</month> <day>5</day> <hour>23</hour> <minute>59</minute> 4-8

juillet 2014 Traitement de la réponse <second>59</second> </enddate> <txntype> <code>authorizations</code> <count>2</count> </txntype> <txntype> <code>settlements</code> <count>2</count> </txntype> <txntype> <code>credits</code> <count>1</count> </txntype> <txntype> <code>chargebacks</code> <count>1</count> </txntype> <transactions childfma='1000201930'> <authorizations>100052493 FS 2011-02-05 09:57:54 test 123 111.65 </authorizations> <settlements>100052493 C 2011-02-05 09:57:55 test 123 111.65 </settlements> <credits>116883988 C 2011-03-02 15:17:09 test 123 5.0 102318569 USD </credits> <chargebacks>368237 100052493 test 123 test 123 1111 2011-02 -05 111.65 USD 111.65 30 40003610000160100052493 100000 1 2008-02-05 </chargebacks> </transactions> <transactions childfma='1000201931'> <authorizations>100052493 FS 2011-02-05 09:57:54 test 123 88.00 </authorizations> <settlements>100052493 C 2011-02-05 09:57:55 test 123 88.00 </settlements> </transactions> </ilslookupresponsev1> Ce qui suit est un exemple d'une valeur typique ilslookupresponsev1 en cas de transaction rejetée. Dans cet exemple, un code de marchand ou un mot de passe erroné a été entré. <ilslookupresponsev1 xmlns="http://www.optimalpayments.com/ils/xmlschema/v1"> <decision>rejected</decision> <description>invalid Credentials</description> </ilslookupresponsev1> Guide de référence de l API pour les Services Web 1.0 4-9

Transactions du service de consultation des données juillet 2014 Diagramme de transaction ilslookupresponsev1 Une transaction ilslookupresponsev1 respecte la structure suivante : Les éléments suivants sont pertinents dans le cas d une réponse ilslookupresponsev1 : Tableau 4-2 : Éléments de transaction ilslookupresponsev1 Élément Élément enfant Requis Type Description decision Oui Énumération Il s agit de l état de la transaction. Une des valeurs suivantes sera retournée : Accepted La transaction a été traitée. Error La tentative de transaction a échoué en raison d une erreur. Rejected La requête a été rejetée, à cause des justificatifs d identité invalides du marchand, par exemple. description Oui Chaîne Max = 1024 merchantaccount Oui Chaîne Max = 10 Si la décision retournée est Error ou Rejected, il s agit d une description de l erreur. Il s agit du numéro de compte de marchand. 4-10

juillet 2014 Diagramme de transaction ilslookupresponsev1 Tableau 4-2 : Éléments de transaction ilslookupresponsev1 (suite) Élément Élément enfant Requis Type Description currency Oui Chaîne Longueur = 3 startdate year Oui Entier Max = 9999 month Oui Entier Min = 1 Max = 12 day Oui Entier Min = 1 Max = 31 hour Oui Entier Min = 0 Max = 23 minute Oui Entier Min = 0 Max = 59 second Oui Entier Min = 0 Max = 59 enddate year Oui Entier Max = 9999 month Oui Entier Min = 1 Max = 12 day Oui Entier Min = 1 Max = 31 hour Oui Entier Min = 0 Max = 23 minute Oui Entier Min = 0 Max = 59 second Oui Entier Min = 0 Max = 59 Il s agit de la devise du compte de marchand. Il s agit de l année fixée pour la date de début de la recherche. Il s agit du mois fixé pour la date de début de la recherche. Il s agit du jour fixé pour la date de début de la recherche. Il s agit de l heure fixée pour l heure de début de la recherche. Il s agit de la minute fixée pour l heure de début de la recherche. Il s agit de la seconde fixée pour l heure de début de la recherche. Il s agit de l année fixée pour la date de fin de la recherche. Il s agit du mois fixé pour la date de fin de la recherche. Il s agit du jour fixé pour la date de fin de la recherche. Il s agit de l heure fixée pour l heure de la fin de la recherche. Il s agit de la minute fixée pour l heure de la fin de la recherche. Il s agit de la seconde fixée pour l heure de la fin de la recherche. Guide de référence de l API pour les Services Web 1.0 4-11

Transactions du service de consultation des données juillet 2014 Tableau 4-2 : Éléments de transaction ilslookupresponsev1 (suite) Élément Élément enfant Requis Type Description txntype code Oui Chaîne Il s agit du type de transaction pour laquelle vous avez fait une recherche de données. Les valeurs possibles sont : authorizations (autorisations) settlements (règlements) credits (crédits) chargebacks (rétrofacturations) dd-charge (facturation) dd-credit (crédit) dd-charge-bacs (inclut l élément mandatereference) dd-credit-bacs (inclut l élément mandatereference) dd-mandate-bacs (inclut les éléments mandatereference et effectivedate) count Oui Entier Il s agit du numéro de type de transaction retourné dans l élément code ci-dessus. Chaque élément code retourné possède son propre count. transactions Facultatif Attribut de transactions childfma Conditionnel Chaîne Max = 10 Il s agit du numéro de compte de marchand enfant et il n est fourni que si le compte déterminé comme élément merchantaccount est un compte principal. authorizations Facultatif Chaîne Chaque instance de authorizations contient plus de détails. Consultez la rubrique Détails dans la réponse aux requêtes d autorisation àla page 4-13 pour obtenir une description. settlements Facultatif Chaîne Chaque instance de settlements contient plus de détails. Consultez la rubrique Détails dans la réponse aux requêtes de règlement à la page 4-14 pour obtenir une description. credits Facultatif Chaîne Chaque instance de credits contient plus de détails. Consultez la rubrique Détails dans la réponse aux requêtes de crédit à la page 4-14 pour obtenir une description. chargebacks Facultatif Chaîne Chaque instance de chargebacks contient plus de détails. Consultez la rubrique Détails dans la réponse aux requêtes de rétrofacturation àla page 4-15 pour obtenir une description. 4-12

juillet 2014 Contenu de l élément de réponse Tableau 4-2 : Éléments de transaction ilslookupresponsev1 (suite) Élément Élément enfant Requis Type Description dd-charge dd-credit Facultatif Facultatif Chaîne Chaîne Chaque instance de dd-charge, dd-credit, ddcharge-bacs, dd-credit-bacs, et dd-mandate-bacs contient plus de détails. Consultez la rubrique dd-charge-bacs Facultatif Chaîne Détails dans la réponse aux requêtes de prélèvement automatique (débit direct) àla page dd-credit-bacs Facultatif Chaîne 4-16 pour obtenir une description. dd-mandate-bacs Facultatif Chaîne Contenu de l élément de réponse NETBANX peut, sans préavis, lorsque nécessaire, ajouter des éléments de détails additionnels à chacun des types de réponses des transactions décrites ci-dessous (autorisations, règlements, crédits et rétrofacturations). Ces éléments de détails seront ajoutés à la fin de la liste actuelle d éléments séparés par des barres verticales, comme l illustre l exemple ci-dessous. <ilslookupresponsev1 xmlns="http://www.optimalpayments.com/ils/xmlschema/v1"> <transactions childfma='1000201930'> <authorizations>100052493 FS 2011-02-05 09:57:54 test 123 111.65 added element added element </authorizations> <settlements>100052493 C 2011-02-05 09:57:55 test 123 111.65 added element added element </settlements> <credits>116883988 C 2011-03-02 15:17:09 test 123 5.0 102318569 USD added element added element </credits> <chargebacks>368237 100052493 test 123 test 123 1111 2011-02-05 111.65 USD 111.65 30 40003610000160100052493 100000 1 2008-02-05 added element </chargebacks> </ilslookupresponsev1> Il incombe au marchand de s assurer que son intégration pour la requête ilslookuprequestv1 n est pas touchée de façon négative lorsque NETBANX ajoute des éléments de détails additionnels. Détails dans la réponse aux requêtes d autorisation Les détails suivants peuvent être retournés pour une requête d autorisation : Tableau 4-3 : Détails dans la réponse aux requêtes d autorisation Paramètre Record Sequence (séquence des enregistrements) Description Il s agit du numéro de confirmation de la transaction qui a été attribué par NETBANX. Guide de référence de l API pour les Services Web 1.0 4-13

Transactions du service de consultation des données juillet 2014 Tableau 4-3 : Détails dans la réponse aux requêtes d autorisation (suite) Authorization Status (état de l autorisation) Transaction Date/Time (date et heure de la transaction) Merchant Transaction ID (ID de transaction du marchand) Amount (montant) Paramètre Il s agit de l état de l autorisation. Les valeurs possibles sont : A Autorisée FS Complètement réglée AS Partiellement réglée Il s agit de la date et de l heure du traitement de l autorisation. Il s agit de l ID de transaction qui a été attribué par le marchand à l autorisation. Il s agit du montant de l autorisation. Description Détails dans la réponse aux requêtes de règlement Les détails suivants peuvent être retournés pour une requête de règlement : Tableau 4-4 : Détails dans la réponse aux requêtes de règlement Paramètre Record Sequence (séquence des enregistrements) Description Il s agit du numéro de confirmation de la transaction qui a été attribué par NETBANX. Settlement Status (état du règlement) Il s agit de l état actuel de la transaction de règlement. Les valeurs possibles sont : B Mise en lot E Erreur P En attente C Complétée K Annulée HO En suspens DE Refusée MI Manuelle Transaction Date/Time (date et heure de la transaction) Merchant Transaction ID (ID de transaction du marchand) Amount (montant) Il s agit de la date et de l heure du traitement du règlement. Il s agit de l ID de transaction qui a été attribué par le marchand au règlement. Il s agit du montant du règlement. Détails dans la réponse aux requêtes de crédit Les détails suivants peuvent être retournés pour une requête de crédit : Tableau 4-5 : Détails dans la réponse aux requêtes de crédit Paramètre Record Sequence (séquence des enregistrements) Description Il s agit du numéro de confirmation de la transaction qui a été attribué par NETBANX. 4-14

juillet 2014 Contenu de l élément de réponse Tableau 4-5 : Détails dans la réponse aux requêtes de crédit (suite) Paramètre Description Credit Status (état du crédit) Il s agit de l état du règlement maintenant crédité. Les valeurs possibles sont : B Mise en lot E Erreur P En attente C Complétée K Annulée HO En suspens DE Refusée MI Manuelle Transaction Date/Time (date et heure de la transaction) Merchant Transaction ID (ID de transaction du marchand) Amount (montant) Settlement Record Sequence (séquence des enregistrements de règlements) Il s agit de la date et de l heure du traitement du crédit. Il s agit de l ID de transaction qui a été attribué au crédit par le marchand. Il s agit du montant du crédit. Il s agit du numéro de confirmation initialement attribué au règlement qui a été crédité. Détails dans la réponse aux requêtes de rétrofacturation Les détails suivants peuvent être retournés pour une requête de rétrofacturation : Tableau 4-6 : Détails dans la réponse aux requêtes de rétrofacturation Paramètre Chargeback ID (ID de rétrofacturation) Authorization Transaction ID (ID de transaction d autorisation) Authorization Merchant Transaction ID (ID de transaction d autorisation du marchand) Settlement Merchant Transaction ID (ID de transaction de règlement du marchand) Card Ending (fin de la carte) Original Settlement Date (date initiale de règlement) Original Settlement Amount (montant du règlement initial) Currency Code (code de devise) Chargeback Amount (montant de la rétrofacturation) Description Il s agit de l ID d enregistrement dans notre système de gestion des litiges. Chaque rétrofacturation possède un ID d enregistrement unique permettant de l identifier. Il s agit de l ID de transaction que NETBANX a attribué à la requête d autorisation initiale. Il s agit de l ID de transaction qui a été attribué par le marchand à la transaction d autorisation initiale. Il s agit de l ID de transaction qui a été attribué par le marchand au règlement ayant fait l objet d une rétrofacturation. Il s agit des quatre derniers chiffres de la carte de crédit utilisée pour la transaction d autorisation initiale. Il s agit de la date du règlement de la transaction d autorisation initiale. Format = aaaa-mm-jj Il s agit du montant du règlement appliqué sur la transaction d autorisation initiale. Il s agit de la devise du compte de marchand. Il s agit du montant de la rétrofacturation du règlement. Guide de référence de l API pour les Services Web 1.0 4-15

Transactions du service de consultation des données juillet 2014 Tableau 4-6 : Détails dans la réponse aux requêtes de rétrofacturation (suite) Reason Code (code de motif) ARN Paramètre Original Authorization Code (code d autorisation initial) Description Il s agit du motif pour lequel la transaction a fait l objet d une rétrofacturation. Consultez la rubrique Codes de motif à la page 4-17 pour obtenir l explication des codes. Il s agit du numéro de référence de l acquéreur, un numéro d identification de référence unique attribué à chaque transaction de règlement par l acquéreur. Il s agit du code d autorisation attribué par la banque émettrice et retourné par NETBANX lorsque la transaction a été traitée à l aide du protocole de paiement direct. CBTY Code (code CBTY) Il s agit du type de rétrofacturation. Les valeurs possibles sont : 1 Rétrofacturation 2 Inversion de rétrofacturation C Avis de risque seulement D Refacturation refusée/perdue RET Demande de récupération Disputed Flag (indicateur de litige) Cet indicateur signale qu une transaction est en litige. Les valeurs possibles sont : Null (nul) Yes (oui) FMA Posting Date (date de publication FMA) Il s agit de la date à laquelle la rétrofacturation a été publiée dans le compte de marchand. Format = aaaa-mm-jj Détails dans la réponse aux requêtes de prélèvement automatique (débit direct) Les détails suivants peuvent être retournés pour une requête de prélèvement automatique : Tableau 4-7 : Détails dans la réponse aux requêtes de prélèvement automatique Paramètre Echeck ID (ID de prélèvement automatique) Echeck Status (L état du chèque électronique) Presentation Date (Date de présentation) Merchant Transaction ID (ID de transaction du marchand) Description Il s agit du numéro de confirmation de la transaction qui a été attribué par NETBANX. Il s agit de l état actuel de la transaction de prélèvement automatique. Les valeurs possibles sont : C Lot complet (Complete batch) DE Refusée (Declined) E Erreur lot (Error batch) F Échec (Failed) PR1 Présentée 1 (Presented 1) PR2 Présentée 2 (Presented 2) RE Rejetée (Rejected) REF Rejet définitif (Rejected final) RF Remboursée (Refunded) RV Inversée (Reversed) X Annulée (Cancelled) Il s agit de la date et de l heure du traitement de la transaction. Il s agit de l ID de transaction qui a été attribué par le marchand à la transaction. 4-16

juillet 2014 Codes de motif Tableau 4-7 : Détails dans la réponse aux requêtes de prélèvement automatique Paramètre Description Amount (Montant) Filtered Status (État filtré ) Latest Status Update Time (Heure de la dernière mise à jour de l état) Lorsque l élément enfant datetype de ddoptions est réglé à initiation (la valeur par défaut), cette valeur est la même que la valeur Echeck Status ci-dessus dans le présent tableau. Lorsque l élément enfant datetype de ddoptions est réglé à status_change, il s agit de l état utilisé pour effectuer la recherche. Voici les états retournés pour chaque scénario de recherche. Présentée (Presented) C Représentée (Represented) PR1 PR2 Retournée (Returned) RE REF Il s agit de la date et de l heure de la dernière mise à jour de l état. Codes de motif Codes de motifs de rétrofacturation Un des codes de motif de rétrofacturation suivant peut être retourné dans la réponse chargebacks : Tableau 4-8 : Codes de motif de rétrofacturation Visa/MasterCard Marque de la carte Code Description MC 01 Les données de la transaction demandée n ont pas été reçues. MC 02 L article demandé est illisible. MC 07 Fichier de bulletin d avis. MC 08 L'autorisation demandée ou requise n'a pas été obtenue. MC 12 Numéro de compte inexistant. VI 30 Services non fournis ou marchandise non reçue. MC 31 Montant de transaction différent. MC 34 Traitement en double. MC 35 Carte non valide ou expirée. MC 37 Transaction frauduleuse de commande par courrier ou par téléphone. MC 40 Traitement frauduleux de transaction. MC 41 Transaction récurrente annulée. Guide de référence de l API pour les Services Web 1.0 4-17

Transactions du service de consultation des données juillet 2014 Tableau 4-8 : Codes de motif de rétrofacturation Visa/MasterCard (suite) Marque de la carte Code Description VI 41 Transaction récurrente annulée. MC 42 Facturation en retard. MC 47 Transaction hors limite, non autorisée et frauduleuse. MC 49 Activités douteuses du marchand. MC 50 Crédit publié en tant que débit. MC 53 Litige avec le titulaire de la carte, marchandise défectueuse ou non conforme à la description. VI 53 Marchandise non conforme à la description ou défectueuse. MC 54 Litige avec le titulaire de la carte Non classifié ailleurs (É.-U. seulement). MC 55 Marchandise non reçue. VI 57 Transactions frauduleuses multiples. MC 59 Services non rendus. MC 60 Crédit non traité. VI 60 Copie demandée illisible. MC 62 Transaction falsifiée, fraude au point de vente liée à la bande magnétique. VI 62 Transaction falsifiée. MC 63 Le titulaire de la carte ne reconnaît pas la transaction Fraude possible. VI 71 Requête d autorisation refusée ou autorisation refusée. VI 72 Aucune autorisation ou transaction hors limite. VI 73 Carte expirée. VI 74 Facturation en retard. VI 75 Le titulaire de la carte ne reconnaît pas la transaction. VI 76 Code de transaction inexact. VI 77 Numéro de compte différent. VI 79 Les données de la transaction demandée n ont pas été reçues. VI 80 Montant de transaction ou numéro de compte inexact. VI 81 Transaction frauduleuse Transaction avec carte. VI 82 Traitement en double. VI 83 Transaction frauduleuse Transaction sans carte. VI 85 Crédit non traité. VI 86 Paiement par d autres moyens. 4-18

juillet 2014 Codes de motif de requête de récupération Codes de motif de requête de récupération La réponse chargebacks à la requête de récupération peut retourner un code de motif parmi les codes suivants : Tableau 4-9 : Codes de motif de récupération Visa/MasterCard Marque de la carte Code Description MC 05 Soutien des rétrofacturations Le titulaire de la carte conteste le montant facturé. MC 21 Demande d information du titulaire de la carte Ne reconnaît pas la transaction (nom du marchand, ville, État ou province ou date). MC 22 Demande d information du titulaire de la carte En désaccord avec la facturation. MC 23 Demande d information du titulaire de la carte Requiert l information pour ses dossiers personnels. MC 24 Demande d information du titulaire de la carte Code d absence de motif. VI 28 Le titulaire demande une copie avec signature. VI 29 Requête pour obtenir les documents T&E. VI 30 Litige avec le titulaire de la carte, le titulaire de la carte demande une facture de vente. VI 33 Procédure judiciaire ou analyse de fraude. VI 34 Requête multiple de copie. MC 41 Procédure judiciaire ou analyse de fraude Vérification de signature. MC 42 Rétrofacturation potentielle ou documents de conformité. MC 43 Procédure judiciaire ou analyse de fraude Vérification d empreinte. Codes de motifs de rétrofacturation et de requête de récupération pour Discover Un des codes de motif de rétrofacturation ou de la requête de récupération suivant peut être retourné dans la réponse chargebacks : Tableau 4-10 : Codes de motifs de rétrofacturation et de requête de récupération pour Discover Code AL AP AW CA CD Description Le titulaire de la carte conteste la validité d un achat réalisé avec la carte dans une compagnie aérienne. Le titulaire de la carte conteste la validité de plusieurs paiements récurrents sur la carte après l expiration ou l annulation de l entente pour ces paiements. Montant de transaction inexact ou numéro de compte/montant de transaction différent Le titulaire de la carte conteste la validité d une transaction d avance d argent ou d excédent de caisse autre qu une transaction dans un guichet automatique Discover. Le titulaire de la carte conteste la validité d une transaction avec la carte parce que la transaction aurait dû être un crédit plutôt qu un débit associé à un achat. Guide de référence de l API pour les Services Web 1.0 4-19

Transactions du service de consultation des données juillet 2014 Tableau 4-10 : Codes de motifs de rétrofacturation et de requête de récupération pour Discover (suite) RG UA11 UA12 UA18 UA21 UA22 UA23 UA28 RN1, RN2 DP RM NA UA01 CR NC DA EX IC IN IS Code LP Description Le titulaire de la carte conteste la validité d un achat réalisée avec la carte faute d avoir reçu les biens ou les services. Transaction par bande magnétique La signature du titulaire de la carte n a pas été obtenue. Transaction par bande magnétique La signature n est pas valide. Transaction par bande magnétique Le reçu de la transaction est illisible. Transaction saisie au clavier La signature du titulaire de la carte n a pas été obtenue. Transaction saisie au clavier La signature n est pas valide. Transaction saisie au clavier L impression de la carte n est pas valide. Transaction saisie au clavier Les documents de la transaction sont illisibles. Le titulaire de la carte affirme ne pas avoir reçu un crédit escompté d un marchand ou avoir reçu un crédit insuffisant. Le titulaire de la carte affirme avoir reçu plusieurs fois la même facture pour un seul achat. Le titulaire de la carte conteste la validité d un achat réalisé avec la carte parce que les biens ou les services rendus par le marchand ne respectent pas la qualité ou les conditions précisées dans le contrat de vente. L émetteur de la carte conteste un achat effectué avec la carte parce que le marchand n a pas obtenu d autorisation pour le montant de la transaction qui est source de litige, selon ce qu indiquent les données de la vente. Le titulaire ou l émetteur de la carte conteste la validité d un achat avec la carte parce que le marchand n a pas envoyé de requête d autorisation. Le titulaire de la carte conteste la validité d une transaction avec la carte parce qu il a annulé sa réservation auprès du marchand. Le titulaire de la carte conteste la validité d un achat réalisé avec la carte, et aucun autre code de motif ne s applique. L émetteur de la carte conteste la validité d un achat réalisé avec la carte parce que le marchand a reçu un refus d autorisation et que l émetteur ne peut donc pas réclamer le montant de la vente au titulaire de la carte. Le titulaire ou l émetteur de la carte conteste la validité d un achat réalisé avec la carte parce que la carte a expiré le jour de la transaction ou avant celle-ci et que le marchand n a pas obtenu d autorisation pour cette transaction. Le titulaire ou l émetteur de la carte conteste un achat réalisé avec la carte parce que les documents de la transaction reçus après une demande de récupération sont illisibles ou qu ils ne présentent pas une impression valide de la carte (le cas échéant). Le titulaire de la carte conteste une transaction parce que le numéro de la carte fourni par le marchand n est pas valide. Le titulaire ou l émetteur de la carte conteste un achat réalisé avec la carte parce que les documents de la transaction reçus après une demande de récupération ne comportent pas une signature valide et lisible du titulaire à l emplacement requis pour la transaction. Le titulaire ou l émetteur de la carte conteste un achat réalisé avec la carte parce que l acquéreur ou le marchand a soumis les données de la vente plus de trente jours après la requête d autorisation et qu il ne s agissait pas d une vente avec livraison différée. 4-20

juillet 2014 Codes de motifs de rétrofacturation et de requête de récupération pour Discover Tableau 4-10 : Codes de motifs de rétrofacturation et de requête de récupération pour Discover (suite) Code SV TF UA10 UA20 UA30 UA31 UA38 UA02 UA03 UA32 UA99 R2 A Le titulaire ou l émetteur de la carte conteste une transaction pour une carte prépayée parce que le marchand n a pas obtenu d autorisation pour le montant de la vente qui est source de litige. Discover procède à une rétrofacturation d une transaction avec une carte parce que l acquéreur ou le marchand n ont pas respecté les règles de fonctionnement applicables. Demande de reçu pour une transaction par bande magnétique. Demande de documents relatifs à une transaction saisie au clavier. Demande de documents relatifs à une transaction effectuée en l absence de carte. Transaction effectuée en l absence de carte Preuve non valide recueillie par l acquéreur ou le marchand. Transaction effectuée en l absence de carte Les documents de la transaction sont illisibles. Le titulaire ou l émetteur de la carte conteste la validité d un achat réalisé avec la carte parce que l émetteur a refusé la transaction. Le titulaire ou l émetteur de la carte conteste la validité d un achat réalisé avec la carte parce que le montant facturé au titulaire excède le montant autorisé par l émetteur. Le titulaire ou l émetteur de la carte conteste la validité d une transaction effectuée en l absence de carte parce que l acquéreur ou le marchand n a pas effectué de vérification de l adresse ou qu il n a pas obtenu et soumis le numéro d identification de la carte (CID) avec la requête d autorisation. Le titulaire ou l émetteur de la carte conteste la validité d un achat réalisé avec la carte et l acquéreur ou le marchand n a pas respecté les règles de fonctionnement applicables aux achats réalisés avec la carte. Crédit non traité. Description Litige avec le titulaire de la carte : le titulaire de la carte demande une facture de vente. Guide de référence de l API pour les Services Web 1.0 4-21

Transactions du service de consultation des données juillet 2014 4-22

ANNEXE A Utilisation de la méthode HTTP Post Introduction En plus d un appel standard au service Web, vous pouvez utiliser la méthode HTTP Post pour envoyer les requêtes de transaction à NETBANX. Veuillez noter que les URL dans les exemples ci-dessous portent sur l environnement de production de NETBANX. Afin de tester votre intégration, veuillez communiquer avec le soutien technique pour obtenir les URL de test, puis testez les paramètres du compte de marchand. Courriel : support@optimalpayments.com Téléphone : 1 888 709-8753 Toutes les transactions envoyées par la méthode HTTP Post doivent être codées par URL à l aide du format application/x-www-form-urlencoded. Autrement, il y a un risque d échec puisque les caractères réservés (p. ex., barre oblique, perluète, etc.) seront retirés des requêtes qui ne sont pas correctement codées par URL. Requêtes relatives à un prélèvement automatique facturation/vérification/crédit Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Bâtir des requêtes de facturation, de vérification ou de crédit à la page 2-4. Pour envoyer une requête de facturation, de vérification ou de crédit par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ddcheckrequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <check> <accounttype>pc</accounttype> <bankname>chase</bankname> <checknum>12</checknum> <accountnum>987654321</accountnum> <routingnum>123456789</routingnum> </check> <billingdetails> <checkpaymethod>web</checkpaymethod> <firstname>jeanne</firstname> Guide de référence de l API pour les Services Web 1.0 A-1

Utilisation de la méthode HTTP Post juillet 2014 <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> <sdk> <version>1.0</version> platform>http</platform> <provider>merchant</provider> </sdk> </ddcheckrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 2-2 : Éléments de transaction ddcheckrequestv1 à la page 2-7. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Facturation à la page A-2). La requête HTTP Post doit comporter deux paramètres : txnmode charge (facturation), credit (crédit), ou verify (vérification). txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/directdebitws/directdebitservlet/v1 Exemple HTML Facturation Cet exemple présente une version de formulaire de requête de facturation/vérification/crédit contenant l exemple ci-dessus que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>netbanx Test de transaction par prélèvement automatique</title> <body> <form NAME="Direct Debit" METHOD="post" ACTION="https://webservices.optimalpayments.com/directdebitWS/DirectDebitServlet/v1" > <b>mode de transaction : </b> <br> <select name="txnmode"> <option value="charge">facturation</option> <option value="credit">crédit</option> <option value="verify">vérification</option> </select> <br> <br> <b>corps du message XML :</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10> <ddcheckrequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> A-2

juillet 2014 facturation/vérification/crédit <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <check> <accounttype>pc</accounttype> <bankname>chase</bankname> <checknum>12</checknum> <accountnum>987654321</accountnum> <routingnum>123456789</routingnum> </check> <billingdetails> <checkpaymethod>web</checkpaymethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> <sdk> <version>1.0</version> <platform>http</platform> <provider>marchand</provider> </sdk> </ddcheckrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"></form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Guide de référence de l API pour les Services Web 1.0 A-3

Utilisation de la méthode HTTP Post juillet 2014 updateshippinginfo Pour en savoir davantage sur ce type de requête, consultez la rubrique Création de requêtes updateshippinginfo à la page 2-14. Pour envoyer une requête updateshippinginfo par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ddshippingrequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <carrier>fex</carrier> <trackingnumber>555666888999</trackingnumber> <confirmationnumber>123456</confirmationnumber> <shipmethod>t</shipmethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1H0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </ddshippingrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 2-4 : Éléments de transaction ddshippingrequestv1 à la page 2-17. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML updateshippinginfo àla page A-4). La requête HTTP Post doit comporter deux paramètres : txnmode updateshippinginfo txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/directdebitws/directdebitservlet/v1 Exemple HTML updateshippinginfo Cet exemple présente une version de formulaire de requête updateshippinginfo contenant l exemple ci-dessus que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title> Test de transaction par prélèvement automatique</title> <body> <form NAME="Direct Debit" METHOD="post" ACTION="https://webservices.optimalpayments.com/directdebitWS/DirectDebitServlet/v1" > A-4

juillet 2014 ddlookuprequest <input type=hidden name="txnmode" value="updateshippinginfo" > <br> <b>corps du message XML :</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10> <ddshippingrequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <carrier>fex</carrier> <trackingnumber>555666888999</trackingnumber> <confirmationnumber>123456</confirmationnumber> <shipmethod>t</shipmethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1H0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </ddshippingrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"></form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. ddlookuprequest Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Création de lookuprequest (requêtes de consultation) à la page 2-18. Pour envoyer une requête de consultation par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ddlookuprequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <merchantrefnum>ref-12345</merchantrefnum> <startdate> Guide de référence de l API pour les Services Web 1.0 A-5

Utilisation de la méthode HTTP Post juillet 2014 <year>2012</year> <month>1</month> <day>1</day> <hour>12</hour> <minute>1</minute> <second>1</second> </startdate> <enddate> <year>2012</year> <month>1</month> <day>1</day> <hour>23</hour> <minute>59</minute> <second>59</second> </enddate> </<ddlookuprequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 2-5 : Éléments de transaction ddlookuprequestv1 à la page 2-20. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML lookuprequest à la page A-6). La requête HTTP Post doit comporter deux paramètres : txnmode lookup txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/directdebitws/directdebitservlet/v1 Exemple HTML lookuprequest Cet exemple présente une version de formulaire de requête de consultation contenant l exemple ci-dessus que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title> Test de transaction par prélèvement automatique</title> <body> <form NAME="Direct Debit" METHOD="post" ACTION="https://webservices.optimalpayments.com/directdebitWS/DirectDebitServlet/v1" > <input type=hidden name="txnmode" value="lookup" > <br> <b>corps du message XML :</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10> <ddlookuprequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> A-6

juillet 2014 ddmandaterequest <merchantrefnum>ref-12345</merchantrefnum> <startdate> <year>2012</year> <month>1</month> <day>1</day> <hour>12</hour> <minute>1</minute> <second>1</second> </startdate> <enddate> <year>2012</year> <month>1</month> <day>1</day> <hour>23</hour> <minute>59</minute> <second>59</second> </enddate> </<ddlookuprequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"></form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. ddmandaterequest Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Création de mandaterequest pour BACS (requêtes de mandat) à la page 2-22. Pour envoyer une requête mandat par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ddmandaterequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <check> <bankname>chase</bankname> <accountnum>987654321</accountnum> <routingnum>123456</routingnum> </check> <billingdetails> <checkpaymethod>web</checkpaymethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> Guide de référence de l API pour les Services Web 1.0 A-7

Utilisation de la méthode HTTP Post juillet 2014 <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> <autosend>y</autosend> </ddmandaterequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Table 2-6: Éléments de transaction ddmandaterequestv1 à la page 2-26. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML lookuprequest à la page A-6). La requête HTTP Post doit comporter deux paramètres : txnmode mandate txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/directdebitws/directdebitservlet/v1 Exemple HTML mandaterequest Cet exemple présente une version de formulaire de requête de mandat contenant l exemple cidessus que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>netbanx - Direct Debit Test</title> <body> <form NAME="Direct Debit" METHOD="post" ACTION="https://webservices.optimalpayments.com/directdebitWS/DirectDebitServlet/v1" <input type=hidden name="txnmode" value="mandate" > <br> <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10> <ddmandaterequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <check> <bankname>chase</bankname> <accountnum>987654321</accountnum> <routingnum>123456</routingnum> </check> <billingdetails> <checkpaymethod>web</checkpaymethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> <country>ca</country> A-8

juillet 2014 changestatusrequest <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> <autosend>y</autosend> </ddmandaterequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"></form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. changestatusrequest Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Création de changestatusrequest (requêtes de modification d état) à la page 2-29. Pour envoyer une requête de modification d état par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ddchangestatusrequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <status>c</status> </ddchangestatusrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 2-8 : Éléments de transaction ddchangestatusrequestv1 à la page 2-31. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML lookuprequest à la page A-6). La requête HTTP Post doit comporter deux paramètres : txnmode changestatus txnrequest La requête de transaction ci-dessus 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/directdebitws/directdebitservlet/v1 Guide de référence de l API pour les Services Web 1.0 A-9

Utilisation de la méthode HTTP Post juillet 2014 Exemple HTML changestatusrequest Cet exemple présente une version de formulaire de requête changestatusrequest contenant l exemple ci-dessus que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>netbanx - Direct Debit Transaction</title> <body> <form NAME="Direct Debit" METHOD="post" ACTION="https://webservices.optimalpayments.com/directdebitWS/DirectDebitServlet/v1" <input type=hidden name="txnmode" value="changestatus" > <br> <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10> <ddchangestatusrequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <status>c</status> </ddchangestatusrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"></form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. updatemandaterequest Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Création de updatemandaterequest (mise à jour du mandat) à la page 2-32. Pour envoyer une requête de mise à jour du mandat par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ddupdatemandaterequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <mandatereference>pdestest7a</mandatereference> <accountnum>nl77abna0574908765</accountnum> <routingnum>abnanl2a</routingnum> A-10

juillet 2014 updatemandaterequest </ddupdatemandaterequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 2-9 : Éléments de transaction ddupdatemandaterequestv1 à la page 2-34. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML updatemandaterequest àla page A-11). La requête HTTP Post doit comporter deux paramètres : txnmode updatemandate txnrequest La requête de transaction ci-dessus 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/directdebitws/directdebitservlet/v1 Exemple HTML updatemandaterequest Cet exemple présente une version de formulaire de requête updatemandaterequest contenant l exemple ci-dessus que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>netbanx - Direct Debit Transaction</title> <body> <form NAME="Direct Debit" METHOD="post" ACTION="https://webservices.optimalpayments.com/directdebitWS/DirectDebitServlet/v1" <input type=hidden name="txnmode" value="updatemandate" > <br> <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10> <ddupdatemandaterequestv1 xmlns="http://www.optimalpayments.com/directdebit/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <mandatereference>pdestest7a</mandatereference> <accountnum>nl77abna0574908765</accountnum> <routingnum>abnanl2a</routingnum> </ddupdatemandaterequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Send Request"></form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Guide de référence de l API pour les Services Web 1.0 A-11

Utilisation de la méthode HTTP Post juillet 2014 Requêtes relatives à une carte de crédit Achat, autorisation et vérification Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Bâtir des requêtes d achat, d autorisation ou de vérification à la page 3-5. Pour envoyer une requête de transaction d achat, d autorisation ou de vérification de carte de crédit par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ccauthrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <card> <cardnum>4653111111111111</cardnum> <cardexpiry> <month>11</month> <year>2008</year> </cardexpiry> <cardtype>vi</cardtype> <cvdindicator>1</cvdindicator> <cvd>111</cvd> </card> <authentication> <indicator>05</indicator> <cavv>aaabb4wzlqaaaaaacjmveniwiv+=</cavv> <xid>q2prwui2rfnbc3fotxnlem50ewy=</xid> </authentication> <billingdetails> <cardpaymethod>web</cardpaymethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> <shippingdetails> <carrier>fex</carrier> <shipmethod>t</shipmethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>44 rue Principale</street> <city>alma</city> <state>qc</state> A-12

juillet 2014 Achat, autorisation et vérification <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </shippingdetails> <recurring> <recurringindicator>i</recurringindicator> <originalconfirmationnumber>115147689</originalconfirmationnumber> </recurring> <customerip>127.0.0.1</customerip> <producttype>m</producttype> <addendumdata> <tag>cust_acct_open_date</tag> <value>20041012</value> </addendumdata> <addendumdata> <tag>merchant_country_code</tag> <value>us</value> </addendumdata> <addendumdata> <tag>service_request_currency</tag> <value>on</value> </addendumdata> </ccauthrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-2 : Éléments de transaction ccauthrequestv1 à la page 3-8. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Autorisation àla page A-13). La requête HTTP Post doit comporter deux paramètres : txnmode ccauthorize, ccpurchase ou ccverification. txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Autorisation Cet exemple présente une version de formulaire de requête d autorisation de carte de crédit, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX. Pour convertir cette requête en requête d achat ou de vérification, il suffit de remplacer la valeur «ccauthorize» de txnmode (soulignée ci-dessous) par «ccpurchase» ou par «ccverification» respectivement. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>credit Card Test</title> <body> <form NAME="Credit Card" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="ccauthorize" > <b>xml Message body:</b> Guide de référence de l API pour les Services Web 1.0 A-13

Utilisation de la méthode HTTP Post juillet 2014 <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <ccauthrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <card> <cardnum>4653111111111111</cardnum> <cardexpiry> <month>11</month> <year>2008</year> </cardexpiry> <cardtype>vi</cardtype> <cvdindicator>1</cvdindicator> <cvd>111</cvd> </card> <authentication> <indicator>05</indicator> <cavv>aaabb4wzlqaaaaaacjmveniwiv+=</cavv> <xid>q2prwui2rfnbc3fotxnlem50ewy=</xid> </authentication> <billingdetails> <cardpaymethod>web</cardpaymethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> <shippingdetails> <carrier>fex</carrier> <shipmethod>t</shipmethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>44 rue Principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </shippingdetails> <recurring> <recurringindicator>i</recurringindicator> <originalconfirmationnumber>115147689</originalconfirmationnumber> </recurring> <customerip>127.0.0.1</customerip> <producttype>m</producttype> <addendumdata> <tag>cust_acct_open_date</tag> A-14

juillet 2014 Inversion d autorisation <value>20041012</value> </addendumdata> <addendumdata> <tag>merchant_country_code</tag> <value>us</value> </addendumdata> <addendumdata> <tag>service_request_currency</tag> <value>on</value> </addendumdata> </ccauthrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Inversion d autorisation Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Bâtir des requêtes d inversion d autorisation à la page 3-19. Pour envoyer une requête de transaction d inversion d autorisation de carte de crédit par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ccauthreversalrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>115147689</confirmationnumber> <merchantrefnum>ar2</merchantrefnum> <reversalamount>18.00</reversalamount> </ccauthreversalrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-4 : Éléments de transaction ccauthreversalrequestv1 à la page 3-20. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Inversion d autorisation à la page A-16). Guide de référence de l API pour les Services Web 1.0 A-15

Utilisation de la méthode HTTP Post juillet 2014 La requête HTTP Post doit comporter deux paramètres : txnmode ccauthorizereversal txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Inversion d autorisation Cet exemple présente une version de formulaire de requête d inversion d autorisation de carte de crédit, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>reverse Authorization Transaction</title> <body> <form NAME="Credit Card" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="ccauthorizereversal" > <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <ccauthreversalrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>115147689</confirmationnumber> <merchantrefnum>ar2</merchantrefnum> <reversalamount>18.00</reversalamount> </ccauthreversalrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Règlement et crédit Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Bâtir des requêtes de règlement et de crédit à la page 3-21. A-16

juillet 2014 Règlement et crédit Pour envoyer une requête de transaction de règlement ou de crédit de carte de crédit par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ccpostauthrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <addendumdata> <tag>merchant_data</tag> <value>merchant_data</value> </addendumdata> </ccpostauthrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-5 : Éléments de transaction ccpostauthrequestv1 à la page 3-24. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Règlement à la page A-17). La requête HTTP Post doit comporter deux paramètres : txnmode ccsettlement ou cccredit. txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Règlement Cet exemple présente une version de formulaire de requête de règlement de carte de crédit, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX. Pour convertir cette requête en requête de crédit, il suffit de remplacer la valeur «ccsettlement» de txnmode (souligné ci-dessous) par «cccredit». <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>credit Card Test</title> <body> <form NAME="Credit Card" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="ccsettlement" > <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <ccpostauthrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> Guide de référence de l API pour les Services Web 1.0 A-17

Utilisation de la méthode HTTP Post juillet 2014 <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <addendumdata> <tag>merchant_data</tag> <value>merchant_data</value> </addendumdata> </ccpostauthrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Autorisation ou achat à partir de données mémorisées Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Bâtir des requêtes de données mémorisées à la page 3-26. Pour envoyer par HTTP Post une requête de transaction d autorisation ou d achat à partir de données mémorisées : 1. Créez une requête de transaction semblable à l exemple suivant : <ccstoreddatarequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <confirmationnumber>123456</confirmationnumber> <amount>18.00</amount> <cvdindicator>1</cvdindicator> <cvd>111</cvd> </ccstoreddatarequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-6 : Éléments de transaction ccstoreddatarequestv1 à la page 3-28. A-18

juillet 2014 Autorisation ou achat à partir de données mémorisées 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Autorisation à partir de données mémorisées à la page A-19). La requête HTTP Post doit comporter deux paramètres : txnmode ccstoreddataauthorize ou ccstoreddatapurchase. txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Autorisation à partir de données mémorisées Cet exemple présente une version de formulaire de requête d autorisation à partir de données mémorisées de carte de crédit, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX. Pour convertir cette requête en requête d achat à partir de données mémorisées, il suffit de remplacer la valeur «ccstoreddataauthorize» de txnmode (souligné ci-dessous) par «ccstoreddatapurchase». <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>credit Card Test</title> <body> <form NAME="Credit Card" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="ccstoreddataauthorize" > <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <ccstoreddatarequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <confirmationnumber>123456</confirmationnumber> <amount>18.00</amount> <cvdindicator>1</cvdindicator> <cvd>111</cvd> </ccstoreddatarequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Guide de référence de l API pour les Services Web 1.0 A-19

Utilisation de la méthode HTTP Post juillet 2014 Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Annuler un règlement, un crédit, un paiement, ou un crédit indépendant Pour en savoir davantage sur ces types de requêtes, consultez la rubrique Bâtir des requêtes d annulation à la page 3-30. Pour annuler une requête de règlement, de crédit, de paiement, ou de crédit indépendant par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <cccancelrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <addendumdata> <tag>merchant_data</tag> <value>merchant_data</value> </addendumdata> </cccancelrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-7 : Éléments de transaction cccancelrequestv1 à la page 3-33. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Annuler à la page A-20). La requête HTTP Post doit comporter deux paramètres : txnmode cccancelsettle, cccancelcredit, cccancelpayment, ou cccancelindependentcredit. txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Annuler Cet exemple présente une version de formulaire de requête d annulation de règlement de carte de crédit, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX pour annuler une transaction de règlement. Pour convertir cette requête en requête d annulation de crédit, de paiement, ou de crédit indépendant, il suffit de remplacer la valeur «cccancelsettle» de txnmode (soulignée ci-dessous) par «cccancelcredit», par «cccancelpayment», ou par «cccancelindependentcredit» respectivement. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> A-20

juillet 2014 Requête de paiement <html> <title>credit Card Test</title> <body> <form NAME="Credit Card" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="cccancelsettle" > <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <cccancelrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <addendumdata> <tag>merchant_data</tag> <value>merchant_data</value> </addendumdata> </cccancelrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Requête de paiement Pour en savoir davantage sur ce type de requête, consultez la rubrique Bâtir des requêtes de paiement/crédit indépendant à la page 3-34. Pour effectuer une requête de paiement par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ccpaymentrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <card> <cardnum>4653111111111111</cardnum> Guide de référence de l API pour les Services Web 1.0 A-21

Utilisation de la méthode HTTP Post juillet 2014 <cardexpiry> <month>11</month> <year>2008</year> </cardexpiry> <cardtype>vi</cardtype> <cvdindicator>1</cvdindicator> <cvd>111</cvd> </card> <billingdetails> <cardpaymethod>web</cardpaymethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> </ccpaymentrequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-8 : Éléments de transaction ccpaymentrequestv1 à la page 3-36. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Paiement àla page A-22). La requête HTTP Post doit comporter deux paramètres : txnmode ccpayment ou ccindependentcredit txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Paiement Pour convertir cette requête en requête de crédit indépendant, il suffit de remplacer la valeur «ccpayment» de txnmode (soulignée ci-dessous) par «ccindependentcredit». Cet exemple présente une version de formulaire de requête de paiement de carte de crédit, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>cc Payment</title> </head> <body> <h1> Credit Card Webservice Tester </h1> <form NAME="creditcard" id="creditcard" METHOD="post" ACTION="https://webservices.optimalpayments/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="ccpayment" > A-22

juillet 2014 Consultation des données <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <ccpaymentrequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>10.00</amount> <card> <cardnum>4653111111111111</cardnum> <cardexpiry> <month>11</month> <year>2008</year> </cardexpiry> <cardtype>vi</cardtype> <cvdindicator>1</cvdindicator> <cvd>111</cvd> </card> <billingdetails> <cardpaymethod>web</cardpaymethod> <firstname>jeanne</firstname> <lastname>tremblay</lastname> <street>123 rue Principale</street> <city>alma</city> <state>qc</state> <country>ca</country> <zip>g0w 1G0</zip> <phone>555-555-5555</phone> <email>jeannetremblay@emailserver.com</email> </billingdetails> </ccpaymentrequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Consultation des données Pour en savoir davantage sur ce type de requête, consultez la rubrique Bâtir des requêtes de consultation des données à la page 3-39. Guide de référence de l API pour les Services Web 1.0 A-23

Utilisation de la méthode HTTP Post juillet 2014 Pour effectuer une requête de paiement par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <cctxnlookuprequestv1 xmlns="http://www.optimalpayments.com/ creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <merchantrefnum>ref-12345</merchantrefnum> <startdate> <year>2012</year> <month>1</month> <day>1</day> <hour>12</hour> <minute>1</minute> <second>1</second> </startdate> <enddate> <year>2012</year> <month>1</month> <day>1</day> <hour>23</hour> <minute>59</minute> <second>59</second> </enddate> </cctxnlookuprequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Table 3-9: Éléments de transaction cctxnlookuprequestv1 à la page 3-42. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Consultation des données àla page A-24). La requête HTTP Post doit comporter deux paramètres : txnmode cctxnlookup txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Consultation des données <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>consultation des données</title> <form NAME="Consultation des données" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="cctxnlookup" > <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=25 > A-24

juillet 2014 Consultation d inscription <cctxnlookuprequestv1 xmlns="http://www.optimalpayments.com/ creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <merchantrefnum>ref-12345</merchantrefnum> <startdate> <year>2012</year> <month>1</month> <day>1</day> <hour>12</hour> <minute>1</minute> <second>1</second> </startdate> <enddate> <year>2012</year> <month>1</month> <day>1</day> <hour>23</hour> <minute>59</minute> <second>59</second> </enddate> </cctxnlookuprequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Consultation d inscription Pour en savoir davantage sur ce type de requête, consultez la rubrique Bâtir des requêtes de consultation d inscription à la page 3-43. Pour envoyer une requête de transaction de consultation d inscription de carte de crédit par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ccenrollmentlookuprequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> Guide de référence de l API pour les Services Web 1.0 A-25

Utilisation de la méthode HTTP Post juillet 2014 <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>21.00</amount> <card> <cardnum>4000000000000002</cardnum> <cardexpiry> <month>01</month> <year>2011</year> </cardexpiry> <cardtype>vi</cardtype> </card> </ccenrollmentlookuprequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-10 : Éléments de transaction ccenrollmentlookuprequestv1 à la page 3-46. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Consultation d inscription àla page A-26). La requête HTTP Post doit comporter deux paramètres : txnmode cctdslookup txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Exemple HTML Consultation d inscription <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>enrollment Lookup</title> <form NAME="Enrollment Lookup" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="cctdslookup" > <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=25 > <ccenrollmentlookuprequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <merchantrefnum>ref-12345</merchantrefnum> <amount>21.00</amount> <card> <cardnum>4653111111111111</cardnum> <cardexpiry> A-26

juillet 2014 Authentification <month>01</month> <year>2011</year> </cardexpiry> <cardtype>vi</cardtype> </card> </ccenrollmentlookuprequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Authentification Pour en savoir davantage sur ce type de requête, consultez la rubrique Bâtir des requêtes d authentification à la page 3-47. Pour envoyer une requête de transaction d authentification de carte de crédit par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ccauthenticaterequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <paymentresponse>mypaymentresponse</paymentresponse> </ccauthenticaterequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 3-11 : Éléments de transaction ccauthenticaterequestv1 à la page 3-49. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML Authentification à la page A-28). La requête HTTP Post doit comporter deux paramètres : txnmode cctdsauthenticate txnrequest La requête de transaction ci-dessus. 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/creditcardws/creditcardservlet/v1 Guide de référence de l API pour les Services Web 1.0 A-27

Utilisation de la méthode HTTP Post juillet 2014 Exemple HTML Authentification Cet exemple présente une version de formulaire de requête d authentification de carte de crédit, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>credit Card Test</title> <body> <form NAME="Credit Card" METHOD="post" ACTION="https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1"> <input type=hidden name="txnmode" value="cctdsauthenticate" > <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <ccauthenticaterequestv1 xmlns="http://www.optimalpayments.com/creditcard/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/creditcard/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <confirmationnumber>123456</confirmationnumber> <paymentresponse>mypaymentresponse</paymentresponse> </ccauthenticaterequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. Requêtes relatives au service de consultation des données Pour en savoir davantage sur ce type de requête, consultez la rubrique Bâtir des requêtes ILS à la page 4-3. Pour envoyer une requête ILS par HTTP Post : 1. Créez une requête de transaction semblable à l exemple suivant : <ilslookuprequestv1 xmlns="http://www.optimalpayments.com/ils/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/ils/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> A-28

juillet 2014 Exemple HTML ILS </merchantaccount> <startdate> <year>2008</year> <month>03</month> <day>05</day> <hour>00</hour> <minute>00</minute> <second>00</second> </startdate> <enddate> <year>2008</year> <month>03</month> <day>05</day> <hour>23</hour> <minute>59</minute> <second>59</second> </enddate> <type>authorizations</type> <type>settlements</type> <type>credits</type> <type>chargebacks</type> </ilslookuprequestv1> Pour obtenir la liste et la description des paramètres à inclure dans cette requête, consultez le Tableau 4-1 : Éléments de transaction ilslookuprequestv1 à la page 4-6. 2. Insérez cette requête de transaction dans une requête HTTP Post (consultez la rubrique Exemple HTML ILS àla page A-29). 3. Envoyez la requête HTTP Post à l URL suivante : https://webservices.optimalpayments.com/ilsws/ilsservlet/v1 Exemple HTML ILS Cet exemple présente une version de formulaire de requête ILS, contenant l exemple ci-dessus, que vous pourriez envoyer à NETBANX. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <title>information Lookup Service</title> <body> <form NAME="ILS" METHOD="post" ACTION="https://webservices.optimalpayments.com/ilsWS/IlsServlet/v1"> <b>xml Message body:</b> <TEXTAREA class="xmlbox" name="txnrequest" COLS=100 ROWS=10 > <ilslookuprequestv1 xmlns="http://www.optimalpayments.com/ils/xmlschema/v1" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.optimalpayments.com/ils/xmlschema/v1"> <merchantaccount> <accountnum>12345678</accountnum> <storeid>mystoreid</storeid> <storepwd>mystorepwd</storepwd> </merchantaccount> <startdate> <year>2008</year> <month>03</month> <day>05</day> Guide de référence de l API pour les Services Web 1.0 A-29

Utilisation de la méthode HTTP Post juillet 2014 <hour>00</hour> <minute>00</minute> <second>00</second> </startdate> <enddate> <year>2008</year> <month>03</month> <day>05</day> <hour>23</hour> <minute>59</minute> <second>59</second> </enddate> <type>authorizations</type> <type>settlements</type> <type>credits</type> <type>chargebacks</type> </ilslookuprequestv1> </TEXTAREA> <br> <input TYPE=submit class=input VALUE="Envoyer la requête"> </form> </body> </html> La taille maximale de fichier prise en charge est de 100 Ko. Si votre requête HTTP Post dépasse les 100 Ko, elle échouera. Pour voir le résultat affiché dans un navigateur, consultez la rubrique HTTP Post Exemples à la page A-30. Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. HTTP Post Exemples Voici l aspect qu auraient les exemples de requêtes HTTP Post des types de transactions décrites dans le présent chapitre s ils étaient affichés dans un navigateur : Si vous cliquez sur le bouton Envoyer la requête, la transaction sera envoyée à NETBANX par HTTP Post. A-30

juillet 2014 HTTP Post Réponses aux requêtes HTTP Post Réponses aux requêtes NETBANX retourne une réponse semblable à celle qui suit lorsqu une requête de transaction réussit : NETBANX retourne une réponse semblable à celle qui suit lorsqu une requête de transaction échoue : Vous trouverez une explication aux éléments de la réponse dans la rubrique Traitement de la réponse à la page 3-50. Pour obtenir une explication des codes d erreur, consultez la rubrique Codes de réponse à la page B-1. Guide de référence de l API pour les Services Web 1.0 A-31

Utilisation de la méthode HTTP Post juillet 2014 A-32

ANNEXE B Codes de réponse Aperçu Les Services Web de NETBANX peuvent retourner divers types de codes lors de l échec d une tentative de transaction : Codes de réponse Codes d action Codes de refus Codes de réponse Le tableau suivant décrit les codes de réponse qui peuvent être retournés par les Services Web de NETBANX. Tableau B-1 : Codes de réponse Code de réponse Action Description 1000 R Une erreur interne s est produite. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 1001 R Une erreur s est produite au niveau de la passerelle de traitement externe. Veuillez réessayer la transaction. 1002 R Une erreur interne s est produite. Veuillez réessayer la transaction. 1003 D Une erreur s est produite au niveau de la passerelle de traitement externe. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 1004 M Votre compte ne permet pas ce type de transaction. Veuillez vérifier vos paramètres et réessayer la transaction. 1006 D Une erreur s est produite au niveau de la passerelle de traitement externe. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 1007 R Une erreur interne s est produite. Veuillez réessayer la transaction. 1008 D Une erreur interne s est produite. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 1018 D La passerelle de traitement externe a signalé que la transaction n est pas autorisée. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 1028 M La passerelle de traitement externe a signalé des données non valides. Veuillez vérifier vos paramètres et réessayer la transaction. 1043 D La passerelle de traitement externe a signalé que le type de compte n est pas valide. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 1060 D La passerelle de traitement externe a signalé qu une limite a été atteinte. Ne réessayez pas la transaction. 1078 R La passerelle de traitement externe a signalé une erreur système. Veuillez réessayer la transaction. Guide de référence de l API pour les Services Web 1.0 B-1

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 1087 D La passerelle de traitement externe a rejeté la transaction. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2000 D L état du chèque électronique est introuvable. 2001 C Le numéro de chèque indiqué dans votre requête a déjà été utilisé au cours des 24 dernières heures. Veuillez utiliser une autre valeur pour le numéro de chèque et réessayer la transaction. 2002 M La requête du chèque électronique est introuvable. Veuillez vérifier vos paramètres et réessayer. 2003 M Le type de paiement indiqué est incompatible avec le type de compte bancaire indiqué. Veuillez vérifier vos paramètres et réessayer la transaction. 2004 D La transaction de chèque électronique est introuvable. 2005 M Une erreur interne s est produite. Veuillez vérifier vos paramètres et réessayer la transaction. 2006 C Vous avez répondu Refuser la transaction à une tentative de règlement. 2007 M Le type de paiement inclus dans votre requête ne peut être utilisé en mode de transaction de crédit. Veuillez vérifier vos paramètres et envoyer de nouveau la requête. 2008 C Vous avez indiqué un numéro d acheminement non valide. Veuillez vérifier votre paramètre et réessayer la transaction. 2009 C Vous avez indiqué un numéro de compte bancaire non valide. Veuillez vérifier votre paramètre et réessayer la transaction. 2010 C Vous avez indiqué un numéro de chèque non valide. Veuillez vérifier votre paramètre et réessayer la transaction. 2011 M Vous avez indiqué une référence du mandat qui n existe pas. Veuillez vérifier votre paramètre et réessayer la transaction. 2012 M Vous avez indiqué une référence du mandat qui n est pas active en ce moment. Veuillez soumettre votre demande lorsque que le mandat sera actif ou soumettez votre demande à nouveau en ajoutant une date txndate après : <date>. 2013 M Vous avez indiqué une référence du mandat non valide. Veuillez vérifier votre paramètre et réessayer la transaction. 2014 M La référence du mandat est déjà utilisée pour les informations spécifiées du compte bancaire. Veuillez spécifier une référence du mandat différente. 2100 D Vous avez tenté de rembourser une transaction de débit qui n a pas été effectuée. Ne réessayez pas la transaction. 2101 R Le remboursement demandé est supérieur au montant débité restant. Veuillez vérifier vos paramètres et réessayer la transaction. 2102 R Le pays de l institution financière indiqué dans votre requête n est pas valide. Veuillez vérifier votre paramètre et réessayer la transaction. 2500 D Aucun compte de marchand approprié n a été trouvé pour cette requête. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2501 D Une erreur interne s est produite. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. B-2

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 2502 M Échec de l authentification relative à votre requête de transaction. Les justificatifs d identité n ont pas été saisis correctement ou votre requête a été trafiquée. Veuillez vérifier votre requête et réessayer la transaction. 2503 M L ID de magasin indiqué n est pas valide. Il doit être représenté par une valeur numérique. 2504 M L ID de magasin indiqué ne correspond à aucun magasin. Veuillez vérifier vos paramètres et réessayer la transaction. 2505 M Aucun compte de marchand n a été trouvé pour la devise indiquée. Veuillez vérifier vos paramètres et réessayer la transaction. 2506 M Plus d un compte de marchand a été trouvé pour la devise indiquée. Veuillez fournir un numéro de compte de marchand et envoyer de nouveau la requête. 2507 M Le compte de marchand indiqué ne correspond pas à l ID de magasin indiqué. Veuillez vérifier vos paramètres et réessayer la transaction. 2508 M Le paramètre encodedmessage est absent de votre requête. Veuillez vérifier vos paramètres et réessayer la transaction. 2509 M Le paramètre encodedmessage de votre requête n est pas valide. Le paramètre encodedmessage n a pu être décodé en base 64. Veuillez vérifier vos paramètres et envoyer de nouveau la requête. 2510 M Votre requête XML n est pas valide. Veuillez vérifier votre requête et réessayer la transaction. 2511 R Une erreur interne s est produite. Veuillez réessayer la transaction. Si l erreur persiste, communiquez avec le soutien technique. 2512 M Le paramètre signature est absent de votre requête. Veuillez vérifier vos paramètres et réessayer la transaction. 2513 M Le paramètre ID de magasin est absent de votre requête. Veuillez vérifier vos paramètres et réessayer la transaction. 2514 D Une erreur interne s est produite. Vos justificatifs d identité de marchand sont introuvables. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2515 R Une erreur interne s est produite. Veuillez réessayer la transaction. 2516 D Une erreur interne s est produite. Ne réessayez pas la transaction. Veuillez communiquer avec le soutien technique. 2517 D Une erreur interne s est produite. Ne réessayez pas la transaction. Veuillez communiquer avec le soutien technique. 2518 R Une erreur interne s est produite. Veuillez réessayer la transaction. Si l erreur persiste, communiquez avec le soutien technique. 2519 D Le magasin indiqué dans votre requête est désactivé. Ne réessayez pas la transaction. 2520 M La somme de cartitem et de feeitem ne correspond pas à totalamount. Veuillez vérifier vos paramètres et réessayer la transaction. 2521 D Une erreur interne s est produite. Votre magasin n est pas correctement configuré. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2523 R Une erreur interne s est produite. Veuillez réessayer la transaction. Si l erreur persiste, communiquez avec le soutien technique. Guide de référence de l API pour les Services Web 1.0 B-3

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 2524 D Une erreur interne s est produite. Le profil client n est pas correctement configuré. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2525 M Le profil client associé au jeton fourni est introuvable. Veuillez vérifier vos paramètres et réessayer la transaction. 2526 R Une erreur interne de gestion de profil s est produite et votre requête n a pu être traitée. Veuillez réessayer la transaction. Si l erreur persiste, communiquez avec le soutien technique. 2527 M Le lieu indiqué dans votre requête n est pas pris en charge. Veuillez vérifier vos paramètres et réessayer la transaction. 2528 M L ID de client du marchand indiqué dans votre requête n est pas associé au jeton de client fourni. Veuillez vérifier vos paramètres et réessayer la transaction. 2529 R Une erreur interne s est produite. Veuillez réessayer la transaction. 2530 D Une erreur interne s est produite. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2531 M Un profil client associé au même ID de client du marchand existe déjà. Veuillez vérifier vos paramètres et réessayer la transaction. 2532 D Votre magasin n est pas configuré pour le traitement de paiements. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2533 D Votre magasin n est pas configuré pour traiter le mode de paiement sélectionné. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2534 M Le profil client associé au jeton fourni n est pas actif. Veuillez vérifier vos paramètres et vous assurer que l état du client est actif, puis réessayez la transaction. 2535 M Le profil client associé au jeton fourni comporte un compte bancaire non validé. Veuillez vérifier vos paramètres ou demander à votre client de valider le compte bancaire, puis réessayez la transaction. 2536 D La transaction a été refusée parce que le nombre maximum de tentatives a été atteint. Ne réessayez pas la transaction. 2537 D La validation du compte bancaire a échoué parce que le nombre maximum de tentatives a été atteint. Ne réessayez pas la transaction. 2538 D Le client a entré un montant de microdépôt non valide. 2539 R Une erreur interne s est produite. Veuillez réessayer la transaction. Si l erreur persiste, communiquez avec le soutien technique. 2540 M Le numéro de référence du marchand existe déjà. Veuillez vérifier vos paramètres et réessayer la transaction. 2541 R Une erreur interne s est produite lors de l envoi de la transaction de microdépôt. Veuillez réessayer la transaction. Si l erreur persiste, communiquez avec le soutien technique. 2542 D Échec de la vérification AVS lors de la validation du profil client. 2543 M L état du client ne peut être validé. Veuillez réinitialiser l état du client avant de réessayer la transaction. 2544 D Le profil client ne comprend pas les renseignements sur la carte de crédit nécessaires à la validation. B-4

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 2545 D Le client a tenté d enregistrer un compte bancaire de TEF déjà utilisé par un autre client. Ne réessayez pas la transaction. 2546 D Le client a tenté d enregistrer une carte de crédit déjà utilisée par un autre client. Ne réessayez pas la transaction. 2547 M Le profil client associé au jeton fourni ne comporte pas de carte de crédit. Veuillez vérifier vos paramètres et réessayer la transaction. 2548 M Le profil client utilisé pour cette transaction n a pas été créé. Veuillez vérifier vos paramètres et réessayer la transaction. 2549 M Votre magasin n est pas configuré en fonction de l enregistrement d un compte bancaire pour le pays indiqué. Veuillez vérifier vos paramètres et réessayer la transaction. 2550 M Le profil client associé au jeton fourni ne comporte pas de compte bancaire enregistré. Veuillez vérifier vos paramètres et réessayer la transaction. 2551 M Le mode de paiement dans votre requête n est pas valide. Veuillez vérifier vos paramètres et réessayer la transaction. 2552 M L ID de transaction de votre requête n'est pas valide. Veuillez vérifier vos paramètres et réessayer la transaction. 2553 D Notre système n est pas en mesure de trouver la réponse confirmant l inscription associée à votre requête d ID de transaction. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 2554 M Le profil client associé au jeton fourni est désactivé. Veuillez vérifier vos paramètres et vous assurer que l état du client est actif, puis réessayez la transaction. 2555 M Le jeton n est pas associé au profil client fourni. Veuillez vérifier vos paramètres et réessayer la transaction. 2556 M La carte de crédit fournie pour cette transaction n est pas activée pour le moment. Veuillez vérifier vos paramètres et réessayer la transaction. 2557 M Le numéro de confirmation indiqué dans la requête est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 2558 M La transaction ne peut être annulée. Veuillez vérifier vos paramètres et assurez-vous d annuler la bonne transaction. Si l erreur persiste, communiquez avec le soutien technique. 2701 Aucune La validation par Equifax a été acceptée à la condition que la requête du client soit vérifiée. 2702 R Une erreur interne s est produite lors du traitement d une transaction Equifax. Réessayez la transaction. Si l erreur persiste, communiquez avec le soutien technique. 2703 R Les bases de données d Equifax sont totalement ou partiellement hors service. Réessayez la transaction. Si l erreur persiste, communiquez avec le soutien technique. 2704 D La validation par Equifax a été rejetée. Ne réessayez pas la transaction. 2705 R La validation par Equifax a été rejetée et doit être traitée manuellement. Par exemple, le marchand peut communiquer avec le client directement. 2706 R La validation par Equifax a été rejetée parce que les données entrées ne sont pas valides. Veuillez vérifier vos paramètres et réessayer la transaction. 2707 R La validation par Equifax a été rejetée parce que l adresse n est pas valide. Veuillez vérifier vos paramètres et réessayer la transaction. Guide de référence de l API pour les Services Web 1.0 B-5

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 2708 R Une erreur interne s est produite. Les codes de réponse d Equifax sont absents. Veuillez vérifier vos paramètres et réessayer la transaction. 2709 D L institution financière a rejeté la transaction. Elle n a pas pu traiter la requête. 2710 D Le courriel de confirmation de la transaction n a pu être envoyé car aucun modèle de courriel n est configuré. 2711 M Rejet de la validation pour la mise à jour du profil. Ne réessayez pas la transaction. 3001 C Le type de carte indiqué dans votre requête n est pas pris en charge. Veuillez vérifier ce paramètre et réessayer la transaction. 3002 C Le numéro de carte, la marque de carte ou la combinaison de numéro et de marque de votre requête n est pas valide. Veuillez vérifier ces paramètres et réessayer la transaction. 3003 C La valeur donnée au paramètre cvdindicator dans votre requête est incorrecte. Veuillez vérifier ce paramètre et réessayer la transaction. 3004 C Vous avez demandé une vérification AVS. Assurez-vous que le code postal est indiqué. 3005 C La valeur donnée au paramètre cvd dans votre requête est incorrecte. Veuillez vérifier ce paramètre et réessayer la transaction. 3006 C Le numéro de carte de crédit indiqué dans votre requête est expiré. Veuillez vérifier ce paramètre et envoyer de nouveau la requête. 3007 D Échec de la vérification AVS. Veuillez noter que le montant peut avoir été retenu sur la carte du client et sera libéré dans les trois à cinq jours ouvrables. Veuillez vous assurer que l adresse de facturation est exacte avant de réessayer la transaction. 3008 D Le compte de marchand n est pas configuré en fonction du type de carte indiqué. 3009 D Votre requête a été refusée par l institution financière émettrice. 3011 D Votre requête a été refusée par l institution financière émettrice parce que la carte utilisée fait l objet de restrictions. Communiquez avec la société émettrice de la carte de crédit du titulaire pour obtenir de plus amples renseignements. 3012 D Votre requête a été refusée par l institution financière émettrice parce que la date d expiration de la carte de crédit indiquée n est pas valide. 3013 D Votre requête a été refusée par l institution financière émettrice en raison de problèmes relatifs au compte de carte de crédit. 3014 D Votre requête a été refusée. L institution financière émettrice a donné une réponse inconnue. Communiquez avec la société émettrice de la carte de crédit du titulaire pour obtenir de plus amples renseignements. 3015 D L institution financière a demandé que vous traitiez la transaction manuellement en appelant la société émettrice de la carte de crédit du titulaire. 3016 D L institution financière a demandé que vous récupériez la carte du titulaire; il s agit peutêtre d une carte perdue ou volée. 3017 C Le numéro de carte de crédit indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 3018 R L institution financière a demandé que vous réessayiez la transaction. B-6

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 3019 C Échec de la vérification CVD. Veuillez noter que le montant aurait pu quand même être bloqué sur la carte du client. Si c est le cas, le montant sera libéré dans les trois à cinq jours ouvrables. Veuillez vous assurer que la valeur CVD est exacte avant de réessayer la transaction. 3020 R L institution financière a demandé que vous réessayiez la transaction. 3021 M Le numéro de confirmation indiqué dans la requête est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 3022 D La carte a été refusée pour provision insuffisante. 3023 D Votre requête a été refusée par l institution financière émettrice en raison des règles propres à l institution en ce qui a trait à l activité de ses cartes de crédit. 3024 D Votre requête a été refusée parce que l institution financière émettrice ne permet pas d effectuer cette transaction au moyen de cette carte. 3025 R La passerelle de traitement externe a signalé des données non valides. Veuillez vérifier vos paramètres et réessayer la transaction. 3026 D La passerelle de traitement externe a signalé que le type de compte n est pas valide. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 3027 D La passerelle de traitement externe a signalé qu une limite a été atteinte. Ne réessayez pas la transaction. 3028 R La passerelle de traitement externe a signalé une erreur système. Veuillez réessayer la transaction. 3029 D La passerelle de traitement externe a rejeté la transaction. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 3030 D La passerelle de traitement externe a signalé que la transaction n est pas autorisée. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 3031 M Le numéro de confirmation que vous avez soumis dans la requête est associé à une transaction qui n est pas en attente. 3032 D Votre requête a été refusée par l institution financière émettrice ou par la passerelle de traitement externe en raison du numéro de la carte qui figure dans l une de leurs bases de données négatives. 3200 M Le format de l ID d autorisation du règlement n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 3201 M L ID d autorisation indiqué dans la requête de règlement est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 3202 D Vous avez atteint le nombre maximum de règlements autorisé. Communiquez avec le soutien technique pour obtenir plus de détails. 3203 M L autorisation a été soit réglée en entier, soit annulée. 3204 M Le règlement demandé est supérieur au montant de l autorisation restant. 3205 M L autorisation que vous tentez de régler est périmée. 3206 D La passerelle de traitement externe a rejeté la transaction. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. Guide de référence de l API pour les Services Web 1.0 B-7

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 3402 M Le montant du crédit demandé est supérieur au montant du règlement restant. 3403 M Vous avez déjà traité le nombre maximum de crédits autorisé pour ce règlement. 3404 M Ce règlement a déjà été crédité en entier. 3405 M Le règlement que vous tentez de créditer est périmé. 3406 M Le règlement que vous tentez de créditer n a pas encore été mis en lot. Il n existe pas de fonds de règlement disponibles à créditer. 3407 M Le règlement désigné par l ID de réponse de transaction fourni est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 3408 M Le format de l ID de réponse du règlement ou de l achat initial n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 3409 M L ID d autorisation indiqué dans la requête de crédit est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 3410 M Échec de la requête de remboursement. 3411 M Échec de l annulation de la requête de remboursement. 3412 M La transaction de crédit que vous avez tenté d effectuer n a pas été autorisée parce que votre compte de marchand présente un découvert. 3413 M Le montant du crédit demandé dépasse le ratio de crédit permis par Visa. Veuillez vérifier ce paramètre et réessayer la transaction. 3414 M Le crédit désigné par l ID de réponse de transaction fourni est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 3415 D Vous ne pouvez pas annuler cette transaction. L état de la transaction ne permet pas son annulation. Par exemple, elle peut avoir déjà été traitée et ne plus être en attente. 3416 M La passerelle de traitement externe pour laquelle votre compte de marchand est configuré ne prend pas en charge les règlements partiels. Assurez-vous que le montant du règlement est identique au montant de l autorisation initiale et réessayez la transaction. 3417 M Il existe déjà une autre requête en cours de traitement sur la transaction référencée pour cette requête. SVP utilisez le numéro de confirmation utilisé pour cette requête afin de sortir un rapport ou rechercher pour déterminer les résultats. 3418 M La passerelle de traitement externe pour laquelle votre compte de marchand est configuré ne prend pas en charge les crédit partiels. 3500 M Le numéro de confirmation indiqué dans la requête est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 3501 M Le montant de l inversion d autorisation demandé est supérieur au montant de l autorisation restant. 3502 D Cette autorisation a déjà été réglée. Vous ne pouvez pas effectuer une transaction d inversion d autorisation sur une autorisation réglée. 3503 M La transaction d inversion d autorisation n est pas prise en charge pour le type de carte utilisée pour l autorisation que vous tentez d inverser. 3504 M La passerelle de traitement externe pour laquelle votre compte de marchand est configuré ne prend pas en charge les inversions d autorisation partielles. Assurez-vous que le montant de l inversion est identique au montant de l autorisation initiale et réessayez la transaction. 3505 M Impossible d effectuer l inversion d autorisation. B-8

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 3506 M Le montant de l inversion est supérieur au montant d autorisation restant. 3601 D Échec de l authentification 3D Secure du titulaire de carte par la société émettrice. 3602 M Le numéro de confirmation indiqué dans la requête d authentification 3D Secure est introuvable. Le numéro de confirmation doit être le numéro retourné en réponse à l autorisation ou à l achat initial par le processeur de paiement. 3603 M Vous avez envoyé une requête qu il n est pas possible d exécuter pour l authentification 3D Secure. 3604 D La requête d autorisation ou d achat initiale est périmée. La requête d authentification 3D Secure doit être effectuée dans les 60 minutes qui suivent l autorisation ou l achat initial. 3605 D Le service d authentification 3D Secure n était pas disponible pour la carte utilisée lors de cette transaction. 3701 M Le numéro de confirmation indiqué dans la requête est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. 3702 D Vous ne pouvez pas annuler cette transaction de paiement. L état de la transaction ne permet pas son annulation. Par exemple, elle peut avoir déjà été traitée et ne plus être en attente. 3703 C La passerelle de traitement externe a signalé que le montant indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 3800 D La transaction a été refusée par la passerelle d authentification. Ne réessayez pas la transaction. 3801 D La transaction a été refusée par la passerelle de paiement. Ne réessayez pas la transaction. 3802 R La transaction n a pas été effectuée. Veuillez réessayer la transaction. 3803 D Échec de la tentative de transaction. Ne réessayez pas la transaction. Veuillez communiquer avec le soutien technique pour obtenir plus de détails. 3804 M Vous avez tenté de rembourser une transaction de paiement qui n a pas été effectuée. 3805 M Le montant du remboursement demandé est supérieur au montant disponible pour remboursement. Veuillez vérifier ce paramètre et réessayer la transaction. 3806 D Vous avez tenté d effectuer un remboursement, mais aucun montant admissible au remboursement n a été trouvé. Ne réessayez pas la transaction. 3807 D Vous avez tenté d effectuer un remboursement, mais une tentative de remboursement simultanée a été détectée. Ne réessayez pas la transaction. 3808 D Vous avez tenté un remboursement, mais la transaction a été refusée par le fournisseur de solutions de paiement. Ne réessayez pas la transaction. 3809 D Le fournisseur de solutions de paiement pour la transaction que vous avez tenté d effectuer ne vous a pas donné l autorisation. Ne réessayez pas la transaction. 3810 D La transaction de paiement est en attente en raison des filtres contre la fraude du fournisseur de solutions de paiement. Ne réessayez pas la transaction. 3811 D La requête a été annulée par le client. 3812 D La somme de cartitem ne correspond pas à totalamount. Ne réessayez pas la transaction. 3850 D La carte prépayée associée au jeton de paiement n est plus valide. Veuillez demander au client d entrer les détails d une autre carte. Guide de référence de l API pour les Services Web 1.0 B-9

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 4000 Refusé en raison des risques. 4001 D Le numéro de carte ou l adresse de courriel correspondant à cette transaction figure dans notre base de données d éléments négatifs. 4002 D La transaction a été refusée par notre service de gestion du risque. 5000 M Échec de l authentification de votre compte de marchand. Soit votre ID de magasin ou votre mot de passe de magasin n est pas valide, soit l utilisation de l adresse IP d où provient la transaction n a pas été autorisée. Veuillez vérifier ces paramètres et réessayer la transaction. Si l erreur persiste, veuillez communiquer avec le soutien technique. 5001 M Le code de devise indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5002 M Le mode de paiement indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5003 C Le montant indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5004 M Le type de compte indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5005 M Le type d opération indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5006 M Le type d ID utilisateur indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5007 M Le type de produit indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5008 M Le transporteur indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5009 M Le mode d expédition indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5010 M L ID de pays indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5011 M La date et l heure de la commande indiquées dans votre requête ne sont pas valides. Veuillez vérifier ce paramètre et réessayer la transaction. 5012 M Le paramètre de pays d expédition indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5013 M Le paramètre d état d expédition indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5014 M Le type de transaction indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5015 M Au moins un des paramètres de votre requête dépasse le nombre de caractères maximum autorisé. Veuillez vérifier vos paramètres et réessayer la transaction. 5016 M Le compte de marchand indiqué n est pas valide ou est introuvable. Veuillez vérifier ce paramètre et réessayer la transaction. Si l erreur persiste, veuillez communiquer avec le soutien technique. 5017 D Le compte de marchand indiqué dans votre requête n est pas activé. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. B-10

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 5018 M Vous avez soumis une requête manquant un paramètre ou contenant un paramètre non valide. 5019 D Aucun processeur n est configuré pour le compte de marchand indiqué dans votre requête. Ne réessayez pas la transaction. Communiquez avec le soutien technique pour obtenir plus de détails. 5020 M Le type de devise indiqué dans votre requête ne correspond pas au type de devise de votre compte de marchand. Veuillez vérifier vos paramètres et envoyer de nouveau la requête. 5021 D Votre requête de transaction a été refusée. Veuillez vérifier les détails de la transaction avant de réessayer. Pour obtenir de plus amples renseignements, veuillez communiquer avec le soutien technique. 5022 M Les critères de recherche sont absents de la requête. Veuillez vérifier vos paramètres et réessayer la transaction. 5023 M Votre requête XML n est pas valide. Veuillez vérifier votre requête et réessayer la transaction. 5024 M La date d expiration de l ID indiquée dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5025 M Les critères de recherche indiqués dans votre requête ne sont actuellement pas pris en charge. Veuillez vérifier vos critères de recherche et réessayer. 5026 M L API des Services Web ne prend actuellement pas en charge les transactions par carte de crédit. Veuillez vérifier vos paramètres et réessayer la transaction. 5027 M Le nom de service du risque indiqué dans votre requête n est pas valide. Veuillez vérifier vos paramètres et réessayer la transaction. 5028 M Vous avez envoyé un fichier séquentiel de nom, de taille et de nombre d entrées identiques au cours des 24 dernières heures. 5029 M Vous avez envoyé un fichier séquentiel mal formaté. 5030 M Vous avez envoyé un fichier séquentiel dont le nombre de lignes est supérieur au maximum autorisé. 5031 M La transaction que vous avez envoyée a déjà été traitée. 5032 C La ville indiquée dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5033 C Le pays indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5034 C L adresse de courriel indiquée dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5035 C Le nom indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5036 C Le numéro de téléphone indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5037 C Le code postal indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5038 C La province ou l état indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. Guide de référence de l API pour les Services Web 1.0 B-11

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 5039 C Le nom de rue indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5040 D Votre compte de marchand n est pas configuré en fonction de la transaction que vous avez tenté d effectuer. Veuillez communiquer avec le soutien technique pour obtenir plus de détails. 5041 M Le paramètre merchantdata indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5042 M Le numéro de référence du marchand est absent, n est pas valide ou dépasse la longueur permise. Veuillez vérifier ce paramètre et réessayer la transaction. 5043 M La date d ouverture de compte indiquée dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5044 M L ID de client indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5045 M L adresse IP du client indiquée dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5046 M Le code SIC du marchand indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5047 M La valeur donnée au paramètre d ancien client dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5048 M Le code de produit indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5049 M La valeur indiquée pour les données utilisateur dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5050 D Une erreur s est produite lors de la configuration de votre compte de marchand. Veuillez communiquer avec le soutien technique. 5051 C Le numéro de confirmation indiqué dans votre requête n est pas valide. Veuillez vérifier le paramètre et réessayer. 5052 C Le code postal indiqué dans votre requête n est pas valide. Veuillez vérifier votre paramètre et réessayer la transaction. 5053 C Les renseignements d ID utilisateur indiqués dans votre requête ne sont pas valides. Veuillez vérifier vos paramètres et réessayer la transaction. 5054 M Vous ne pouvez pas envoyer des éléments de facturation récurrente avec ce type d opération. Veuillez vous assurer que votre requête comprend le type d opération approprié et réessayer la transaction. 5055 M La valeur ECI de votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5056 M Une valeur ECI doit être fournie pour l authentification 3D Secure. Veuillez vérifier ce paramètre et réessayer la transaction. 5057 M La marque de carte de crédit indiquée dans votre requête ne prend pas en charge l authentification 3D Secure. Veuillez vérifier ce paramètre et réessayer la transaction. 5058 M Une valeur CAVV doit être fournie pour l authentification 3D Secure. Veuillez vérifier ce paramètre et réessayer la transaction. 5059 M La valeur indiquée pour le service de demande de devise n est pas valide. B-12

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 5060 M Le paramètre recurringindicator indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5061 M Échec d une vérification de sécurité lors du traitement de cette transaction. Veuillez réessayer la transaction. Si l erreur persiste, communiquez avec le soutien technique. 5062 M Votre requête comporte des caractères non valides. Veuillez vous assurer que tous les paramètres ne contiennent que des caractères dont le codage par URL est possible, puis réessayez la transaction. 5063 M Le KEYWORD indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5064 M Le NETBANX_REFERENCE indiqué dans votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 5065 M Vous avez demandé une changement d état non valide. 5066 M La passerelle de traitement externe pour laquelle votre compte de marchand est configuré ne prend pas en charge les Crédits indépendants. 5067 M La passerelle de traitement externe pour laquelle votre compte de marchand est configuré ne prend pas en charge les Paiements de cartes de crédit. 5068 M Vous avez omis de remplir un champ obligatoire dans votre requête ou la valeur d un champ n est pas saisie dans le bon format. 5071 M Votre requête comporte des critères de recherche non valides. Veuillez vérifier vos paramètres et réessayer la transaction. 5074 M Au moins un des paramètres de votre requête n atteint pas le nombre de caractères minimum requis. Veuillez vérifier vos paramètres et réessayer la transaction. 5075 M Au moins un des paramètres de votre requête contient un espace au début ou à la fin. Veuillez vérifier vos paramètres et réessayer la transaction. 5269 Les ID(s) indiqués dans l URL ne correspondent pas aux valeurs dans le système. 5270 La clé d API fournie avec la requête n est pas autorisée à accéder aux données demandées. 5271 Vous avez demandé une réponse dans un format qui n'est pas pris en charge. 5272 Vous avez soumis votre requête dans un format qui n est pas pris en charge. 5273 L URL est non valide ou le serveur n est pas déployé correctement. 5274 La clé d API indiquée pour cette requête ne peut pas être utilisée car elle est expirée ou désactivée/verrouillée. 5275 La clé d API indiquée pour cette requête ne peut pas être utilisée car elle est expirée ou désactivée/verrouillée. 5276 La clé d API indiquée pour cette requête ne peut pas être utilisée car elle est expirée ou désactivée/verrouillée. 5277 La clé d API indiquée pour cette requête ne peut pas être utilisée car elle est expirée ou désactivée/verrouillée. 5278 La clé d API a été refusée pour une raison inconnue. 5279 L ID ou le mot de passe de la clé d API est non valide. 6001 Le service d identification est désactivé. 6002 L URL et le type de question ne correspondent pas. Guide de référence de l API pour les Services Web 1.0 B-13

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 6004 La question de suivi définie a déjà été soumise. 6005 Un problème est survenu lors de la configuration du compte. 6006 Une erreur de communication s est produite. 6007 Une erreur s est produite dans la passerelle de traitement externe. 6008 La réponse de la passerelle externe comporte une erreur. 6009 L utilisateur a pris trop de temps à soumettre la réponse. La transaction a été interrompue. 7000 D L adresse que vous tentez de créer existe déjà. 7001 M Création de l adresse impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7002 M Mise à jour de l adresse impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7003 M L adresse indiquée est introuvable. 7004 M Chargement de l adresse impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7005 M Le type d adresse indiqué n est pas valide. 7006 M Les adresses du client sont introuvables. 7007 M Chargement des adresses impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7010 D Le client que vous tentez de créer existe déjà. 7011 M Création du client impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7012 M Mise à jour du client impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7013 M Le client indiqué est introuvable. 7014 M Chargement du client impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7015 M Le type de création de client indiqué dans votre requête n est pas valide. 7016 M Le titre de client indiqué dans votre requête n est pas valide. 7020 D Le mode de communication que vous tentez de créer existe déjà. 7021 M Création du mode de communication impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7022 M Mise à jour du mode de communication impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7023 M Le mode de communication indiqué est introuvable. 7024 M Chargement du mode de communication impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7025 M Le type de mode de communication indiqué n est pas valide. 7026 M Les modes de communication du client sont introuvables. B-14

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 7027 M Chargement des modes de communication impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7040 D Le mode de paiement que vous tentez de créer existe déjà. 7041 M Création du mode de paiement impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7042 M Mise à jour du mode de paiement impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7043 M Le mode de paiement indiqué est introuvable. 7044 M Chargement du mode de paiement impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7045 M Le type de mode de paiement indiqué n est pas valide. 7046 M Les modes de paiement du client sont introuvables. 7047 M Chargement des modes de paiement impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7050 D Le calendrier de facturation que vous tentez de créer existe déjà. 7051 M Création du calendrier de facturation impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7052 M Mise à jour du calendrier de facturation impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7053 M Le calendrier de facturation indiqué est introuvable. 7054 M Chargement du calendrier de facturation impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7055 M Le type d intervalle de paiement indiqué n est pas valide. 7056 M Les calendriers de facturation du client sont introuvables. 7057 M Chargement des calendriers de facturation impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7058 M Le montant facturé doit être supérieur à zéro. 7059 M Mise à jour de l état du calendrier de facturation impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7070 M Exécution de l opération de recherche impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7080 M Mise à jour des enregistrements impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7090 D L état de client que vous tentez de créer existe déjà. 7091 M Création de l état de client impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7092 M Mise à jour de l état de client impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7093 M L état de client indiqué est introuvable. Guide de référence de l API pour les Services Web 1.0 B-15

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 7094 M Chargement de l état de client impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7095 M L entité juridique du marchand est introuvable. 7096 M La récupération de l entité juridique du marchand est impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7097 D Une erreur interne s est produite. Le détail de la réponse n a pu être généré. 7098 M Le numéro de carte de crédit fourni n est pas valide. 7100 M Le ddstatus que vous tentez de créer pour le paymentmethod existe déjà. 7101 M Création de ddstatus pour le paymentmethod impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7102 M Mise à jour de ddstatus pour le paymentmethod impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7103 M Incapable de trouver le ddstatus spécifié pour le paymentmethod. 7104 M Chargement de ddstatus pour le paymentmethod impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7107 M Le profil client a été créé mais nous n avons pas pu charger le modèle de courriel. 7108 M Le ccstatus que vous tentez de créer pour le paymentmethod existe déjà. 7109 M Création de ccstatus pour le paymentmethod impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7110 M Mise à jour de ccstatus pour le paymentmethod impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7111 M Chargement de ccstatus pour le paymentmethod impossible. Essayez de nouveau ou communiquez avec le soutien technique. 7500 Le profileid indiqué dans votre requête est introuvable. 7501 Vous n avez pas spécifié d entité juridique mère du marchand dans votre requête. 7502 Nous n avons pas pu identifier l entité juridique mère du marchand indiquée dans votre requête. 7503 Le numéro de carte que vous tentez d ajouter au profil est déjà utilisé par ce profil. 7504 Le numéro de carte que vous tentez d ajouter au profil est déjà utilisé par un autre profil. 7505 Le merchantcustomerid indiqué pour ce profil a déjà été utilisé pour un autre profil. 7511 L ID d adresse indiqué dans votre requête est introuvable. 8000 M Exécution de l opération impossible. Essayez de nouveau ou communiquez avec le soutien technique. 8001 M Votre requête n est pas valide. Veuillez vérifier vos paramètres et réessayer. 8002 M L élément consumerinfo est absent de votre requête. 8003 M La valeur de l élément firstname est absente de votre requête. 8004 M La valeur de l élément lastname est absente de votre requête. 8005 M L élément billingaddress/shippingaddress est absent de votre requête. B-16

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 8006 M Les renseignements billingaddress/shippingaddress sont absents de votre requête. La valeur de l élément street est absente. 8007 M Les renseignements billingaddress/shippingaddress sont absents de votre requête. La valeur de l élément city est absente. 8008 M Les renseignements billingaddress/shippingaddress sont absents de votre requête. La valeur de l élément zip est absente. 8009 M Les renseignements billingaddress/shippingaddress sont absents de votre requête. La valeur de l élément country est absente. 8010 M Les renseignements billingaddress/shippingaddress sont absents de votre requête. La valeur de l élément state ou region est absente. 8011 M L élément contactmethod est absent de votre requête. 8012 M L élément type doit comprendre un numéro de téléphone résidentiel, un numéro de cellulaire ou une adresse de courriel. 8013 M L élément paymentmethod est absent de votre requête. 8014 M La valeur de l élément enfant id de l élément billingaddress est absente de votre requête. 8015 M La valeur de l élément enfant card ou check de l élément paymentmethod est absente de votre requête. 8016 M L élément card est absent de votre requête. 8017 M La valeur de l élément cardnum est absente de votre requête. 8018 M La valeur de l élément cardtype est absente de votre requête. 8019 M L élément cardexpiry est absent de votre requête. 8020 M La valeur de l élément month est absente de votre requête. 8021 M La valeur de l élément year est absente de votre requête. 8022 M L élément check est absent de votre requête. 8023 M La valeur de l élément accountnum est absente de votre requête. 8024 M La valeur de l élément accounttype est absente de votre requête. 8025 M La valeur de l élément routingnum est absente de votre requête. 8026 M La valeur de l élément bankname est absente de votre requête. 8027 M La valeur de l élément checknum est absente de votre requête. 8028 M L élément billingschedule est absent de votre requête. 8029 M La valeur de l élément intervalcode est absente de votre requête. 8030 M La valeur de l élément nextbillingdate est absente de votre requête. 8031 M La valeur de l élément startdate est absente de votre requête. 8032 M La valeur de l élément amount est absente de votre requête. 8033 M L élément merchantaccount est absent de votre requête. 8034 M La valeur de l élément accountnum est absente de votre requête. 8035 M La valeur de l élément storeid est absente de votre requête. Guide de référence de l API pour les Services Web 1.0 B-17

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 8036 M La valeur de l élément storepwd est absente de votre requête. 8037 M Validation des justificatifs d identité fournis avec le merchantaccount impossible. 8038 M Une erreur interne s est produite. Veuillez envoyer de nouveau la requête. 8039 M La valeur de l élément consumerid est absente de votre requête. 8040 M La valeur de l élément title est absente de votre requête. 8041 M La valeur de l élément enfant merchantrefnum de l élément consumerinfo est absente de votre requête. 8042 M La valeur de l élément street2 est absente de votre requête. 8043 M L élément d ID address de votre requête n est pas valide. Il ne correspond pas à l élément consumerid de votre requête. 8044 M L élément d ID contactmethod de votre requête n est pas valide. Il ne correspond pas à l élément consumerid de votre requête. 8045 M La valeur de l élément paymentmethodid est absente de votre requête. 8046 M La valeur de l élément ccholdername est absente de votre requête. 8047 M La valeur de l élément enfant merchantrefnum de l élément paymentmethod est absente de votre requête. 8048 M La valeur de l élément enfant id de l élément billingschedule est absente de votre requête. 8049 M La valeur de l élément servicename est absente de votre requête. 8050 M La valeur de l élément statuscode est absente de votre requête. 8051 M La valeur de l élément lastdayofthemonth est absente de votre requête. 8052 M La valeur de l élément enfant merchantrefnum de l élément billingschedule est absente de votre requête. 8053 M La requête contient deux éléments consumerid qui ne correspondent pas. 8054 M Vous avez tenté d effectuer une opération non prise en charge. 8055 M L élément enddate de votre requête n est pas valide. 8056 M L élément issuenumber de votre requête n est pas valide. 8057 M L élément statuscode de votre requête n est pas valide. 8058 M L élément intervalcode de votre requête n est pas valide. 8059 M L élément title de votre requête n est pas valide. 8060 M L élément cardtype de votre requête n est pas valide. 8061 M L élément accounttype de votre requête n est pas valide. 8062 M L élément state de votre requête n est pas valide. 8063 M L élément country de votre requête n est pas valide. 8064 M L élément startdate de votre requête n est pas valide. 8065 M L élément enddate de votre requête n est pas valide. 8066 M L élément nextbillingdate de votre requête n est pas valide. 8067 M La date de fin (enddate) ne peut pas être antérieure à la date de début (startdate). B-18

juillet 2014 Codes de réponse Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 8068 M La date de prochaine facturation (nextbillingdate) ne peut pas être postérieure à la date de fin (enddate). 8069 M La date de prochaine facturation (nextbillingdate) ne peut pas être antérieure à la date de début (startdate). 8070 M L élément cardexpiry de votre requête n est pas valide. 8071 M L élément billingaddressid de paymentmethod n est pas valide. Il ne correspond pas au consumerid indiqué dans la requête ou son type d adresse est incorrect. 8072 M L élément shippingaddressid de paymentmethod n est pas valide. Il ne correspond pas au consumerid indiqué dans la requête ou son type d adresse est incorrect. 8073 M L élément type de contactmethod n est pas valide. 8074 M L élément id de paymentmethod n est pas valide. Il ne correspond pas à l élément consumerid de votre requête. 8075 M L élément id de billingschedule n est pas valide. Il ne correspond pas à l élément consumerid de votre requête. 8076 M L élément consumerid de votre requête n est pas valide. Le client indiqué n est pas inscrit auprès de ce marchand. 8077 M L élément paymentmethodid de billingschedule n est pas valide. Le mode de paiement indiqué ne fait pas partie de ceux du client. 8078 D Vous avez envoyé un double de cette requête au cours des 24 dernières heures. 8079 D Vous avez envoyé un fichier qui a déjà été traité au cours des 24 dernières heures. 8080 M Le type d enregistrement de votre requête n est pas valide. L élément recurringbillingdetails est absent. 8081 D Vous avez envoyé un fichier vide. 8082 M Votre requête n est pas valide. 8083 M La valeur de l élément cvv est absente de votre requête. 8084 M L élément cvv de votre requête n est pas valide. 8085 M La valeur de l élément ID de transaction du marchand est absente de votre requête. 8086 M La valeur de l élément ID de transaction est absente de votre requête. 8087 M L élément accountnum de votre requête n est pas valide. 8088 M Le nombre de champs de l enregistrement envoyé dans votre requête n est pas valide. 8089 D La taille du fichier envoyé est supérieure à la limite permise. 8090 M L élément Date de la transaction n est pas valide. 8091 M L élément Expiration de l ID n est pas valide. 8092 M Le type de transaction indiqué pour l élément Code de transaction n est pas pris en charge. 8093 M L élément billingschedule n est pas valide. Votre requête doit comporter l élément paymentmethodid ou un nouvel élément paymentmethod. 8094 M L élément paymentmethod n est pas valide. Votre requête doit comporter l élément billingaddressid ou un nouvel élément billingaddress. 8095 M La taille du fichier envoyé est supérieure à la limite permise de 1000 enregistrements. Guide de référence de l API pour les Services Web 1.0 B-19

Codes de réponse juillet 2014 Tableau B-1 : Codes de réponse (suite) Code de réponse Action Description 8096 M L élément transactionmode n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 8100 M La valeur de l élément aggregateaccountnum est absente de votre requête. 8101 M L élément aggregateaccountnum n est pas valide. 8102 M L élément Version n est pas valide. 8103 M L élément storeid n est pas valide. 8104 M L élément storepwd n est pas valide. 8105 M L élément accountnum n est pas associé à l élément aggregateaccountnum. 8106 M L élément aggregateaccountnum n est pas valide. Aucuns comptes groupés n ont été trouvés. 8107 M La valeur de l élément intervalvalue est absente de votre requête. 8108 M L élément intervalvalue n est pas valide. 8109 M L élément intervalvalue ne peut être fourni avec l élément intervalcode défini. 8110 M La valeur de l élément intervalvalue doit se situer entre 1 et 365. 8112 M L élément merchantaccount n est pas valide. Le numéro de compte de marchand fourni correspond à un compte qui n est pas configuré en fonction de la facturation récurrente. 8119 M La valeur de l élément username est absente de votre requête. 8120 M La valeur de l élément password est absente de votre requête. 8121 M La valeur de l élément customerip est absente de votre requête. 8122 M La valeur de l élément siteurl est absente de votre requête. 8123 M La valeur de l élément keyword est absente de votre requête. 8124 M La valeur de l élément welcomeemail est absente de votre requête. 8125 M Une erreur interne s est produite. Le courriel de bienvenue n a pu être généré. 8126 R Le pays de l institution financière indiqué dans votre requête n est pas valide. Veuillez vérifier votre paramètre et réessayer la transaction. 8127 M La valeur de l élément enfant ddmandatereference de l élément billingschedule est absente de votre requête. 8128 M Vous avez indiqué une référence du mandat non valide. Veuillez vérifier votre paramètre et réessayer la transaction. 8129 M L élément financingtype de votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 8130 M L élément plan de votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 8131 M L élément graceperiod de votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 8132 M L élément term de votre requête n est pas valide. Veuillez vérifier ce paramètre et réessayer la transaction. 9000 D Votre requête de transaction n a pu être traitée parce que votre compte de marchand ne comporte aucun compte enfant disponible pour le partage de charge. B-20

juillet 2014 Codes d action Code de réponse Action Tableau B-1 : Codes de réponse (suite) Description 9001 D Votre requête de transaction n a pu être traitée parce que votre compte de marchand ne comporte aucun compte enfant disponible pour l acheminement par niveau. 9002 D Votre requête de transaction n a pu être traitée parce que votre compte de marchand ne comporte aucun compte enfant disponible pour l acheminement permanent. 9003 D Votre requête de transaction n a pu être traitée parce que votre compte de marchand ne comporte aucun compte enfant disponible pour l acheminement par le pays du NIB. 9004 D Votre requête de transaction n a pu être traitée parce que votre compte de marchand ne comporte aucun compte enfant disponible pour l acheminement par marque. 9005 D Votre requête de transaction n a pu être traitée parce que votre compte de marchand ne comporte aucun compte enfant disponible pour l acheminement par mot clé. Codes d action Le processeur de transaction donne une action avec chaque code de réponse. Voici le sens des codes d'action : C = Erreur de paramètre du client. Les renseignements fournis par le client sont incorrects. Confirmez les renseignements auprès du client. D = Ne pas réessayer. M = Erreur de paramètre du marchand. Les renseignements fournis par votre application sont incorrects. Vérifiez vos renseignements. R = Réessayer. Codes de refus Ces codes utilisés par le système de chambre de compensation automatisée (CCA) ou de transfert électronique de fonds (TEF) correspondent aux différentes raisons pour lesquelles un chèque ou un paiement est refusé. Les codes sont générés par les institutions financières des clients (Receiving Depository Financial Institutions, ou RDFI) pour les effets refusés. Tableau B-2 : Codes de refus Code Description IDD01 IDD02 IDD03 IDD04 IDD05 IDD06 IDD10 IDD99 R01 R02 R03 Litige par client Compte bancaire n existe pas Pas de règlement Compte bancaire et bénéficiare ne correspondent pas Compte bloqué pour prélèvement automatique (débit direct) Provision insuffisante Inconnue Inversion Provision insuffisante Compte fermé Compte inexistant ou introuvable Guide de référence de l API pour les Services Web 1.0 B-21

Codes de réponse juillet 2014 Tableau B-2 : Codes de refus (suite) Code Description R04 Numéro de compte non valide R06 Refus demandé par l ODFI R07 Autorisation révoquée par le client* R08 Opposition au paiement R09 Fonds non perçus R10 Avis de transaction non autorisée par le client* R11 Retour d entrée de non-circulation de chèques R12 Succursale vendue à une autre RDFI R13 RDFI non habilitée à participer R14 Représentant bénéficiaire décédé ou incapable de poursuivre à ce titre R15 Bénéficiaire ou titulaire du compte décédé R16 Compte gelé R17 Critère de modification de l enregistrement de fichier R18 Date d entrée en vigueur incorrecte R19 Erreur dans le champ du montant R20 Transactions non autorisées en vertu du compte R21 Identification de la société non valide R22 Numéro d identification personnel non valide R23 Entrée de crédit refusée par le destinataire. R24 Entrée en double. R25 Format d annexe erroné. R26 Erreur de champ obligatoire. R27 Erreur de numéro repère. R28 Erreur de chiffre de contrôle du numéro d acheminement. R29 Avis de transaction non autorisée par l entreprise cliente. R30 RDFI non participante au programme de non-circulation de chèques. R31 Entrée de retour permis. R32 Non-règlement de la RDFI. R33 Retour de l entrée XCX. R34 DFI à participation limitée. R35 Retour d entrée de débit incorrecte. R36 Retour d entrée de crédit incorrecte. R51 Effet inadmissible, avis non fourni, signature non authentique ou effet modifié. R52 Opposition au paiement sur l effet. 900 Rejet de la validation. 901 Provision insuffisante (retraits directs «RA» seulement). B-22

juillet 2014 Codes de refus Tableau B-2 : Codes de refus (suite) Code Description 902 Compte introuvable. 903 Opposition au paiement/paiement rappelé/paiement révoqué. 904 Postdaté ou périmé. 905 Compte fermé. 906 Compte transféré. 907 Aucun privilège de chèques. 908 Fonds bloqués. 910 Payeur/Bénéficiaire décédé. 911 Compte bloqué. 912 Numéro de compte erroné ou non valide. 914 Nom de payeur ou de bénéficiaire erroné. 915 Refusé par le payeur ou le bénéficiaire. 916 Limite de virement atteinte. 917 Virement non accepté. 990 Inexécution d une institution financière. 998 Aucune entente de retour. * Un effet compensé peut être retourné comme «Non autorisé», «Autorisé» ou «Autorisation révoquée» jusqu'à 60 jours suivant la date de présentation. Guide de référence de l API pour les Services Web 1.0 B-23

Codes de réponse juillet 2014 B-24

ANNEXE C Codes géographiques Codes de province Tableau C-1 : Codes de province Province Alberta Colombie-Britannique Île-du-Prince-Édouard Manitoba Nouveau-Brunswick Nouvelle-Écosse Nunavut Ontario Québec Saskatchewan Terre-Neuve-et-Labrador Territoires du Nord-Ouest Yukon Code AB BC PE MB NB NS NU ON QC SK NL NT YT Guide de référence de l API pour les Services Web 1.0 C-1

Codes géographiques juillet 2014 Codes d état Tableau C-2 : Codes d état État Code État Code Alabama AL Alaska AK Arizona AZ Arkansas AR Californie CA Colorado CO Caroline du Sud SC Dakota du Sud SD Connecticut CT Delaware DE Dakota du Nord ND Ohio OH District fédéral de Columbia DC Floride FL Forces armées Europe AE Forces armées Pacifique AP Géorgie GA Hawaii HI Guam GU Samoa américaine AS Idaho ID Illinois IL Îles Vierges américaines VI Mariannes du Nord MP Indiana IN Iowa IA International IT Puerto Rico PR Kansas KS Kentucky KY Louisiane LA Maine ME Maryland MD Massachusetts MA Michigan MI Minnesota MN Mississippi MS Missouri MO Montana MT Nebraska NE Nevada NV New Hampshire NH New Jersey NJ Nouveau-Mexique NM New York NY Caroline du Nord NC Oklahoma OK Oregon OR Palau PW Forces armées Amériques AA Pennsylvanie PA Rhode Island RI Tennessee TN Texas TX Utah UT Vermont VT Virginie VA Washington WA Virginie-Occidentale WV Wisconsin WI Wyoming WY États-Unis US C-2

juillet 2014 Codes de pays Codes de pays Tableau C-3 : Codes de pays Pays Code Pays Code Afghanistan AF Brunei Darussalam BN Afrique du Sud ZA Bulgarie BG Albanie AL Burkina Faso BF Algérie DZ Burundi BI Allemagne DE Cambodge KH Andorre AD Cameroun CM Angola AO Canada CA Anguilla AI Cap-Vert CV Antarctique AQ Chili CL Antigua-et-Barbuda AG Chine CN Arabie saoudite SA Chypre CY Argentine AR Colombie CO Arménie AM Comores KM Aruba AW Congo CG Australie AU Congo, République démocratique du CD Autriche AT Corée, République de KR Azerbaïdjan AZ Corée, République populaire démocratique de KP Bahamas BS Costa Rica CR Bahreïn BH Côte d Ivoire CI Bangladesh BD Croatie HR Barbade BB Cuba CU Bélarus BY Curaçao CW Belgique BE Danemark DK Belize BZ Djibouti DJ Bénin BJ Dominique DM Bermudes BM Égypte EG Bhoutan BT El Salvador SV Bolivie BO Émirats arabes unis AE Bonaire, Sint Eustatius et Saba BQ Équateur EC Bosnie-Herzégovine BA Érythrée ER Botswana BW Espagne ES Brésil BR Estonie EE État de la Cité du Vatican (Saint-Siège) VA Îles Caïmans KY États-Unis US Îles Cocos (Keeling) CC Guide de référence de l API pour les Services Web 1.0 C-3

Codes géographiques juillet 2014 Tableau C-3 : Codes de pays (suite) Pays Code Pays Code Éthiopie ET Îles Cook CK Fédération de Russie RU Îles d'åland AX Fidji FJ Îles Féroé FO Finlande FI Îles Heard et McDonald HM France FR Îles Malouines FK Gabon GA Îles Marshall MH Gambie GM Îles Salomon SB Géorgie GE Îles Turks et Caicos TC Géorgie du Sud et les îles Sandwich du Sud GS Îles Vierges américaines VI Ghana GH Îles Vierges britanniques VG Gibraltar GI Îles Wallis-et-Futuna WF Grèce GR Inde IN Grenade GD Indonésie ID Groenland GL Iran (République islamique d') IR Guadeloupe GP Iraq IQ Guam GU Irlande IE Guatemala GT Islande IS Guernesey GG Israël IL Guinée GN Italie IT Guinée équatoriale GQ Jamahiriya arabe libyenne LY Guinée-Bissau GW Jamaïque JM Guyana GY Japon JP Guyane française GF Jersey JE Haïti HT Jordanie JO Honduras HN Kazakhstan KZ Hong Kong HK Kenya KE Hongrie HU Kirghizistan KG Île Bouvet BV Kiribati KI Île Christmas CX Koweït KW Île de Man IM Lesotho LS Île Norfolk NF Lettonie LV Lettonie LV Nigeria NG Liban LB Niue NU Libéria LR Norvège NO Liechtenstein LI Nouvelle-Calédonie NC C-4

juillet 2014 Codes de pays Tableau C-3 : Codes de pays (suite) Pays Code Pays Code Lituanie LT Nouvelle-Zélande NZ Luxembourg LU Oman OM Macao MO Ouganda UG Macédoine MK Ouzbékistan UZ Madagascar MG Pakistan PK Malaisie MY Palau PW Malawi MW Panama PA Maldives MV Papouasie-Nouvelle-Guinée PG Mali ML Paraguay PY Malte MT Pays-Bas NL Mariannes du Nord MP Pérou PE Maroc MA Petites îles excentriques des États-Unis UM Martinique MQ Philippines PH Maurice MU Pitcairn PN Mauritanie MR Pologne PL Mayotte YT Polynésie française PF Mexique MX Portugal PT Micronésie, États fédérés de FM Puerto Rico PR Moldova, République de MD Qatar QA Monaco MC République arabe syrienne SY Mongolie MN République centrafricaine CF Monténégro ME République démocratique populaire du Laos LA Montserrat MS République dominicaine DO Mozambique MZ République tchèque CZ Myanmar MM République-Unie de Tanzanie TZ Namibie NA Réunion RE Nauru NR Roumanie RO Népal NP Royaume-Uni GB Nicaragua NI Rwanda RW Niger NE Sahara-Occidental EH Saint Martin MF Thaïlande TH Saint-Barthélemy BL Timor-Leste TL Saint-Kitts-et-Nevis KN Togo TG Saint-Marin SM Tokelau TK Saint-Pierre et Miquelon PM Tonga TO Saint-Vincent-et-les-Grenadines VC Trinité-et-Tobago TT Guide de référence de l API pour les Services Web 1.0 C-5

Codes géographiques juillet 2014 Tableau C-3 : Codes de pays (suite) Pays Code Pays Code Sainte-Hélène SH Tunisie TN Sainte-Lucie LC Turkménistan TM Samoa WS Turquie TR Samoa américaine AS Tuvalu TV Sao Tomé-et-Principe ST Ukraine UA Sénégal SN Uruguay UY Serbie RS Vanuatu VU Seychelles SC Venezuela VE Sierra Leone SL Vietnam VN Singapour SG Yémen YE Sint Maarten SX Zambie ZM Slovaquie (République slovaque) SK Zimbabwe ZW Slovénie SI Somalie SO Soudan SD Soudan du Sud SS Sri Lanka LK Suède SE Suisse CH Suriname SR Svalbard et île de Jan Mayen SJ Swaziland SZ Tadjikistan TJ Taïwan TW Tchad TD Terres australes françaises TF Territoire britannique de l'océan Indien IO Territoires palestiniens PS C-6