Intégration de paysafecard

1. Qu'est-ce que le paysafecard Service Center (MSC) ?

   Le MSC est un outil qui vous guide pas à pas pendant l'intégration de paysafecard à votre boutique en ligne. Lorsque c'est fait, il vous sert à vérifier le statut de vos transactions.

   En remplissant le formulaire de contact, vous serez connecté au Service Center.

   Pendant la phase de démarrage de paysafecard vous pouvez utiliser le MSC pour :

   • Sélectionner comment vous souhaitez intégrer paysafecard
   • Télécharger les documents requis
   • Signer le contrat de partenaire
   • Finaliser l'intégration technique de paysafecard
   • Contacter notre service d'assistance

   Une fois l'intégration terminée, le MSC reste à votre disposition pour :

   • Gérer vos adresses IP
   • Télécharger des rapports
   • Vérifier le statut de vos transactions
   • Contacter notre service d'assistance / d'information en cas d'urgence

   Si vous êtes un portail de paiement, vous ne pourrez utiliser le Service Center que pour l'intégration de paysafecard.

2. Quels sont les types d’intégration de paysafecard comme moyen de paiement ?

   Vous pouvez intégrer paysafecard directement ou indirectement en utilisant un plug-in, une passerelle de paiement ou un fournisseur de services de paiement (PSP) global/d’encaissement.

   intégration technique directe

   • Vous concluez un contrat directement avec paysafecard
   • Tests d’intégration via le centre de services marchands (MSC)
   • Exemple de code disponible en ligne dans la section de téléchargement
   • Support direct de paysafecard
   • Notifications directes de paysafecard

    

   intégration technique indirecte

   • PSP – Passerelle de paiement
     • Vous concluez un contrat directement avec paysafecard
     • Intégration technique réalisée par une passerelle de paiement vérifiée de paysafecard
     • Aucuns travaux techniques ne sont nécessaires de votre côté.
     • Tests d’intégration simplifiés - Support direct de paysafecard
     • Notifications directes de paysafecard
     • Vous trouverez ici une liste des passerelles de paiement
   • PSP – PSP global/d’encaissement
     • Pas de contrat avec paysafecard mais avec le PSP global/d’encaissement
     • Transactions et facturation également réalisées par le PSP global/d’encaissement
     • Aucuns travaux techniques ne sont nécessaires de votre côté
     • Vous trouverez ici une liste des PSP global/d’encaissement
   • Systèmes de boutique - Plug-ins paysafecard vérifiés
     • Vous concluez un contrat directement avec paysafecard
     • Moins de travaux techniques sont nécessaires de votre côté (uniquement pour configurer le système de boutique)
     • Tests d’intégration simplifiés
     • Support à la fois de l’exploitant du système de boutique et de paysafecard
     • Notifications directes de paysafecard
3. Comment fonctionne le processus d'intégration technique de paysafecard ?

   Lors de l'intégration technique de paysafecard comme moyen de paiement, notre MSC vous guide à travers les étapes suivantes :

   • Choisissez votre type d'intégration
     Choisissez si vous allez intégrer paysafecard directement ou indirectement via un plug-in ou un payment gateway.
   • Données d'accès MRT/clé d'API au système de test
     Nous vous communiquons des clés d'API REST de paysafecard vous permettant de tester notre API REST et le Merchant Reporting Tool (MRT), seulement disponible pour système de test pour contrôler le statut de vos transactions). Cette étape sera ignorée si vous faites l'intégration à l'aide d'un plug-in ou d'un Payment Gateway.
   • Test d’intégration
     Une série de cas de test sera fournie par notre MSC. Ils doivent être effectués dans la commande spécifiée en temps réel et vérifiés par rapport à notre système. Cette étape sera ignorée si vous faites l'intégration à l'aide d'un plug-in ou d'un Payment Gateway. Si vous recourez également à un de nos services, "Payout" ou "Refund", cette fonctionnalité sera testée par notre équipe dès que le test d’intégration aura été passé avec succès.
   • Liste blanche IP pour le système de production
     Une fois le test d'intégration réussi, nous vous invitons à nous indiquer vos adresses IP pour le système de production, qui doivent être autorisées dans notre système interne.
   • Clé API pour le système de production
     Dès que la liste blanche IP a été achevée, paysafecard vous fournira les détails d’accès au système de production paysafecard. Nous vous demandons alors d’intégrer paysafecard dans votre système de production en entrant les détails d’accès REST dans votre système.
   • Test d’acceptation
     Une fois que vous avez terminé cette étape, nos collaborateurs effectuent une dernière transaction d'essai et vérifient l'actualité et la qualité du logo paysafecard utilisé et des textes s'y rapportant.
   • Go Live
     Dès que le test d’acceptation aura été achevé avec succès par notre équipe, paysafecard sera autorisée à utiliser une méthode de paiement pour votre boutique en ligne et vous pourrez commencer à traiter des paiements avec paysafecard.
