Ressources
L’accès aux cartes bancaires peut se faire via :
api/cards/ pour accéder aux cartes enregistrées sur le domaine, en marque grise
api/users/appuserid/cards , en marque blanche pour accéder aux cartes d’un utilisateur appartenant à l’application tierce connectée .
1.1 Cardregistration
Contient les informations d’une carte bancaire
| Propriété | Type | Exemple | Description |
|---|---|---|---|
| Card | Card | Détails de la carte | |
| Status | Int | 1 | Statut de l’enregistrement carte 0 = En attente 1 = Réalisé 2 = Echoué |
| UrlReturn | String | Url de retour client appelé en fin d’enregistrement carte | |
| urlCallback | String | https://domainedeclare/ajoutcarte | Spécifie l’url de callback serveur appelée en fin d’ajout d’une carte (le domaine doit être le même que celui de l’URL de callback déclaré en base) |
| AvailableCards | String | "CB ; VISA" | Liste des cartes à afficher sur lapage d’enregistrement. Valeurs possibles ( à séparer des ’ ;’ ) : CB MASTERCARD MAESTRO VISA VISA_ELECTRON |
| ErrorCode | Int | 0 | Code d’erreur pour les enregistrements carte échoués, 0 si aucune erreur. 1 = Le commerçant doit contacter la banque du porteur 2 = Paiement refusé 3 = Paiement annulé par le client 4 = Porteur non enrôlé 3D-Secure 5 = Erreur authentification 3D-Secure 6 = Erreur technique Systempay |
| ExtraResults | ExtraResults | Contient les codes de retour détaillés |
1.2 Card
| Propriété | Type | Exemple | Description |
|---|---|---|---|
| Id | Long | 1 | Id de la carte |
| AppCardId | String | "card123" | Identifiant de la carte chez l’application tierce |
| Name | String | "Carte bancaire" | Nom de la carte |
| Hint | String | "597010XXXXXX0009" | Masque du numéro de la carte |
| Country | String | "FR" | Code ISO du pays de la carte |
| Extraparameters | Extraparameters | Liste des paramètres permettant d’appliquer un profil prédéfini à la transaction |
1.3 ExtraResults
| Propriété | Type | Description |
|---|---|---|
| BankAuthResult | Int | Code retour de la demande d’autorisation retournée par la banque émettrice, si disponible. 0 = transaction approuvée ou traitée avec succès 2 = contacter l’émetteur de carte 3 = accepteur invalide 4 = conserver la carte 5 = ne pas honorer 7 = conserver la carte, conditions spéciales 8 = approuver après identification 12 = transaction invalide 13 = montant invalide 14 = numéro de porteur invalide 15 = Émetteur de carte inconnu 17 = Annulation client 19 = Répéter la transaction ultérieurement 20 = Réponse erronée (erreur dans le domaine serveur) 24 = Mise à jour de fichier non supportée 25 = Impossible de localiser l’enregistrement dans le fichier 26 = Enregistrement dupliqué, ancien enregistrement remplacé 27 = Erreur en « edit » sur champ de lise à jour fichier 28 = Accès interdit au fichier 29 = Mise à jour impossible 30 = erreur de format 31 = identifiant de l’organisme acquéreur inconnu 33 = date de validité de la carte dépassée 34 = suspicion de fraude 38 = Date de validité de la carte dépassée 41 = carte perdue 43 = carte volée 51 = provision insuffisante ou crédit dépassé 54 = date de validité de la carte dépassée 55 = Code confidentiel erroné 56 = carte absente du fichier 57 = transaction non permise à ce porteur 58 = transaction interdite au terminal 59 = suspicion de fraude 60 = l’accepteur de carte doit contacter l’acqué reur 61 = montant de retrait hors limite 63 = règles de sécurité non respectées 68 = réponse non parvenue ou reçue trop tard 75 = Nombre d’essais code confidentiel dépassé 76 = Porteur déjà en opposition, ancien enregistrement conservé 90 = arrêt momentané du système 91 = émetteur de cartes inaccessible 94 = transaction dupliquée 96 = mauvais fonctionnement du système 97 = échéance de la temporisation de surveillance globale 98 = serveur indisponible routage réseau demandé à nouveau 99 = incident domaine initiateur |
| RiskControlResult | Int | Code numérique du résultat des contrôles risques Null = Pas de contrôle effectué 0 = Tous les contrôles se sont déroulés avec succès 2 = La carte a dépassé l’encours autorisé 3 = La carte appartient à la liste grise du commerçant 4 = Le pays d’émission de la carte appartient à la liste grise du commerçant ou le pays d’émission de la carte n’appartient pas à la liste blanche du commerçant. 5 = L’adresse IP appartient à la liste grise du commerçant 6 = Le code bin appartient à la liste grise du commerçant 7 = Détection d’une e-carte bleue 8 = Détection d’une carte commerciale nationale 9 = Détection d’une carte commerciale étrangère 14 = Détection d’une carte à autorisation systématique 20 = Contrôle de cohérence : aucun pays ne correspond (pays IP, pays carte, pays client) 30 = Le pays de l’adresse IP appartient à la liste grise 99 = Problème technique rencontré par le serveur lors du traitement d’un des contrôles locaux |
| ThreedsResult | Int | Statut final du processus 3D-Secure 0 = statut initial 1 = Statut non applicable (global, raison non détaillée) 2 = Statut non applicable (integrator disabled) 3 = Paiement non e-commerce 4 = Paiement sans 3DS (paiement par identifiant, paypal, cetelem, etc.) 5 = Marchand non enrôlé, pas de 3DS 6 = Erreur technique lors du processus 3DS, pas de 3DS 7 = Porteur non enrôlé, pas de 3DS 8 = Signature invalide 9 = Problème venant de l’ACS 10 = Le processus 3DS s’est déroulé correctement 11 = Le processus 3DS a été fait par l’intégrateur 12 = Problème venant du DS 13 = Timeout lors d’une connexion au DS 14 = Maintien pour la livraison de ce statut 15 = Statut non applicable (3DS présent mais désactivé) 16 = Canal de paiement pour lequel 3DS n’est pas disponible (paiements par fichier...) 98 = L’initialisation du processus 3DS est OK 99 = Statut inconnu |
| WarrantyResult | bool | Garantie de paiement |
1.4 ExtraParameters
Le tableau Extraparameters permet de gérer le profil à appliquer lors de la saisie des informations bancaires. Il peut représenter l’application d’un CSS particulier ou la traduction de la page de saisie par exemple.
| Propriété | Type | Exemple | Description |
|---|---|---|---|
| profilename | String | "directpayment" | Un profil est un ensemble de paramètres prédéfinis qui seront appliqués lors de l’accès au formulaire si celui-ci est renseigné. |
| systempaylanguage | String | "fr" | Paramètre permettant la traduction de la page du formulaire de saisie des informations bancaires. Langues disponibles dans Systempay : Allemand : de Anglais : en Chinois : zh Espagnol : es Français : fr Italien : it Japonais : ja Néerlandais : nl Polonais : pl Portugais : pt Russe : ru Suédois : sv Turc : tr |
1.5 Cas d’erreurs
| Code erreur | Explication |
|---|---|
| 195 | Carte de crédit introuvable |
| 704 | Paramètre(s) d’appel manquant(s) |
| 818 | L’url de callback serveur (urlCallback) n’est pas déclarée. Merci d’en faire la demande à S-money |
| 717 | CardId déjà existant |
| 828 | L’0 contient des caractères invalides. |
| 829 | Le profil 0 n’existe pas. |
| 830 | La langue 0 n’est pas prise en charge par nos services |