Codes d'erreur

Toute erreur renvoyée par l'API suit la même structure. Cette page liste tous les codes d'erreur possibles.

Format des erreurs

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message",
    "field": "optional_field_name",
    "docs": "https://germinopay.com/docs/erreurs#ERROR_CODE",
    "request_id": "req_a1b2c3d4e5f6"
  }
}

ID de requête Chaque réponse d'erreur inclut un request_id. Mentionnez-le dans toute demande de support pour un diagnostic plus rapide.

HTTP codes HTTP

HTTP	Signification
200	Succès
201	Ressource créée
400	Requête invalide — paramètres erronés
401	Non autorisé — signature ou clé invalide
403	Interdit — permissions insuffisantes
404	Ressource introuvable
409	Conflit — référence en doublon
422	Impossible à traiter — erreur métier
429	Trop de requêtes — limité en débit
500	Erreur interne serveur
502	Fournisseur indisponible

Codes d'erreur

Code	HTTP	Description
Authentification
`INVALID_SIGNATURE`	401	La signature HMAC ne correspond pas. Vérifiez votre clé secrète et l'algorithme.
`MISSING_SIGNATURE`	401	L'en-tête X-Signature est manquant.
`INVALID_PUBLIC_KEY`	401	Clé publique inconnue ou révoquée.
`EXPIRED_TIMESTAMP`	401	Timestamp de plus de 5 minutes. Vérifiez l'horloge de votre serveur.
`API_DISABLED`	403	Vos clés API sont désactivées. Réactivez-les depuis votre tableau de bord.
Paramètres
`INVALID_PARAMETER`	400	Un champ requis est manquant ou de mauvais type. Voir la clé "field".
`INVALID_CURRENCY`	400	Devise non supportée pour ce fournisseur.
`INVALID_AMOUNT`	400	Le montant est nul, négatif ou inférieur au minimum du fournisseur.
`INVALID_PROVIDER`	400	Le fournisseur doit être paypal, cinetpay, fedapay ou paydunya.
Logique métier
`DUPLICATE_REFERENCE`	409	Une transaction avec cette référence existe déjà. Utilisez-en une nouvelle.
`INSUFFICIENT_BALANCE`	422	Solde insuffisant pour effectuer le retrait ou remboursement.
`TRANSACTION_NOT_REFUNDABLE`	422	Cette transaction ne peut pas être remboursée (échouée, déjà remboursée, expirée).
`REFUND_AMOUNT_EXCEEDED`	422	Le montant remboursé dépasse la transaction d'origine.
`ACCOUNT_NOT_VERIFIED`	403	Votre compte marchand n'est pas encore validé.
`ACCOUNT_SUSPENDED`	403	Votre compte est suspendu. Contactez le support.
`MONTHLY_LIMIT_EXCEEDED`	422	Vous avez dépassé votre limite mensuelle.
Fournisseur
`PROVIDER_ERROR`	502	Le fournisseur externe a renvoyé une erreur. Détails dans "message".
`PROVIDER_UNAVAILABLE`	502	Le fournisseur externe est indisponible. Réessayez plus tard.
`PROVIDER_TIMEOUT`	504	Le fournisseur externe n'a pas répondu à temps.
Limites
`RATE_LIMIT_EXCEEDED`	429	Trop de requêtes. Attendez et réessayez avec un backoff exponentiel.

Précédent Webhooks Suivant Fournisseurs