Dépannage des requêtes API
Cette section énumère les erreurs courantes liées aux requêtes API et décrit comment résoudre les problèmes de formatage des requêtes API.
Erreurs courantes
| Erreur | Description | Comment résoudre |
|---|---|---|
| Utilisation d’un point de terminaison d’API incorrect | Les partenaires envoient leur requête à un point de terminaison d’API incorrect. | Vérifiez que vous pointez vers le bon point de terminaison d’API. Le cas échéant, vérifiez que vous avez inclus votre numéro de compte dans le point de terminaison. Assurez-vous qu’il n’y a pas d’espaces vides ou blancs dans l’URL ou de symboles de barre oblique (/) à la fin de l’URL. |
| Utilisation du HTTP | Toutes les requêtes API doivent être effectuées via HTTPS. Les appels effectués via HTTP normal échoueront. | Il faut toujours utiliser HTTPS. |
| Détails d’authentification incorrects ou manquants | Le partenaire indique un nom d’utilisateur et un mot de passe incorrects dans sa requête, ou ces informations sont manquantes. | Reportez-vous à la section sur l’Authentification pour de plus amples renseignements. |
| Numéro de compte/identifiant incorrect | De nombreux appels nécessitent un numéro de compte (identifiant de compte). | Veillez à utiliser l’identifiant du compte partenaire que vous avez reçu de Paysafe. |
| Environnement incorrect utilisé | Les partenaires soumettent une requête à l’environnement de test au lieu de l’environnement de production ou vice versa. Dans ce cas, la transaction est rejetée car les informations d’identification fournies sont incorrectes. | Veillez à mettre à jour votre code pour qu’il pointe vers l’environnement correct. |
| Type de contenu incorrect | Tous les appels aux API REST de Paysafe doivent utiliser un en-tête Content-Type réglé sur :
| |
| JSON non valide | La structure du corps de la requête API n’est pas conforme à la norme du schéma JSON; par exemple, les crochets sont absents. | Utilisez un outil de validateur JSON pour vérifier que la structure de votre requête JSON est valide. Assurez-vous que vous n’utilisez pas de caractères non valides dans le corps de la requête. Voir Caractères non valides globaux. |
| Paramètres non valides | La requête comprend des paramètres non valides. | Des exemples et des détails sur les paramètres à inclure sont fournis dans la rubrique Référence de l’API Gestion de compte. |
Validation du format JSON
Les problèmes liés au formatage des requêtes API sont fréquents. Nous vous recommandons d’utiliser un outil de validation JSON pour vérifier le formatage de votre demande et vous assurer qu’elle est valide. Voici quelques outils en ligne qui permettent la validation JSON :
Les liens vers les sites Web de tiers ne sont fournis qu’à titre de commodité. Paysafe n’offre aucune garantie concernant ces sites.