Aller au contenu

Codes d'erreur

Les erreurs renvoyées par le SDK de paiement et l'API Cardencer, leur signification et comment les corriger.

Chaque erreur indique ce qui s'est passé et la marche à suivre. Affichez au client des messages adaptés pour les erreurs de carte, et journalisez tout le reste avec le payment_id.

Erreurs du SDK#

confirmPayment() et les autres appels du SDK renvoient un objet error en cas de problème :

js
const { error } = await hyper.confirmPayment({ widgets, confirmParams: { return_url }, redirect: "if_required" });
if (error) console.log(error.type, error.message);

Les messages sont renvoyés en anglais par le SDK ; ils sont reproduits tels quels ci-dessous.

error.type Message Correction
invalid_request_error Invalid api key Initialisez le SDK avec une clé publiable valide (pk_snd_… ou pk_prd_…) correspondant à l'environnement.
invalid_request_error Invalid value for <parameter> Vérifiez l'option transmise au SDK.
invalid_request_error Missing required parameter: <parameter> Transmettez l'option manquante.
invalid_request_error Invalid client secret Utilisez le client_secret d'un paiement créé avec le même compte et dans le même environnement, et créez un nouveau paiement s'il a expiré.
invalid_request_error Invalid promise Transmettez la promesse renvoyée par votre loader du SDK.
card_error, validation_error Card declined or invalid card details Affichez error.message et permettez au client de réessayer ou d'utiliser une autre carte.
processing_error Payment failed with the payment processor Invitez le client à réessayer ou à utiliser une autre carte.
internal_server_error Server is unavailable Réessayez après quelques secondes.
object_not_found Payment does not exist Vérifiez le client_secret ; le paiement appartient peut-être à un autre environnement.
confirm_payment_failed An unknown error occurred Récupérez le paiement depuis votre serveur pour connaître son statut, puis réessayez.

Erreurs de l'API#

Les erreurs de l'API renvoient un statut HTTP et un corps JSON :

json
{
  "error": {
    "type": "invalid_request",
    "message": "Missing required param: amount",
    "code": "IR_04"
  }
}

Les codes sont regroupés par préfixe :

Préfixe Signification
IR Requête invalide : corrigez la requête et réessayez.
CE Erreur de traitement provenant de l'acquéreur ou du réseau de carte.
HE Erreur de la plateforme Cardencer.
WE Erreur de webhook.

Codes courants#

Code HTTP Message Correction
IR_00 501 This API is under development L'endpoint n'est pas disponible sur votre compte.
IR_01 401 API key not provided or invalid API key used Envoyez la clé secrète complète dans l'en-tête api-key, en respectant l'environnement.
IR_02 404 Unrecognized request URL Vérifiez le chemin et l'URL de base.
IR_03 405 The HTTP method is not applicable for this API Vérifiez la méthode dans la référence API.
IR_04 400 Missing required param: field_name Ajoutez le champ.
IR_05 422 field_name contains invalid data Envoyez le format attendu.
IR_06 400 (message) Lisez le message ; une combinaison de champs n'est pas valide.
IR_07 400 Invalid value provided: field_name Envoyez une valeur autorisée.
IR_08 400 Client secret was not provided Transmettez le client_secret.
IR_09 400 The client_secret provided does not match Utilisez le secret de ce paiement.
IR_16 400 (message) : une condition portant sur plusieurs champs, ou sur l'état actuel de l'objet, n'est pas remplie Récupérez le paiement et vérifiez son statut avant de le confirmer, de le capturer ou de l'annuler.
IR_28 400 (message) Utilisez une devise prise en charge.
CE_01 400 Payment failed during authorization Invitez le client à réessayer ou à utiliser une autre carte.
CE_02 400 Payment failed during authentication 3D Secure a échoué ; réessayez ou utilisez une autre carte.
CE_03 400 Capture attempt failed Relancez la capture.
CE_04 400 The card data is invalid Demandez des données de carte correctes.
CE_05 400 The card has expired Demandez une autre carte.
CE_06 400 Refund failed Relancez le remboursement.
HE_00 422/500 Resource not available right now Réessayez après quelques secondes ; contactez le support si le problème persiste.
HE_01 400/422 Requested operation for these identifier already exists Vous avez réutilisé un identifiant (paiement, remboursement, client). Utilisez-en un nouveau ou récupérez l'objet existant.
HE_02 404 Requested object does not exist Vérifiez l'identifiant et l'environnement.
HE_03 500 Validation failed Vérifiez les informations et réessayez.
WE_01 400 Failed to authenticate the webhook Vérifiez votre clé de signature des webhooks.

Refus#

Lorsque l'acquéreur ou l'émetteur refuse une carte, le paiement se termine en failed et fournit des informations complémentaires :

Champ Contenu
error_code, error_message Le code et le message de refus du processeur.
unified_code, unified_message Une catégorie normalisée que vous pouvez associer à vos messages client.
issuer_error_code, issuer_error_message La réponse de la banque émettrice, lorsqu'elle est disponible.

Affichez au client un message court (« Votre carte a été refusée. Veuillez essayer avec une autre carte. ») et conservez les codes dans vos journaux.

Limites de débit#

Un code HTTP 429 signifie que vous avez envoyé trop de requêtes, ou qu'une autre requête est en train de modifier le même objet. Réessayez avec un backoff exponentiel. Consultez Authentification.