Aperçu des Services Web
- Payments
- Reporting
- Canada
- Europe & UK
- United States
- Legacy
Que sont les services Web Paysafe?
Les services Web sont une technologie qui permet aux applications de communiquer entre elles indépendamment de la plateforme et du langage de programmation. Un service Web est une interface logicielle qui décrit un ensemble d’opérations accessibles sur le réseau par le biais d’une messagerie XML normalisée. Il utilise des protocoles basés sur le langage XML pour décrire une opération à exécuter ou des données à échanger avec un autre service Web. Les services Web reposent sur des normes ouvertes telles que SOAP et WSDL.
Les services Web Paysafe offrent les avantages suivants :
- Les marchands peuvent s’intégrer facilement à l’API Service Web, en utilisant leur plateforme et leur langue de préférence.
- Les marchands peuvent automatiser les opérations et éviter de saisir manuellement les informations via la page Web de Paysafe.
- Les marchands peuvent opérer indépendamment des changements et des mises à jour du site Web de Paysafe.
Services Web pour le prélèvement automatique
Paysafe prend actuellement en charge les services Web suivants pour le prélèvement automatique :
Opération | Description |
---|---|
Débit | Permet de transférer de l’argent du compte bancaire d’un client vers votre compte marchand. Cette transaction est effectuée en temps réel, mais le réseau bancaire prend 3 à 5 jours pour transférer les fonds. |
Crédit | Vous permet de transférer de l’argent de votre compte marchand directement sur le compte bancaire d’un client. Cette transaction est effectuée en temps réel, mais le réseau bancaire prend 3 à 5 jours pour transférer les fonds. |
Mettre à jour les renseignements d’expédition | Permet d’envoyer des renseignements sur l’expédition, y compris un numéro de suivi, une fois que vous avez expédié des marchandises pour lesquelles vous avez précédemment traité une transaction de type « débit ». |
Recherche d’informations | Vous permet d’exécuter un rapport par l’intermédiaire de l’API sur une plage de dates que vous spécifiez pour obtenir des données sur les transactions de prélèvement automatique et de crédit traitées par l’intermédiaire de votre compte marchand. |
Requête de mandat | Permet de créer un mandat pour le compte bancaire d’un client et de le déposer auprès de sa banque, ce qui vous permet de transférer de l’argent du compte bancaire du client vers votre compte marchand. Le réseau bancaire prend généralement 5 jours pour traiter le mandat. |
Modifier un état | Permet de modifier l’état d’une opération de débit, de crédit ou de mandat. |
Mettre à jour un mandat | Permet de mettre à jour les informations contenues dans un mandat existant. |
La disponibilité des types d’opérations de prélèvement automatique est attribuée en fonction du marchand, étant donné que toutes les banques des marchands ne prennent pas en charge toutes les opérations. Si vous avez des questions, veuillez communiquer avec votre gestionnaire de compte.
Services Web pour les cartes de crédit
Paysafe prend actuellement en charge les services Web suivants pour les cartes de crédit :
Opération | Description |
---|---|
Autorisation | Vous permet de confirmer qu’une carte de crédit existe et qu’elle dispose de fonds suffisants pour couvrir un achat, mais sans imputer les fonds sur votre compte marchand. |
Achat | Il s’agit à la fois d’autoriser et de régler un montant demandé sur une carte de crédit. |
Vérification | Permet d’effectuer un contrôle SVA et/ou CVD sur une carte de crédit sans effectuer de débit sur cette carte. |
Renversement d’autorisation | Permet de renverser la totalité ou une partie d’une autorisation existante, à condition qu’aucun règlement (total ou partiel) n’ait été traité par rapport à cette autorisation. Ce type de transaction ne fonctionne pas avec les transactions d’achat, mais uniquement avec les autorisations. |
Crédit | Permet d’émettre un crédit pour un montant qui a été précédemment imputé. |
Règlement | Vous permet d’imputer le montant d’une autorisation existante, en créditant le montant autorisé de la carte de crédit sur votre compte marchand. |
Autorisation avec données stockées | Permet d’autoriser un montant sur la carte de crédit d’un client en utilisant les données client qui sont stockées dans notre base de données. Vous ne fournissez qu’un minimum d’informations, ce qui vous permet d’économiser du temps et des efforts. |
Données d’achat stockées | Permet d’autoriser et de régler un montant sur la carte de crédit d’un client en utilisant les données client qui sont stockées dans notre base de données. Vous ne fournissez qu’un minimum d’informations, ce qui vous permet d’économiser du temps et des efforts. |
Annuler | Permet d’annuler une transaction de crédit, de règlement, de paiement ou de crédit autonome. Vous pouvez annuler l’une de ces transactions tant qu’elle est en attente, c’est-à-dire généralement avant minuit le jour où elle est demandée. Dans certains cas, vous pouvez trouver d’anciennes transactions de crédit en attente. |
Paiement | Permet de créditer un montant sur la carte de crédit d’un client. La transaction de paiement n’est pas associée à une autorisation existante, de sorte que le montant de la transaction n’est pas limité de cette manière. |
Crédit autonome | Permet de créditer un montant sur la carte de crédit d’un client. La transaction de crédit autonome n’est pas associée à une autorisation existante, de sorte que le montant de la transaction n’est pas limité de cette manière. |
Recherche d’informations | Permet d’exécuter un rapport via l’API sur une plage de dates que vous spécifiez afin de renvoyer des données sur les transactions par carte de crédit traitées par votre compte marchand. |
Recherches d’affiliations | Permet de déterminer si la carte de crédit d’un client est inscrite au programme 3D Secure. REMARQUE: Cette opération n’est prise en charge que pour 3D Secure 1.0.2. |
Authentification | Permet d’envoyer une requête d’authentification afin qu’un titulaire de carte inscrit à 3D Secure authentifie sa carte auprès de l’émetteur de la carte avant que vous ne traitiez une autorisation. REMARQUE: Cette opération n’est prise en charge que pour 3D Secure 1.0.2. |
La disponibilité des types d’opérations par carte de crédit est attribuée en fonction du marchand, étant donné que toutes les banques des marchands ne prennent pas en charge toutes les opérations. Si vous avez des questions, veuillez communiquer avec votre gestionnaire de compte.
Services Web pris en charge pour le service de recherche d’informations
Paysafe prend actuellement en charge le service Web suivant :
Opération | Description |
---|---|
Service de recherche d’informations | Vous permet d’exécuter un rapport via l’API sur une plage de dates que vous spécifiez pour renvoyer des données sur les autorisations, les règlements, les crédits et les refus de débit traités par un compte marchand. |
Exigences système
L’API SOAP a été testée avec les environnements clients suivants :
Client SOAP | Environnement de programmation | Environnement d’exploitation |
---|---|---|
Microsoft .NET 1.1 and 2.0 Framework | Microsoft Visual Studio .NET 2003 | Microsoft Windows Server 2003 and Windows XP |
Apache Axis 1.4 | Java (J2SE 1.4.X and higher) | Linux and Microsoft Windows XP, Server 2003 |
Apache Axis 2.0Apache Axis 2.0 | Java (J2SE 1.4.X and 1.5.X) | Linux and Microsoft Windows XP, Server 2003 |
Pour de plus amples renseignements :
• J2SE ou J2EE 1.3.1 ou version ultérieure (1.4.X recommandé) Sun Microsystems, Inc. http://java.sun.com/downloads/index.html
• 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
Quel que soit le client SOAP que vous adoptez, il doit prendre en charge la messagerie de type documentaire.
Accès aux WSDL Paysafe et aux liens
Prélèvement automatique
WSDL :
https://webservices.optimalpayments.com/directdebitWS/DirectDebitService/v1?wsdl
Service Web :
https://webservices.optimalpayments.com/directdebitWS/DirectDebitService/v1
HTTP Post:
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
HTTP Post:
https://webservices.optimalpayments.com/creditcardWS/CreditCardServlet/v1
Service de recherche d’informations
WSDL :
https://webservices.optimalpayments.com/ilsWS/IlsService/v1?wsdl
Service Web :
https://webservices.optimalpayments.com/ilsWS/IlsService/v1
HTTP Post:
Test des services Web Paysafe
Une fois que vous avez configuré votre application compatible avec les services Web, veuillez contacter notre équipe de soutien technique pour des instructions sur la manière de tester vos appels d’API.
Fonctions de sécurité
Pour certaines transactions (p. ex. les achats), Paysafe propose des fonctions supplémentaires pour protéger le marchand contre l’utilisation frauduleuse d’une carte.
• Système de vérification d’adresse (SVA)
• Données de validation de la carte (CVD)
• Base de données négative
• 3D Secure
SVA
Paysafe prend en charge les contrôles de vérification d’adresse (SVA) lorsque la banque émettrice prend en charge cette fonctionnalité. Le SVA vérifie si l’adresse fournie par le client utilisant une carte correspond à l’adresse de facturation associée à cette carte auprès de la banque émettrice. Cela rend plus difficile l’utilisation frauduleuse de la carte, car pour utiliser une carte volée, il faut également connaître l’adresse de facturation qui lui est associée. En outre, si des marchandises doivent être expédiées, le marchand peut exiger qu’elles le soient à l’adresse de facturation associée à la carte.
Au sein de Paysafe, chaque mode de paiement est configuré avec l’ensemble acceptable de codes de renvoi du SVA. Si la banque renvoie un code qui n’est pas acceptable pour la méthode de paiement, la demande est rejetée avec une erreur « Autorisation échouée ». Si vous obtenez un message d’erreur « Autorisation échouée » en réponse à une requête de transaction, et qu’un numéro d’autorisation est renvoyé dans la réponse, cela signifie que l’échec a été causé par le contrôle du SVA. Vous pouvez consulter le code SVA renvoyé pour déterminer exactement la raison de l’échec du contrôle du SVA. Paysafe renvoie les codes suivants, dans l’élément avsResponse, à l’application du marchand en réponse à une requête de transaction, où A, N et E indiquent un échec du SVA :
Lettre de code | Explication |
---|---|
A | L’adresse concorde, mais pas le code postal/zip. |
B | Le SVA n’a pas été effectué pour la transaction internationale. Soit le code postal a un format non valide, soit les informations relatives à l’adresse ne sont pas fournies. |
E | Le SVA n’est pas pris en charge pour ce secteur. |
M | Pour les transactions internationales, l’adresse et le code postal doivent concorder. |
N | Aucune partie de l’adresse ne concorde. |
Q | Réponse inconnue de l’émetteur/du commutateur bancaire. |
R | Réessayer. Le système est incapable de procéder au traitement. |
S | SVA non pris en charge. |
U | Les informations relatives à l’adresse ne sont pas disponibles. |
W | Le code postal à neuf chiffres concorde, mais pas l’adresse. |
X | Exact. Le code postal à neuf chiffres et l’adresse concordent. |
Y | Oui. Le code postal à cinq chiffres et l’adresse concordent. |
Z | Le code zip à cinq chiffres concorde, mais pas l’adresse. |
Lorsque vous vous êtes enregistré auprès de Paysafe, votre compte a été configuré pour appliquer automatiquement les contrôles du SVA. Paysafe n’accepte que les transactions pour lesquelles les codes de renvoi SVA autorisés sont renvoyés.
Le SVA a trois limitations, qui peuvent affecter les décisions que vous prenez concernant les contrôles SVA échoués :
- Le SVA n’est pas toujours fiable. Des résultats erronés peuvent être obtenus si une personne a déménagé, par exemple, ou parce que certaines personnes indiquent un code zip à cinq chiffres et d’autres un code postal à neuf chiffres.
- Le SVA n’apporte qu’un soutien limité au niveau international. Si vous décidez, par conséquent, de n’expédier qu’à des adresses qui renvoient de bons résultats pour le SVA, vous risquez d’exclure des transactions par ailleurs valides.
- Le SVA est pris en charge par de nombreuses banques émettrices américaines, mais pas toutes. Ainsi, même si vous ne servez que des clients américains, vous ne pourrez pas toujours compter sur la disponibilité du SVA.
CVD
La valeur CVD est un nombre à 3 ou 4 chiffres imprimé sur la carte de crédit, mais qui n’est pas présent sur la bande magnétique. Par conséquent, la valeur n’est pas imprimée sur les reçus ou les relevés, ce qui réduit la probabilité de fraude à partir des informations contenues dans les empreintes. La fonction CVD, conçue spécifiquement pour les transactions en l’absence d’une carte, est une exigence de Paysafe. Nous prenons en charge la fonction CVD partout où les banques émettrices le font.
Lorsque les clients saisissent les informations relatives à leur carte et au titulaire de la carte, la valeur de la CVD est demandée en même temps. L’un des quatre indicateurs signale l’état d’une requête de CVD :
- Non fourni : le client n’a pas fourni la valeur CVD.
- Fourni : le client a fourni la valeur CVD. Lorsque cet indicateur est sélectionné, la valeur CVD est fournie.
- Illisible : le client prétend que la valeur CVD est illisible.
- Absent : le client affirme que la valeur CVD ne figure pas sur la carte.
Base de données négative
Paysafe gère une base de données négative qui offre une protection supplémentaire contre l’utilisation abusive des cartes et les requêtes de transactions inappropriées. Les numéros de carte et les adresses courriel sont introduits dans la base de données négative pour les raisons suivantes :
- Une rétrofacturation associée au numéro de carte ou à l’adresse courriel a eu lieu.
- Le numéro de la carte ou l’adresse courriel a fait l’objet d’une activité frauduleuse ou est soupçonné d’en avoir fait l’objet.
Votre compte est configuré pour mettre en œuvre automatiquement ce dispositif de sécurité, et toute requête de transaction qui tente d’utiliser un numéro de carte ou une adresse courriel qui se trouve dans la base de données négative ne sera pas traitée.
3D Secure
Paysafe 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ûres en authentifiant l’identité du titulaire de la carte au moment de l’achat, avant que le marchand ne soumette une requête d’autorisation. Il est actuellement pris en charge par plusieurs marques de cartes, dont Visa (Verified by Visa), MasterCard (SecureCode) et American Express (SafeKey). Les autorisations traitées à l’aide de 3D Secure sont garanties contre les types de litiges les plus courants en matière de rétrofacturation.
Paysafe est conforme à la version 2.1.0 de 3DS.
- Les demandes d’inscription et d’authentification de cette API ne prennent en charge que la version 1.0.2 de 3D Secure.
- Les requêtes d’achat/autorisation accepteront les champs d’authentification de 3D Secure version 2. Voir Créer des requêtes d’achat/autorisation/vérification pour de plus amples renseignements.
- Pour utiliser les champs d’authentification 3D Secure 2, vous devez d’abord vous intégrer à l’API REST 3D Secure 2.