Gestion des erreurs - HUB2 Documentation

Format des erreurs

Toutes les erreurs renvoyées par l’API HUB2 utilisent le format suivant. Les requêtes rejetées par le pare-feu applicatif (WAF) renvoient à la place un 403 avec un corps HTML (voir Sécurité).

Nom du champ	Description
`status`	Le code de statut HTTP
`code`	Un code d’erreur métier défini par l’API HUB2 (voir la liste ci-dessous)
`message`	Une description lisible de l’erreur
`request_id`	Identifiant unique de la requête

Exemple : erreur 404

{
    "status": 404,
    "code": "Not Found",
    "message": "Country not found",
    "request_id": "req_RRg_xtA55q32PLIWYVLFL"
}

Note : indiquez la valeur de request_id lorsque vous contactez le support HUB2 ; elle permet à l’équipe de retrouver votre requête et de répondre plus rapidement.

Codes d’erreur

Codes de statut HTTP

Les codes de statut HTTP n’indiquent pas des erreurs applicatives.

Codes de statut HTTP standards que l’API HUB2 peut renvoyer :

Code de statut	Texte de statut	Description
`200`	`OK`	La requête s’est exécutée comme prévu.
`201`	`Created`	La ressource a été créée.
`202`	`Accepted`	La requête a été acceptée pour un traitement asynchrone.
`400`	`Bad Request`	La requête est invalide, souvent en raison d’un paramètre manquant ou mal formaté.
`401`	`Unauthorized`	Aucune clé API valide n’a été fournie.
`403`	`Forbidden`	La clé API n’a pas les permissions nécessaires pour effectuer la requête.
`404`	`Not Found`	La ressource demandée n’existe pas.
`409`	`Conflict`	La requête est en conflit avec une autre action déjà en cours ou déjà terminée.
`422`	`Unprocessable Entity`	Les paramètres sont valides, mais la requête n’a pas pu être traitée.
`429`	`Too Many Requests`	Trop de requêtes ont été envoyées en peu de temps. La requête a été rejetée pour préserver les performances globales de l’API. Voir Limites de flux.
`500`, `501`, `502`, `503`, `504`	Erreurs serveur	Une erreur s’est produite du côté de HUB2.

Codes d’erreur applicatifs

Codes d’erreur applicatifs que l’API HUB2 peut renvoyer :

Code	Motif
`account-already-exists`	Un compte de ce type existe déjà pour le marchand dans ce mode (live ou sandbox).
`cancellation-already-done`	La transaction a déjà été annulée.
`insufficient-funds`	Le compte ne dispose pas de fonds suffisants pour transférer le montant demandé.
`invalid-currency`	La devise est invalide.
`locked-account`	Le compte est verrouillé.
`transaction-not-found`	La transaction est introuvable pour ce compte.
`currency-not-found`	La devise est introuvable.
`withdrawal-unavailable`	Les retraits sont indisponibles sur le compte. Le compte peut être bloqué ou ne pas disposer de fonds suffisants.
`missing-funds-reservation`	Les fonds réservés sont insuffisants.
`merchant-not-found`	Le marchand est introuvable.
`unsupported-command`	Commande non prise en charge.
`no_auth_required`	L’intention de paiement ne requiert pas d’authentification.
`transaction_canceled`	L’intention de paiement a été annulée. Aucun paiement ne peut être traité.
`transaction_missing`	La transaction (transfert ou paiement) est introuvable.
`transaction_in_progress`	La transaction (transfert ou paiement) est déjà en cours.
`transaction_done`	La transaction (transfert ou paiement) a déjà été effectuée.

​Format des erreurs

​Exemple : erreur 404

​Codes d’erreur

​Codes de statut HTTP

​Codes d’erreur applicatifs

Format des erreurs

Exemple : erreur 404

Codes d’erreur

Codes de statut HTTP

Codes d’erreur applicatifs