Motifs d'échec

Lorsqu’un transfert (Pay-Out) échoue, le motif de l’échec est ajouté à l’objet transfer renvoyé par l’API, dans le champ failureCause (code, message et params).

Important

Ce sont des erreurs applicatives, sans rapport avec les codes de statut HTTP.Les codes de statut HTTP renvoyés par chaque point de terminaison de l’API HUB2 sont indiqués dans la documentation de référence de l’API HUB2.

Les motifs d’échec de cette page concernent uniquement les erreurs survenues pendant le traitement d’une transaction.

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 transfert a échoué suite à une erreur interne. Notre équipe technique a été prévenue.
`invalid_amount`	Le transfert a échoué, le montant est invalide. Consultez les politiques sur les montants.
`service_unavailable`	Le transfert a échoué, l’opérateur est actuellement indisponible.
`service_temporarily_disabled`	Le transfert a échoué, le service est temporairement désactivé en raison d’un incident en cours. Notre équipe technique travaille à sa résolution.
`too_many_request`	Le transfert a échoué, l’opérateur reçoit trop de requêtes. Veuillez réessayer plus tard.
`unknown_reason`	Le transfert a échoué, l’opérateur n’a fourni aucune raison.
`reconciliation_failure`	Le transfert a échoué, il n’a pas pu être réconcilié ou confirmé avec l’opérateur.
`fraud_suspicion`	Le transfert a échoué, l’opérateur a détecté une suspicion de fraude.
`invalid_destination`	Le transfert a échoué, le destinataire est invalide.
`forbidden_by_provider`	Le transfert a échoué, il a été refusé par l’opérateur.
`forbidden_by_provider_maximum_limit`	Le transfert a échoué, il a été refusé par l’opérateur car une limite a été atteinte.
`forbidden_by_provider_blacklisted_msisdn`	Le transfert a échoué, le MSISDN du destinataire est bloqué par l’opérateur.
`timeout`	Le transfert a échoué, l’opérateur n’a pas répondu dans le délai imparti.
`insufficient_funds`	Le transfert a échoué, le marchand ne dispose pas de fonds suffisants.
`hub2_insufficient_funds`	Le transfert a échoué, les fonds du compte HUB2 chez l’opérateur sont insuffisants.
`customer_insufficient_funds`	Le transfert a échoué, le compte débité ne dispose pas de fonds suffisants.
`customer_account_locked`	Le transfert a échoué, le compte du destinataire est bloqué par l’opérateur.
`unsupported_currency`	Le transfert a échoué, cette devise n’est pas prise en charge.
`canceled`	Le transfert a été annulé par l’opérateur.
`canceled_by_customer`	Le transfert a été annulé par le client.
`destination_not_allowed`	Le transfert a échoué, l’opérateur refuse les envois vers ce destinataire.
`blacklisted_msisdn`	Le transfert a échoué, le MSISDN est temporairement bloqué par HUB2. Voir MSISDN - Liste noire.
`invalid_payment_processor`	Le transfert a échoué, l’opérateur sélectionné ne permet pas cette opération.
`duplicate_request`	Le transfert a échoué, une opération similaire vient d’être enregistrée. Veuillez réessayer plus tard.
`authentication_failed`	Le transfert a échoué, l’authentification auprès de l’opérateur a échoué.
`bad_parameters`	Le transfert a échoué, l’opérateur a rejeté les paramètres de la requête.
`bad_request`	Le transfert a échoué, la requête contient des erreurs ou est mal formatée.

Guide de démarrage

Transferts

Paiements

Webhooks

Processing Only

Payment Links

Sous-marchands

Autre

Important