Codes d’erreur

L’API Royal Finance renvoie toujours un corps JSON structuré :

{
  "error": {
    "code":    "validation_failed",
    "message": "Le champ \"amount\" doit être positif.",
    "field":   "amount"
  }
}

Codes courants

| Code | HTTP | Sens | |----------------------------|------|---------------------------------------------------| | validation_failed | 422 | Un champ est invalide (voir field) | | invalid_request | 400 | JSON malformé, paramètre manquant | | unauthorized | 401 | Clé absente ou révoquée | | forbidden | 403 | Scope insuffisant | | not_found | 404 | ID inconnu | | conflict | 409 | Idempotency-Key réutilisée avec un autre body | | insufficient_funds | 422 | Wallet débiteur sans solde suffisant | | wallet_frozen | 403 | Wallet gelé (KYC, fraude) | | kyc_required | 403 | KYC manquant pour l’action demandée | | fraud_blocked | 403 | Bloqué par le moteur anti-fraude | | rate_limited | 429 | Trop de requêtes — voir header Retry-After | | internal_error | 500 | Bug côté Royal — réessayez avec backoff |

Headers utiles

• Royal-Request-Id — à fournir au support pour tout incident.
• Retry-After — secondes à attendre en cas de 429 ou 503.