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