Guide_d`implémentation_WebServices_plages de BINs
Transcription
Guide_d`implémentation_WebServices_plages de BINs
Définition des Webservices d’interrogation du fichier de plages de BINs Version 1.0 Rédaction, Vérification, Approbation Rédaction Nom Vérification Date/Visa Nom Date/Visa Approbation Nom Date/Visa Historique du document Version 1.0 Auteur Lyra-Network Date 30/11/2010 Commentaires Version initiale. Confidentialité Toutes les informations contenues dans ce document sont considérées comme confidentielles. L’utilisation de celles-ci en dehors du cadre de cette consultation ou la divulgation à des personnes extérieures est soumise à l’approbation préalable de Lyra Network. SOMMAIRE 1. Présentation ..........................................................................4 2. Description des types ..........................................................5 2.1. PlagesInfo........................................................................................................ 5 3. Description des méthodes ..................................................6 3.1. getInfo ............................................................................................................. 6 4. Signature ...............................................................................7 1. Présentation Ce document présente les webservices qui permettent d’interroger le fichier de plages de BINs. Ces webservices ont été développés suivant le protocole SOAP (Simple Object Access Protocol) et sont décrits par le fichier wsdl suivant : https://paiement.systempay.fr/vads-ws/plages-v1?wsdl Afin de sécuriser les échanges, les webservices (SOAP) sont cryptés grâce au protocole HTTPS. De plus un mécanisme de signature a été mis en place afin de valider et d’authentifier l’échange des données. Systempay – Description des Webservices d’interrogation fichier plage @Lyra Network- 4/7 2. Description des types 2.1. PlagesInfo Ce type permet de décrire les informations d’une plage de BINs. Nom du champ timestamp errorCode extendedErrorCode longNumPorteur codeBanque codeReseau niveauAcceptation cas clefLuhn codePays debutEffet finEffet codeEtat ecb codeProduit cbAppelationCarte visaReportingBinEmetteur visaRegion visaNiveauProduit masterCodeICA masterPays signature Type Description Informations Générales WS Int Timestamp permettant la génération de signature unique Int Date de transaction String Identifiant de transaction Informations Générales CB Int Longueur des numéros de porteur String Code banque d’affectation Int Code réseau • 1 = National (CB) • 2 = VISA • 3 = MCI (MASTERCARD) • 4 = ECI (EUROCARD) • 9 = Indéterminé (National ou VISA) Int Niveau d'acceptation de la plage • 0 = Normal • 1 = Surveillé • 2 = Refusé • 3 = Interdit • 4 = Privatif • 8 = Test Bool Carte à Autorisation Systématique Bool Indicateur de contrôle clé de Luhn String Pays d'affectation de la plage porteur (code ISO 3166 alphabétique sur 3 caractères) String Jour de début d'effet de la plage (format AAAAMMJJ) String Jour de fin d'effet de la plage (format AAAAMMJJ) String Code d'état de la plage • R = Réservée • A = Affectée • C = Cessée boolean E Carte-Bleue String code produit Informations Spécifiques CB String Informations Spécifiques VISA String code Reporting BIN émetteur VISA String Code Région VISA String Niveau Produit Informations Spécifiques MASTERCARD String Code ICA String Indicateur Pays / sous région Europe Signature String Cf ci-dessous Systempay – Description des webservices d’interrogation du fichier "plages de BINs" @Lyra Network- 5/ 7 La signature permet de valider l’intégrité de la réponse, le calcul de cette signature se fait en prenant les paramètres dans l’ordre suivant : timestamp, errorCode, extendedErrorCode, longNumPorteur, codeBanque, codeReseau, niveauAcceptation, cas, cleLuhn, codePays, debutEffet, finEffet, codeEtat, ecb, codeProduit, cbAppelationCarte, visaReportingBinEmetteur, visaRegion, visaNiveauProduit, masterCodeICA, masterPays 3. Description des méthodes 3.1. getInfo Cette fonction permet d’interroger une plage pour un numéro de carte donnée. Cette fonction prend en entrée les paramètres suivants : Nom du champ shopId cardNumber ctxMode Type String String String wsSignature String Description Identifiant de la boutique Numéro de la carte Contexte de sollicitation de la plateforme de paiement ("TEST", "PRODUCTION") Signature (cf ci-dessous) Le calcul de la signature se fait en prenant les paramètres dans l’ordre suivant : shopId, cardNumber, ctxMode Cette fonction retourne une réponse du type PlagesInfo (cf 2.1Erreur ! Source du renvoi introuvable.). Les codes erreurs (errorCode) possibles sont : errorCode 0 1 5 40 50 53 99 Description Action réalisée avec succès Action non autorisée Mauvaise signature Plage non trouvée Paramètre ‘shopId’ invalide Paramètre ‘ctxMode’ invalide Autre erreur Systempay – Description des webservices d’interrogation du fichier "plages de BINs" @Lyra Network- 6/ 7 Obligatoire 4. Signature Cf Guide_technique_d'implémentation standardWebService.doc Systempay – Description des webservices d’interrogation du fichier "plages de BINs" @Lyra Network- 7/ 7