DÉMARRER

Erreurs

Toutes les réponses ont la même enveloppe. En cas d’erreur, error remplace data. Gardez le requestId : il permet de retrouver la requête.

{
  "code": 422,
  "status": "error",
  "requestId": "req_exemple",
  "error": {
    "code": "IDEMPOTENCY_KEY_REUSED",
    "message": "Cette Idempotency-Key a déjà servi pour une autre demande."
  }
}

HTTP	Code	Quand	Que faire
400	`INVALID_PAYMENT_REQUEST`	Corps de paiement invalide : montant, devise, référence, provider null…	Corrigez les champs indiqués dans la réponse.
400	`INVALID_IDEMPOTENCY_KEY`	Clé absente ou hors de 16 à 128 caractères.	Générez une clé par tentative, par exemple un UUID.
401	`INVALID_API_KEY`	Clé absente, invalide, expirée ou révoquée.	Vérifiez la clé et son environnement.
403	`LIVE_KEY_REQUIRED`	Clé TEST envoyée à l’API LIVE.	Utilisez votre clé LIVE sur l’origine LIVE.
403	`TEST_KEY_REQUIRED`	Clé LIVE envoyée à l’API TEST.	Utilisez votre clé TEST sur l’origine sandbox.
404	`PAYMENT_NOT_FOUND`	Paiement absent pour ce marchand et cet environnement.	Vérifiez l’identifiant et l’environnement.
409	`DUPLICATE_MERCHANT_REFERENCE`	Référence déjà utilisée avec une autre clé d’idempotence.	Retrouvez le paiement par référence.
409	`PAYMENT_NOT_REFUNDABLE`	Le paiement ne peut pas être remboursé.	Vérifiez son statut et l’opérateur.
409	`REFUND_ALREADY_REQUESTED`	Un remboursement est déjà en cours ou terminé.	Consultez le remboursement existant.
422	`IDEMPOTENCY_KEY_REUSED`	Même clé utilisée avec un autre corps.	Rejouez le même corps ou générez une nouvelle clé.
501	`REFUND_PROVIDER_UNAVAILABLE`	Remboursement automatique Orange Money indisponible en LIVE.	Consultez les possibilités de l’opérateur.