Dépannage de l'API

L'identifiant unique de votre requête sur notre plateforme.

Si vous avez besoin de notre aide pour résoudre l'erreur liée à cette requête, assurez-vous de l'ajouter dans votre message lorsque vous nous contactez.

Description lisible par l'homme de la catégorie générale d'erreur.

Cela peut être soit des erreurs techniques soit des exceptions de transaction.

statuserrors.httpStatusCode

Code d'erreur à 3 chiffres lié aux codes de statut HTTP standard.

{
  "errorId": "8c0e1431-4c6c-4fcf-8c58-c8c083730968",
  "errors": [
    {
      "code": "9007",
      "id": "ACCESS_TO_MERCHANT_NOT_ALLOWED",
      "category": "DIRECT_PLATFORM_ERROR",
      "message": "ACCESS_TO_MERCHANT_NOT_ALLOWED",
      "httpStatusCode": 403
    }
  ],
  "status": 403
} 

{
  "errorId": "4dac7acb-70c1-4917-80cd-068833fd8da5",
  "errors": [
    {
      "errorCode": "50001130",
      "category": "DIRECT_PLATFORM_ERROR",
      "code": "1002",
      "httpStatusCode": 404,
      "id": "UNKNOWN_PAYMENT_ID",
      "message": "UNKNOWN_PAYMENT_ID",
      "propertyName": "paymentId",
      "retriable": false
    }
  ]
} 

{
  "errorId": "5298814d-ca42-4fd5-926e-ceed1b69fccc",
  "errors": [
    {
      "errorCode": "50001111",
      "category": "DIRECT_PLATFORM_ERROR",
      "code": "1008",
      "httpStatusCode": 400,
      "id": "INVALID_VALUE",
      "propertyName": "order.amountOfMoney"
    }
  ]
}

