Gestion des erreurs

Structure des erreurs

{
  "statusCode": 400,
  "message": "Le montant doit être supérieur à 100 XOF",
  "error": "Bad Request"
}

Champ	Règle	Message
`amount`	Min: 100, Max: 5000000	”Le montant doit être entre 100 et 5 000 000”
`currency`	XOF, XAF, EUR, USD	”Devise non supportée”
`customerPhone`	Format E.164	”Format de numéro invalide”
`provider`	Valeur valide	”Méthode de paiement invalide”

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705312800

En cas de 429 Too Many Requests, attendez le timestamp X-RateLimit-Reset avant de réessayer.

Se fier à la redirection au lieu du webhook

Le returnUrl ne garantit pas le succès. Attendez toujours le webhook payment.completed.

Clé secrète exposée côté client

N’utilisez jamais sk_* dans du JavaScript navigateur. La clé secrète reste côté serveur uniquement.

Mauvais format de numéro

Envoyez +221771234567 (E.164), pas 771234567 ou 00221771234567.

Mélange d'environnements

Les clés sk_test_* ne fonctionnent qu’avec sandbox-api.caurisflux.com. Les clés sk_live_* uniquement avec prod-api.caurisflux.com.

transaction_id non sauvegardé

Stockez toujours le transactionId retourné. Sans lui, impossible de lier le webhook à votre commande.