Aperçu
L’API Dodo Payments fournit des raisons d’échec de transaction détaillées pour vous aider à comprendre pourquoi une tentative de paiement a échoué. Ces raisons d’échec sont standardisées à travers différents moyens de paiement et fournisseurs, ce qui facilite la mise en œuvre d’une gestion des erreurs cohérente dans votre application. Chaque réponse d’échec de transaction inclut :- Un code de raison d’échec spécifique
- Un message d’erreur lisible par l’homme
- Un contexte supplémentaire sur l’échec lorsque disponible
- Si l’erreur peut être corrigée par l’utilisateur ou nécessite une intervention système
- Fournir un retour d’information clair à vos clients
- Mettre en œuvre une logique de réessai appropriée
- Gérer différents scénarios d’échec avec grâce
- Maintenir un système de traitement des paiements fiable
Raisons d’Échec de Transaction
Le tableau suivant répertorie toutes les raisons possibles d’échec de transaction, leurs significations et si ce sont des erreurs corrigibles par l’utilisateur.| Code d’Échec | Erreur Utilisateur | Description |
|---|---|---|
AUTHENTICATION_FAILURE | Oui | Le processus d’authentification a échoué pendant la transaction |
AUTHENTICATION_REQUIRED | Oui | Une authentification supplémentaire est nécessaire pour compléter la transaction |
AUTHENTICATION_TIMEOUT | Oui | Le processus d’authentification a expiré |
CARD_DECLINED | Non | La carte a été refusée par la banque émettrice |
CARD_NOT_ACTIVATED | Oui | La carte n’a pas été activée par le titulaire de la carte |
CARD_VELOCITY_EXCEEDED | Oui | Trop de transactions tentées dans une courte période |
CUSTOMER_CANCELLED | Oui | Le client a annulé la transaction |
DO_NOT_HONOR | Non | La banque émettrice a refusé la transaction |
EXPIRED_CARD | Oui | La carte a expiré |
FRAUDULENT | Oui | La transaction a été signalée comme potentiellement frauduleuse |
GENERIC_DECLINE | Non | La transaction a été refusée pour une raison non spécifiée |
INCORRECT_CVC | Oui | Le code CVC fourni était incorrect |
INCORRECT_NUMBER | Oui | Le numéro de carte a été saisi incorrectement |
INSUFFICIENT_FUNDS | Oui | Le compte a des fonds insuffisants pour compléter la transaction |
INVALID_ACCOUNT | Oui | Les détails du compte fournis sont invalides |
INVALID_AMOUNT | Oui | Le montant de la transaction est invalide |
INVALID_CARD_NUMBER | Oui | Le format du numéro de carte est invalide |
INVALID_CARD_OWNER | Oui | Les informations du propriétaire de la carte sont invalides |
INVALID_CVC | Oui | Le format du CVC est invalide |
INVALID_EXPIRY_YEAR | Oui | L’année d’expiration de la carte est invalide |
INVALID_PIN | Oui | Le code PIN fourni est incorrect |
INVALID_REQUEST | Oui | La demande de transaction contient des données invalides |
INVALID_UPI_ID | Oui | L’ID UPI fourni est invalide |
LIMIT_EXCEEDED | Oui | La transaction dépasse la limite de la carte ou du compte |
LIVE_MODE_TEST_CARD | Oui | Une carte de test a été utilisée en mode live |
LOST_CARD | Oui | La carte a été signalée comme perdue |
MANDATE_INVALID | Oui | Le mandat de paiement est invalide |
MANDATE_REQUIRED | Oui | Un mandat est requis pour cette transaction |
MANDATE_REQUIRED_SYSTEM | Non | Le système nécessite un mandat pour ce type de transaction |
NETWORK_ERROR | Non | Une erreur réseau s’est produite pendant la transaction |
NETWORK_TIMEOUT | Non | La requête réseau a expiré |
ORDER_CREATION_FAILED | Non | Échec de la création de la commande pour la transaction |
PAYMENT_METHOD_PROVIDER_DECLINED | Oui | Le fournisseur de méthode de paiement a refusé la transaction |
PAYMENT_METHOD_UNSUPPORTED | Oui | La méthode de paiement n’est pas prise en charge pour cette transaction |
PICKUP_CARD | Oui | La carte a été signalée comme volée et doit être récupérée |
PROCESSING_ERROR | Non | Une erreur s’est produite lors du traitement de la transaction |
PROVIDER_UNSUPPORTED | Non | Le fournisseur de paiement ne prend pas en charge ce type de transaction |
REENTER_TRANSACTION | Oui | La transaction doit être saisie à nouveau |
REVOCATION_OF_AUTHORIZATION | Oui | L’autorisation de la transaction a été révoquée |
STOLEN_CARD | Oui | La carte a été signalée comme volée |
TRANSACTION_NOT_ALLOWED | Oui | La transaction n’est pas autorisée pour cette carte ou ce compte |
TRANSACTION_NOT_APPROVED | Oui | La transaction n’a pas été approuvée |
TRY_AGAIN_LATER | Non | La transaction doit être réessayée plus tard |
UNKNOWN_ERROR | Non | Une erreur inconnue s’est produite |
Erreur Utilisateur indique si le refus de paiement peut être résolu par le client. Lorsque
true, le client peut agir pour corriger le problème (par exemple, en saisissant les bons détails de la carte). Lorsque false, le refus est dû à des problèmes au niveau du système ou à des restrictions bancaires qui ne peuvent pas être résolues par le client.