...
  "status": "REJECTED",
  "statusOutput": {
    "errors": [
      {
        "errorCode": "50001066",
        "category": "DIRECT_PLATFORM_ERROR",
        "code": "1099",
        "httpStatusCode": 400,
        "id": "INVALID_VALUE",
        "message": "INVALID_VALUE",
        "retriable": false
      }
    ],
...

Erreurs techniques se rapportant à des données inconnues/invalides fournies lors de la requête, telles que

• Valeurs de propriété/gammes de valeurs autorisées. Vérifiez notre référence API/l'onglet "Intégration" dans les guides de méthode de paiement pour les valeurs correctes
• Données dont notre plateforme a besoin pour traiter votre requête (c'est-à-dire hostedCheckoutId/paymentId etc.)
• API Key/Secret/PSPID envoyés dans la requête ne correspondent pas aux données de notre plateforme

Vérifiez les propriétés errors.message/errors.id pour des informations détaillées

Configurez la API Key/Secret correctement et/ou envoyez les bonnes données dans votre requête

1002

1003

1004

1005

Vous avez envoyé un paymentId invalide pour l'une des requêtes suivantes :

Assurez-vous d'envoyer votre requête au bon merchantId (votre PSPID sur notre plateforme)/ environnement

1099

1008

1007

Vous avez envoyé une valeur invalide pour une ou plusieurs propriétés dans votre requête. Reportez-vous à errors.propertyName pour obtenir la liste des propriétés impactées.

Assurez-vous d'envoyer la/les valeurs(s) correcte(s)/type de données/intervalle autorisé comme défini dans notre référence API

L' API Key/Secret/PSPID envoyée dans la requête ne correspond pas aux données de notre plateforme

Assurez-vous d'envoyer la/les valeur(s) correcte(s) et/ou de configurer correctement la API Key/Secret dans votre PSPID avant d'envoyer une nouvelle requête

Votre module Prévention de la fraude a rejeté la transaction car la localisation du client est sur votre liste noire.

(Re-)évaluez quels pays ont le plus grand nombre de ces rejets. S'il est peu probable que vous ayez des clients authentiques dans ce pays, gardez ce pays sur votre liste noire.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car vous avez une règle bloquant les transactions avec un pays IP différent du pays de la carte.

(Re-)évaluez si cette règle de fraude est trop stricte pour votre modèle économique, conduisant au blocage de transactions légitimes. S'il est peu probable qu'il y ait une différence entre le pays de l'IP et le pays de la carte pour les clients légitimes, conservez ce paramètre.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car vous avez une règle bloquant les transactions avec un nombre de pays autorisés dans les données transactionnelles trop élevé.

(Re-)évaluez si cette règle de fraude est trop stricte pour votre modèle économique, conduisant au blocage de transactions légitimes.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car la localisation du client est sur votre liste noire.

(Re-)évaluez dans quels pays vous avez des clients authentiques. S'il est peu probable que vous ayez des clients authentiques dans ce pays, gardez ce pays sur votre liste noire.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car vos clients ont masqué l'origine de l'IP.

(Re-)évaluez si votre modèle économique justifie l'autorisation de l'utilisation d'un proxy anonyme.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car l'origine de l'IP n'a pas pu être déterminée.

(Re-)évaluez si votre modèle économique justifie d'autoriser les transactions pour lesquelles le pays de vos clients est inconnu.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car l'IP est sur votre liste noire.

(Re-)évaluez si votre modèle économique justifie de bloquer les transactions de cette adresse IP spécifique (c'est-à-dire en raison de transactions frauduleuses passées liées à cette IP).

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car le BIN est sur votre liste noire.

(Re-)évaluez si votre modèle économique justifie de bloquer les transactions avec ce BIN spécifique (c'est-à-dire en raison de transactions frauduleuses passées liées à ce BIN).

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car le numéro de carte est sur votre liste noire.

(Re-)évaluez si votre modèle économique justifie de bloquer les transactions avec ce numéro de carte spécifique (c'est-à-dire en raison de transactions frauduleuses passées liées à ce numéro de carte).

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car l'adresse e-mail du client est sur votre liste noire.

(Re-)évaluez si votre modèle économique justifie de bloquer les transactions avec cette adresse e-mail spécifique (c'est-à-dire en raison de transactions frauduleuses passées liées à cette adresse e-mail).

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car le nom du client (envoyé dans la propriété order.additionalinput.airlineData.passengers dans votre requête CreatePayment / CreateHostedCheckout) est sur votre liste noire.

(Re-)évaluez si votre modèle économique justifie de bloquer les transactions avec ce nom spécifique (c'est-à-dire en raison de transactions frauduleuses passées liées à ce nom).

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car le nom du titulaire de la carte est sur votre liste noire.

(Re-)évaluez si votre modèle économique justifie de bloquer les transactions avec ce nom de porteur de carte spécifique (c'est-à-dire en raison de transactions frauduleuses passées liées à ce nom de porteur de carte).

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car vous avez une règle bloquant le nombre de transactions avec la même adresse e-mail en une journée.

(Re-)évaluez si votre modèle économique justifie de bloquer les transactions d'une adresse e-mail spécifique utilisée plusieurs fois en une journée (c'est-à-dire en raison de transactions frauduleuses passées liées à ce scénario).

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre module Prévention de la fraude a rejeté la transaction car ils avaient un score de risque total dépassant votre seuil d'acceptation.

Ce chiffre indique que de nombreuses tentatives de fraude ont été bloquées.

(Re-)évaluez si votre modèle économique justifie des règles moins strictes si vous craignez de bloquer des transactions légitimes.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre acquéreur a rejeté la transaction car votre MID (merchant ID) ne fonctionne pas correctement.

Contactez-nous et votre acquéreur pour vous assurer que le MID est correctement configuré de notre côté et du côté de votre acquéreur.

L'émetteur de votre client a rejeté la transaction car la carte

• A expiré.
• Est soupçonnée d'utilisation frauduleuse.

Assurez-vous

• De (re-)évaluer si cette carte doit être mise sur la liste noire du module Prévention de la fraude.
• Que vos clients utilisent des cartes valides si vous travaillez avec la méthode d'intégration Server-to-server.

L'émetteur de votre client a rejeté la transaction sans divulguer de raison spécifique. En raison des lois sur la protection des données, les émetteurs fourniront cette raison de rejet pour la plupart de vos transactions refusées.

Assurez-vous

• De contacter votre acquéreur si vous avez un nombre disproportionné de rejets avec ce code d'erreur.
• De (re-)évaluer si ces rejets pourraient être frauduleux en consultant l'évaluation dans votre Prévention de la fraude module.

L'émetteur de votre client a rejeté la transaction car la carte

• Est incorrecte.
• A expiré.

Assurez-vous que

• Vos clients utilisent des cartes valides si vous travaillez avec la méthode d'intégration Server-to-server.
• De (re-)évaluer si ces rejets pourraient être frauduleux, car entrer à plusieurs reprises des données de carte invalides peut être considéré comme des tentatives de fraude. Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre acquéreur ou l'émetteur de votre client a rejeté la transaction car la carte utilisée a été signalée comme volée.

Assurez-vous de mettre cette carte sur la liste noire du module Prévention de la fraude.

L'émetteur de votre client a rejeté la transaction en raison de fonds insuffisants pour ce paiement.

Assurez-vous de permettre à vos clients de

• Sélectionner une autre méthode de paiement pour réessayer.
• Modifier le contenu de leur panier pour réduire leur total. Envisagez de contacter vos clients pour leur rappeler de finaliser leur achat ultérieurement.

L'émetteur de votre client a rejeté la transaction car il n'accepte pas une carte d'entreprise pour ce type d'achat.

Assurez-vous de

• Permettre à vos clients de sélectionner une autre méthode de paiement pour réessayer.
• Envisager de contacter vos clients pour leur rappeler de finaliser leur achat ultérieurement.

L'émetteur de votre client a rejeté la transaction car la carte utilisée a été utilisée pour des transactions frauduleuses.

Assurez-vous de mettre cette transaction dans la liste noire du module Prévention de la fraude. Notre plateforme bloquera ensuite automatiquement toutes autres tentatives correspondantes aux informations associées à cette transaction frauduleuse.

Contactez-nous pour configurer votre module Prévention de la fraude pour une protection maximale et des taux de conversion élevés en même temps.

Votre acquéreur ou l'émetteur de votre client a rejeté la transaction en raison de restrictions (de sécurité) associées à la carte.

Assurez-vous de

• Permettre à vos clients de sélectionner une autre méthode de paiement pour réessayer.
• Informer vos clients des restrictions (de sécurité) associées à la carte pour leur permettre de les lever.

Votre acquéreur a rejeté la transaction car il n'accepte pas cette carte pour ce type d'achat.

Assurez-vous de contacter votre acquéreur si vous rencontrez régulièrement ce type de rejets. Vous pourriez être en mesure de renégocier votre contrat pour lever d'éventuelles contraintes d'acceptation.

Votre acquéreur ou l'émetteur de votre client a rejeté la transaction en raison d'un échec de la vérification 3-D Secure. Cela pourrait être lié à des échecs d'authentification légitimes (par exemple, problème technique avec l'appareil ou le réseau de vos clients, lecteurs de cartes manquants ou codes PIN oubliés) ou à des tentatives de fraude.

Assurez-vous de

• Implémenter le 3-D Secure correctement si vous utilisez la méthode d'intégration Server-to-server
• Aider vos clients à se préparer à la procédure d'authentification 3-D Secure dans votre processus de paiement.

40001135

50001081

Votre acquéreur ou l'émetteur de votre client a rejeté la transaction en raison d'un échec de la vérification 3-D Secure. Cela est dû au fait que l'émetteur n'était pas disponible pour confirmer l'identité du titulaire de la carte.

Cette erreur provient de la banque émettrice et est hors de votre contrôle. Toutefois, vous pouvez envisager les actions suivantes :

• Permettre à vos clients de sélectionner une autre méthode de paiement pour réessayer.
• Envisager de contacter vos clients pour les informer des raisons du rejet et les encourager à finaliser leur achat ultérieurement.

Votre acquéreur ou l'émetteur de votre client a rejeté la transaction en raison d'une absence de vérification 3-D Secure. Cela est dû au fait que notre plateforme n'a pas pu déployer le 3-D Secure.

Cette erreur provient de notre plateforme et est hors de votre contrôle. Toutefois, vous pouvez envisager les actions suivantes :

• Permettre à vos clients de sélectionner une autre méthode de paiement pour réessayer.
• Soumettre à nouveau la transaction ultérieurement.

Notre plateforme a rejeté la transaction car au moment du traitement nous n'avons pas pu confirmer l'identité du titulaire de la carte en raison d'une défaillance inattendue.

Pour récupérer cette transaction refusée, soumettez à nouveau la transaction ultérieurement ou suggérez une autre méthode de paiement au titulaire de la carte.

L'émetteur de votre client a rejeté la transaction car vous avez tenté de contourner la vérification 3-D Secure en utilisant notre Soft Decline mécanisme. Comme l'émetteur insiste sur le 3-D Secure, la transaction a été rejetée.

Assurez-vous de récupérer la transaction comme décrit dans notre guide dédié.

Notre plateforme a rejeté la transaction car le processus d'authentification avec l'acquéreur n'a pas pu être complété dans le délai imparti.

Assurez-vous de nous contacter pour 

• Confirmer que tous les systèmes fonctionnent correctement.
• Identifier les éventuels problèmes de connexion de notre côté.

Notre plateforme a rejeté la transaction en raison d'un écart entre la marque que vous avez définie dans la propriété cardPaymentMethodSpecificInput.paymentProductId et le numéro de carte dans la propriété cardPaymentMethodSpecificInput.card.cardNumber. Cette erreur se produit exclusivement lorsque vous utilisez la méthode d'intégration Server-to-server.

Assurez-vous de :

• Détecter correctement la marque de la carte/données de carte invalides avant de soumettre la transaction à notre plateforme.
• Permettre à vos clients de sélectionner une autre méthode de paiement pour réessayer.

Notre plateforme a rejeté la transaction car nous n'avons pas pu effectuer la vérification 3-D Secure. Cela est dû à un problème technique avec votre requête.

Assurez-vous de :

• Implémenter correctement le 3-D Secure si vous utilisez la méthode d'intégration Server-to-server
• Permettre à vos clients de sélectionner une autre méthode de paiement pour réessayer.

Notre plateforme a rejeté la demande car vous avez essayé de rembourser un paiement avant que le paiement initial n'ait été entièrement capturé.

Assurez-vous de vérifier que le paiement que vous souhaitez rembourser a bien été capturé.

UNKNOWN_PAYMENT_ID

UNKNOWN_REFUND_ID

UNKNOWN_PAYOUT_ID

UNKNOWN_CAPTURE_ID

Vous avez envoyé une valeur invalide pour la propriété paymentId/payoutId pour l'une des requêtes suivantes :

RefundPayment
GetPaymentDetails
GetHostedCheckout
CapturePayment

Assurez-vous de

• Envoyer votre requête au bon merchantId (votre PSPID sur notre plateforme) / environnement.
• Envoyer le paymentId dans le format correct pour l'appel d'API respectif :
  GetHostedCheckout
  RefundPayment
  GetPaymentDetails
  CapturePayment
  CompletePayment

UNKNOWN_PRODUCT_ID

UNKNOWN_PRODUCT_GROUP_ID

UNKNOWN_PRODUCT_IDS

UNKNOWN_PRODUCT_GROUP_IDS

Vous avez envoyé une valeur invalide pour la propriété paymentProductId / hostedCheckoutSpecificInput.paymentProductFilters dans votre requête.

Assurez-vous de

• Envoyer les bonnes valeurs telles que définies dans notre référence API et dans l'onglet "Aperçu" pour les méthodes de paiement individuelles.
• Vérifier que la méthode de paiement est active dans votre compte.

Vous avez envoyé une valeur invalide pour une ou plusieurs propriétés de votre requête (spécifiées dans la propriété errors.propertyName).

Assurez-vous d'envoyer les bonnes valeurs/type de données/plage autorisée comme défini dans notre référence API.

Vous avez envoyé une requête pour effectuer une opération de maintenance qui n'est pas autorisée pour cette transaction spécifique pour l'une des requêtes.

RefundPayment
CapturePayment
CompletePayment

Assurez-vous de

• Vérifier errors.errorCode pour savoir quelle action interdite vous avez tenté.
• Vérifier que le statut de la transaction permet l'opération de maintenance que vous souhaitez effectuer.

Vous avez envoyé une requête avec un paymentProductId qui fait référence à une méthode de paiement non active/disponible dans votre PSPID.

Assurez-vous de

• L'activer dans l'environnement de test dans votre PSPID.
• Contactez-nous pour l'activer dans l'environnement de production.

Vous avez envoyé une requête de CreatePayment/CreateHostedCheckout pour un paiement Card On File avec un token invalide/inexistant.

Assurez-vous que le token existe dans le PSPID auquel vous envoyez la requête.

Vous avez envoyé une requête CreatePayment avec une discordance entre la marque que vous avez définie dans la propriété cardPaymentMethodSpecificInput.paymentProductId et le numéro de carte dans la propriété cardPaymentMethodSpecificInput.card.cardNumber. Cette erreur se produit exclusivement lors de l'utilisation de la Server-to-server méthode d'intégration.

Assurez-vous de détecter correctement la marque de la carte/données de carte invalides avant de soumettre la transaction à notre plateforme.

Vous avez envoyé une requête RefundPayment pour une transaction traitée avec une méthode de paiement qui ne prend pas en charge les remboursements.

Assurez-vous de vérifier dans la vue d'ensemble de moyen de paiement pour la méthode de paiement concernée qu'elle prend en charge les remboursements.

L'identification 3-D Secure pour cette transaction a échoué.

Assurez-vous de vous référer à errors.errorCode pour la cause première et les actions possibles.