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 finaliser 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 |
CARD_VELOCITY_EXCEEDED | Oui | Trop de transactions ont été tentées en peu de temps |
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 n’a pas suffisamment de fonds pour finaliser la transaction |
INVALID_ACCOUNT | Oui | Les coordonnées du compte fournies 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 titulaire 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 requête 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 production |
LOST_CARD | Oui | La carte a été déclarée 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 exige 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 | Impossible de créer 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 relancée |
REVOCATION_OF_AUTHORIZATION | Oui | L’autorisation pour 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 est survenue |
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 ex., en saisissant les bonnes informations de carte). Lorsque false, le refus est dû à des problèmes au niveau du système ou à des restrictions bancaires que le client ne peut pas résoudre.