Search Overlay

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.
Détails d’authentification incorrects ou manquants

Le marchand transmet un nom d’utilisateur et un mot de passe incorrects dans sa demande de paiement, ou ces informations sont manquantes.

Reportez-vous à la section sur l’Authentification pour de plus amples renseignements.
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.
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.

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; par exemple, 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 adressée à https://api.test.paysafe.com/cardpayments/v1/accounts/account_id/auths/auth_id/settlements, le paramètre auth_id est l’identifiant renvoyé dans la réponse à l’autorisation initiale.

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 :

  • Content-Type: application/json

  • Content-Type: application/json; charset=utf-8"t3://page?uid=74">Architecture de l’API REST pour de plus amples renseignements.

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.

Paramètres non valides La requête comprend des paramètres non valides.

Voir la Référence API Validation de compte bancaire pour des exemples et des renseignements sur les paramètres à inclure dans vos requêtes.

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.