Motifs d'échec

Lorsqu’un paiement (pay-in) échoue, le motif de l’échec est ajouté à l’objet failure du Payment renvoyé par l’API HUB2. Le PaymentIntent expose aussi le motif de la dernière tentative en échec dans lastPaymentFailure.

Important

Il s’agit d’erreurs applicatives, sans lien avec le protocole HTTP.Les codes de statut HTTP renvoyés par chaque point de terminaison de l’API HUB2 sont indiqués dans la référence de l’API HUB2.

Les motifs d’échec de cette page ne concernent que les erreurs rencontrées lors du traitement d’une transaction. L’objet failure contient un code, un message lisible lorsqu’une traduction est disponible et, en cas de paramètres invalides, la liste des paramètres concernés (params). Associez le code à votre propre texte destiné au client plutôt que d’afficher message tel quel.

De nouveaux motifs d’échec peuvent être ajoutés. Traitez les codes inconnus de façon générique, par exemple comme un échec standard.

Code	Description
`internal_error`	Le paiement a échoué à la suite d’une erreur interne. Notre équipe technique a été prévenue.
`service_unavailable`	Le paiement a échoué. L’opérateur est actuellement indisponible.
`service_temporarily_disabled`	Le paiement a échoué. Le service est temporairement désactivé en raison d’un incident en cours.
`unknown_reason`	Le paiement a échoué. L’opérateur n’a fourni aucune raison.
`reconciliation_failure`	Le paiement a échoué. Il n’a pas pu être réconcilié ou confirmé auprès de l’opérateur.
`customer_account_locked`	Le paiement a échoué. Le compte du client est bloqué par l’opérateur.
`customer_insufficient_funds`	Le paiement a échoué. Le client ne dispose pas de fonds suffisants.
`authentication_failed`	Le paiement a échoué. La validation du paiement par le client a échoué.
`authentication_timeout`	Le paiement a échoué. Le client n’a pas validé le paiement dans le délai imparti.
`issuer_authentication_unavailable`	Le paiement a échoué. Le service d’authentification de la banque émettrice n’a pas pu être joint.
`timeout`	Le paiement a échoué. Le délai d’exécution du paiement est dépassé.
`expired`	Le paiement a échoué. Le paiement a expiré.
`bad_parameters`	Le paiement a échoué à cause de paramètres incorrects.
`invalid_amount`	Le paiement a échoué. Le montant n’est pas valide pour cette opération.
`forbidden_by_provider`	Le paiement a été refusé par l’opérateur.
`forbidden_by_provider_maximum_limit`	Le paiement a échoué. Il dépasse une limite fixée par l’opérateur.
`too_many_request`	Le paiement a échoué. L’opérateur reçoit trop de requêtes. Réessayez plus tard.
`duplicate_request`	Le paiement a échoué. Une opération similaire vient d’être enregistrée. Réessayez plus tard.
`canceled_by_customer`	Le paiement a été annulé par le client.
`canceled`	Le paiement a été annulé par l’opérateur.
`fraud_suspicion`	Le paiement a échoué. L’opérateur a détecté une suspicion de fraude.
`unsupported_currency`	Le paiement a échoué. La devise n’est pas prise en charge par cet opérateur.
`payer_quota_exceeded`	Le paiement a échoué. Le quota du client est dépassé.
`invalid_payment_processor`	Le paiement a échoué. L’opérateur sélectionné ne permet pas d’effectuer cette opération.
`rejected_by_hub2`	Le paiement a échoué. Le virement a été rejeté par HUB2.
`forbidden_by_hub2`	Le paiement a échoué. Le service est interdit par HUB2.
`unsupported_service`	Le paiement a échoué. Le service n’est pas pris en charge par HUB2.
`invalid_msisdn`	Le paiement a échoué. Le numéro de téléphone (MSISDN) est incorrect.
`blacklisted_msisdn`	Le paiement a échoué. Le MSISDN est temporairement banni.
`wave_payment_expired`	Le paiement a expiré. N’utilisez plus le lien de paiement Wave correspondant.
`card_expired`	Le paiement a échoué. La date d’expiration de la carte est dépassée.
`card_declined`	Le paiement a échoué. La carte a été déclinée.
`card_stolen`	Le paiement a échoué. La carte est déclarée volée.
`card_refused`	Le paiement a échoué. La carte a été refusée.
`card_invalid`	Le paiement a échoué. La carte est invalide.
`card_cvn_invalid`	Le paiement a échoué. Le code de sécurité de la carte est invalide.
`address_verification_failed`	Le paiement a échoué. L’adresse ne correspond pas à la carte.
`payment_limit_reached`	Le paiement a échoué. Le plafond de la carte est atteint.

Guide de démarrage

Transferts

Paiements

Webhooks

Processing Only

Payment Links

Sous-marchands

Autre

Important