Passer au contenu principal

Format de Reponse d’Erreur

{
  "error": {
    "code": "invalid_document",
    "message": "L'image du document n'a pas pu etre traitee",
    "type": "validation_error",
    "param": "document_front",
    "request_id": "req_a1b2c3d4"
  }
}

Codes de Statut HTTP

StatutDescription
200Succes
201Cree
400Requete Invalide - Parametres invalides
401Non Autorise - Cle API invalide
403Interdit - Permissions insuffisantes
404Non Trouve - La ressource n’existe pas
409Conflit - La ressource existe deja
429Trop de Requetes - Limite de debit atteinte
500Erreur Serveur - Quelque chose s’est mal passe

Types d’Erreur

TypeDescription
validation_errorParametres de requete invalides
authentication_errorProblemes de cle API
authorization_errorProblemes de permission
not_found_errorRessource non trouvee
rate_limit_errorLimite de debit depassee
idempotency_errorConflit de cle d’idempotence
api_errorErreur serveur interne

Codes d’Erreur Courants

Erreurs d’Authentification

CodeDescription
unauthorizedCle API manquante ou invalide
forbiddenLa cle API n’a pas les permissions requises
key_revokedLa cle API a ete revoquee
ip_not_allowedRequete depuis une IP non autorisee

Erreurs de Validation

CodeDescription
invalid_requestLe corps de la requete est mal forme
missing_parameterUn parametre requis est manquant
invalid_parameterLa valeur du parametre est invalide
invalid_documentL’image du document ne peut pas etre traitee
unsupported_countryPays non supporte
unsupported_documentType de document non supporte

Erreurs d’Identite

CodeDescription
document_expiredLe document a expire
document_unreadableImpossible d’extraire les donnees du document
face_not_detectedAucun visage trouve dans l’image
face_mismatchLe selfie ne correspond pas au document
liveness_failedLe controle de vivacite a echoue
fraud_detectedFalsification de document detectee

Erreurs de Transaction

CodeDescription
transaction_declinedLa transaction a ete refusee
velocity_exceededLimite de debit depassee
recipient_blockedLe destinataire est sur liste noire
amount_exceededLe montant depasse les limites

Erreurs de Limite de Debit

CodeDescription
rate_limit_exceededTrop de requetes
La reponse inclut le champ retry_after :
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Limite de debit depassee",
    "retry_after": 30
  }
}

Gerer les Erreurs

try {
  const result = await txcloud.identity.verify({ ... });
} catch (error) {
  switch (error.code) {
    case 'invalid_document':
      // Demander a l'utilisateur de reprendre la photo
      break;
    case 'face_mismatch':
      // Demander un nouveau selfie a l'utilisateur
      break;
    case 'rate_limit_exceeded':
      // Attendre et reessayer
      await sleep(error.retryAfter * 1000);
      break;
    default:
      // Journaliser et afficher une erreur generique
      console.error('Erreur API:', error);
  }
}