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 et de soumission des requêtes API.
Erreurs courantes
| Erreur | Description | Comment résoudre |
|---|---|---|
| Utilisation d’un point de terminaison d’API incorrect | Les marchands 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. |
| Mode de paiement/devise non pris en charge par ce numéro de compte; les comptes ne prennent en charge qu’une seule combinaison de mode de paiement/devise | Le compte de test par défaut prend en charge les paiements par carte (Visa/Mastercard) dans la devise que vous avez sélectionnée lors de la création du compte. Les API Paiements par carte, Coffre-fort client, 3D Secure et Paiements hébergés (cartes uniquement) sont prises en charge. | Contactez le soutien technique pour des comptes de test supplémentaires pour différentes devises ou pour effectuer des paiements alternatifs ou des requêtes de prélèvement automatique. Vous aurez également besoin de comptes supplémentaires si vous souhaitez utiliser les autres modes de paiement disponibles avec l’API Paiements hébergés. |
| 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 les sections de la Référence API suivantes.
|
| 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 validation JSON pour vérifier que la structure de votre requête JSON est valide. Voir Validation de format JSON ci-dessous. 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. |
| Identifiant de ressource incorrect | De nombreux appels nécessitent l’identifiant unique d’une ressource créée lors d’une requête précédente; p. ex. pour soumettre une requête de règlement, vous avez besoin de l’identifiant renvoyé dans la réponse à la requête d’autorisation uniquement que vous souhaitez régler. | Assurez-vous que l’identifiant unique que vous utilisez dans le cadre d’une requête est bien celui que vous avez reçu dans une réponse précédente. Par exemple, dans une requête POST de règlement à https://api.test.paysafe.com/cardpayments/v1/accounts/account_id/auths/auth_id/settlements, le paramètre auth_id est celui retourné en réponse à l’autorisation initiale |
| Détails d’authentification incorrects ou manquants | Le marchand transmet un nom d’utilisateur et un mot de passe incorrects dans sa requête de paiement, ou ces informations sont manquantes. | Reportez-vous à la section sur l’Authentification pour de plus amples renseignements. |
| Environnement incorrect utilisé | Les marchands soumettent une requête à l’environnement de test au lieu de l’environnement de production ou l’inverse. 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 :
| |
| Numéro de compte/identifiant incorrect | De nombreux appels nécessitent un numéro de compte (identifiant de compte). | Veillez à utiliser le numéro de compte figurant dans le courriel que vous avez reçu lors de la création de votre compte. Par exemple, dans une requête POST de règlement adressée à https://api.test.paysafe.com/cardpayments/v1/accounts/account_id/auths/auth_id/settlements, le paramètre account_id est le numéro de compte de test que vous avez reçu du Paysafe. |
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. Vous trouverez ci-dessous une liste d’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.