4. Quelle est la technologie utilisée par paysafecard ?

   L'application de paiement paysafecard repose sur une REST API. REST, Representational State Transfert, est un style architectural du World Wide Web. REST utilise les méthodes HTTP habituelles (GET, POST, PUT, DELETE, etc.).

5. Quels sont les statuts possibles d'une transaction paysafecard ?

   Les transactions paysafecard peuvent avoir 7 statuts différents

   • INITIATED:
     Il s'agit du statut initial d'une transaction après sa création.
   • REDIRECTED:
     Le client/la cliente a bien été redirigé(e) avec succès vers le payment panel de paysafecard en vue d'autoriser le paiement.
   • AUTHORIZED:
     Le client/la cliente a entré avec succès un code PIN sur le payment panel et a cliqué sur payer.
   • SUCCESS:
     Le paiement a été effectué avec succès.
   • CANCELLED_MERCHANT:
     Vous avez interrompu le paiement en qualité de partenaire contractuel
   • CANCELLED_CUSTOMER
     Le client/la client a volontairement annulé le paiement sur le payment panel.
   • EXPIRED:
     Le client/la cliente n'a pas autorisé la transaction dans les temps impartis ou vous, en qualité de partenaire contractuel, n'avez pas achevé le paiement dans les temps impartis.
