Plateforme

Erreurs

Format des erreurs et codes HTTP.

Toutes les erreurs ont la même forme. Fiez-vous à error.code, stable, plutôt qu'au message.

{
  "error": {
    "code": "validation_failed",
    "message": "The request is invalid.",
    "details": {
      "fields": {
        "amount": [
          "The amount field must be an integer."
        ]
      }
    }
  }
}

HTTP	Code	Description
`400`	idempotency_key_required	En-tête Idempotency-Key manquant.
`401`	unauthorized	Clé absente, invalide, expirée ou révoquée.
`402`	insufficient_funds	Solde insuffisant.
`403`	account_not_active	Compte non vérifié ou suspendu.
`404`	not_found	Ressource introuvable.
`409`	request_in_progress	Requête identique encore en cours.
`422`	validation_failed	Paramètres invalides ; voir details.fields.
`422`	route_not_available	Aucun prestataire disponible pour cet opérateur ou cette devise.
`422`	provider_not_available	Le prestataire demandé n'est pas disponible. Pour un paiement mobile money ou un transfert, un prestataire qui ne dessert pas l'opérateur (ou qui n'accepte que les cartes) est remplacé par un autre plutôt que refusé.
`409`	duplicate_merchant_reference	Une transaction porte déjà ce merchant_reference.
`429`	rate_limited	Trop de requêtes.
`500`	internal_error	Erreur de notre côté ; vous pouvez réessayer.