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 :
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 :
{
"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.