6. Quels sont les codes d'erreurs les plus fréquents ?

   Les codes d'erreurs les plus fréquents sont :

   • 2001 | La transaction existe déjà
     Veillez à ce que l'ID de corrélation soit une valeur unique par transaction.
   • 3014 | Critères de reporting non disponibles
     Prenez soin d'utiliser un subId convenu au préalable avec paysafecard.
   • 3034 | Critères de reporting inactifs
     Prenez soin d'utiliser un subId convenu au préalable avec paysafecard.
   • 3001 | Le MID est inactif 
     Si le processus d'accueil n'est pas encore terminé, c'est complètement normal, car votre compte reste inactif jusqu'à ce que les derniers tests d'intégration aient été réussis. Si votre compte est activé, contactez notre assistance technique.
   • 2029 | Le montant doit être supérieur à 0 
     Veillez à ce que le montant de la transaction soit supérieur à 0.
   • 4003 | Le montant dépasse le montant maximum autorisé  :
     Veillez à ce que le montant de la transaction ne dépasse pas le maximum autorisé (1000 EUR ou l'équivalent dans une autre devise).
   • 3002 , 10014 | Devise non valable 
     La devise que vous utilisez n'est pas activée pour votre compte. Veuillez contacter votre responsable de compte.
   • 2017 | La transaction a un statut erroné pour cette action 
     Vérifiez le statut de la transaction avec des détails « retrouver le paiement » et effectuez une action d'après son résultat (veuillez consulter le flux des paiements).
   • 3007 | Tentative de débit après l'expiration de la fenêtre de temps 
     La transaction n'a pas été conclue pendant la fenêtre de temps disponible (entre 1 et 10 minutes, définie par nos Conditions générales), donc elle est venue à expiration. Le montant est restitué au bon paysafecard ou au compte du client.
   • 2002 | La transaction n'existe pas 
     Veillez à ce que l'ID du paiement soit correct.
   • 10008 | Échec de l'autentification  
     Veillez à utilisier la clef API correcte
   • et le point final correct. Vous pouvez générer de nouvelles Clés API dans le MSC.
   • 10007 | Erreur technique générale 
     Contactez immédiatement paysafecard via integration@paysafecard.com si le compte n'est pas activé. Pour les comptes activés, il faudra contacter techsupport@paysafecard.com.
   • Erreur technique sur le pupitre de paiement.
     Veillez à ce que le lien de redirection vers le panneau de paiement que vous utilisez est correct et que la transaction n'est pas venue à expiration.
   • 3162 | Le compte my paysafecard n'a pas été trouvé par les identifiants fournis  
     Veillez à ce que l'adresse e-mail saisie dans la demande de versement corresponde à l'adresse e-mail enregistrée dans le compte my paysafecard.
   • 3195 | Les détails du compte du client ne correspondent pas.
     Veillez à ce que le prénom, le nom de famille et la date de naissance saisis dans la demande de versement correspondent à ceux du compte my paysafecard.

7. Que signifie « Payment Landing Page » ?

   Cela fait référence à la fenêtre de paiement de paysafecard. Après le démarrage d'une transaction, vous devez rediriger le client ou la cliente vers la fenêtre de paiement afin qu'il/elle puisse saisir un code PIN paysafecard ou ses identifiants my paysafecard pour autoriser la transaction.

8. De combien de temps la cliente ou le client dispose-t-elle/il pour saisir son code PIN/ses identifiants d'utilisateur my paysafecard dans la fenêtre de paiement ?

   Le client dispose de 30 minutes pour autoriser le paiement.

   Après avoir créé une transaction de paiement (Initiate Payment), le client dispose de 30 minutes pour saisir un code PIN dans la fenêtre de paiement ou pour se connecter à son compte my paysafecard. Lorsque 30 minutes s'écoulent sans saisie aboutie du code PIN ni connexion à my paysafecard, le statut de la transaction passe de « REDIRECTED » à « EXPIRED ». Les transactions en statut « EXPIRED » n'ont pas abouti et le client doit créer une nouvelle transaction de paiement.

9. Que se passe-t-il si la demande de « Capture Payment (récupération de paiement) » est appelée plus d'une fois pendant une transaction unique ?

   La première « Capture Payment (récupération de paiement) » sera couronnée de succès, les suivantes échoueront avec le code d'erreur 2017.

   Dès que la demande de « Capture Payment (récupération de paiement) » est terminée, l'étape de la transaction est mise à jour à « SUCCESS », ce qui veut dire qu'elle s'est achevée avec succès. Si une autre demande de « Capture Payment (récupération de paiement) » est émise pour la même transaction, la réponse [http400 and Error Code = 2017] est retournée. Afin d'éviter cela, l'état de la transaction doit toujours être contrôlée à l'aide de « Capture Payment (récupération de paiement) », et ne demander seulement les « Capture Payment (récupération de paiement) » dont l'état est « AUTHORIZED ».

10. Quand le montant de la transaction est-il débité du code PIN du client ou de son compte ?

    Le montant de la transaction est débité au client seulement si « Capture Payment » aboutit.

    Si l'on ne fait pas appel à « Capture Payment » ou si l'action n'aboutit pas, le montant de la transaction sera remboursé sur le bon paysafecard du client ou sur son compte après la fenêtre de temps disponible.

11. Que signifie le terme « Fenêtre de temps à disposition » ?

    C'est le temps que vous avez pour appeler « Capture Payment » une fois que le client a autorisé la transaction.

    La « Fenêtre de temps à disposition » est une période de temps définie par le contrat. La durée standard est de 10 minutes. Après l’attribution du code PIN du client ou du compte my paysafecard, une transaction doit être réalisée avec un appel « Capture Payment » durant cette période sinon le montant réservé sur le code PIN ou le compte my paysafecard du client sera libéré et rendu au client.

12. Que se passe-t-il lorsqu'une transaction n'aboutit pas à un appel « Capture Payment » ?

    Une transaction ne peut aboutir sans appeler « Capture Paiements ». Le montant de la transaction réservé sur le code PIN du client ou sur son compte my paysafecard sera libéré. Dans ce cas, si la fenêtre de temps à disposition est arrivée à terme, la transaction échoue.

13. Est-il possible d'utiliser HTTPS comme Payment Notification URL (pnURL) ?

    Oui, lorsqu'il s'agit d'un certificat émis par un organisme de certification officiel (par exempl Thawte et Verisign ).

14. Où puis-je trouver un exemple de code pour l'API REST paysafecard ?

    Vous trouverez les exemples de code de l'API REST paysafecard dans l'espace de téléchargement sur notre site Internet.

15. Comment puis-je passer à l'environnement de production ?

    Pour passer à l'environnement de production, vous devez saisir la clé API de production et modifier le point d'accès en production. Dans le MSC, vous pouvez trouver et créer de nouvelles clés API et vous trouverez aussi les points d'accès.

    Veuillez noter qu'avant de pouvoir visualiser ces données de production, vous devrez réaliser les tests d'intégration automatique dans le MSC (sauf si vous utilisez un plug-in vérifié ou un portail de paiement), vous devrez toutefois signer un contrat et suivre certaines étapes commerciales de notre côté.

16. À quoi sert le test des fonctions ?

    Le test des fonctions est exécuté uniquement si vous mettez en œuvre un service de Paiement ou de Remboursement. Il permet de vérifier que ces services ont été correctement mis en place.

    Après avoir exécuté les tests d’intégration automatisés dans le centre de services marchands (MSC), vous pouvez demander le test des fonctions. Ce test est réalisé manuellement par notre personnel. Pour exécuter cet essai, nous avons besoin d’un accès à votre environnement de test.

17. À quoi sert le test d’acceptation dans le système de production ?

    Le test d’acceptation permet de vérifier le bon fonctionnement des paiements avec paysafecard. Ce test est exécuté manuellement par notre personnel. Tout en contrôlant que les paiements exécutés avec paysafecard suivent la procédure correcte (https://www.paysafecard.com/fileadmin/api/#/reference/payment-process), nous vérifions également le bon affichage des messages de succès/échec pour le client et l’utilisation appropriée des logos paysafecard.

18. Comment fonctionne le test d’intégration sur le système de test ?

    Après l’intégration de l’API REST dans votre système de test, nous vous invitons à tester sa mise en œuvre. Le centre de services marchands (MSC) met une série de tests à votre disposition afin de vérifier le bon fonctionnement de toutes les fonctions de l’application de paiement paysafecard.

    Ces tests détaillés doivent être effectués en temps réel et dans l’ordre défini par le MSC. Ensuite, les résultats des tests sont vérifiés par le système de test paysafecard. Immédiatement après, vous recevez un rapport de test résumant toutes les informations sur le test et contenant des renseignements sur les éventuelles adaptations à apporter.

19. Qu’est-ce que les clés d’API REST ?

    Vous avez besoin de données d’accès pour accéder à notre système. Celles-ci sont dénommées « clés d’API ». Vous trouverez votre clé d’API dans le centre de services marchands (MSC).

    Ces données d’accès servent à des fins de vérification sur notre API REST et doivent être enregistrées obligatoirement dans votre système dans le cadre de la mise en œuvre technique de paysafecard.

    Nous attirons votre attention sur le fait que vous devez garder cette clé secrète et la protéger contre l’accès d’un tiers. paysafecard décline toute responsabilité en cas de dommages résultant de l’utilisation abusive de ces données d’accès.

20. Pourquoi dois-je faire valider mes adresses IP par paysafecard ?

    Pour des raisons de sécurité, notre système de production nous autorise l'accès uniquement aux adresses IP validées. C'est pourquoi, lors de l'étape « liste blanche des IP » de la procédure, nous vous demandons de nous communiquer toutes les adresses IP avec lesquelles vous souhaitez accéder à notre système de production.