Passer au contenu principal

Apercu

TXCloud utilise un systeme de scoring de risque unifie a travers toutes les APIs. Les scores de risque vous aident a prendre des decisions eclairees sur les utilisateurs, les transactions et les entreprises.

Echelle de Score

Tous les scores de risque TXCloud utilisent une echelle de 0 a 1000 :
Plage de ScoreNiveau de RisqueDescription
0-200Tres FaibleHautement fiable, risque minimal
201-400FaibleNormal, procedez avec confiance
401-600MoyenQuelques preoccupations, envisagez une revision
601-800EleveRisque significatif, verification supplementaire
801-1000CritiqueRisque tres eleve, probablement bloquer
Scores plus eleves = Risque plus eleve. Un score de 0 est le plus sur, 1000 est le plus risque.

Score de Risque par API

Verification d’Identite

{
  "id": "ver_abc123",
  "status": "verified",
  "risk_score": 150,
  "risk_level": "low",
  "risk_factors": [
    { "code": "new_device", "weight": 50 },
    { "code": "document_age", "weight": 100 }
  ]
}

Scoring de Transaction

{
  "id": "trs_abc123",
  "decision": "approve",
  "risk_score": 320,
  "risk_level": "medium",
  "signals": {
    "positive": ["known_recipient", "normal_amount"],
    "negative": ["new_device"],
    "neutral": ["weekend_transaction"]
  }
}

Evaluation de Credit

{
  "id": "lra_abc123",
  "credit_score": 720,  // echelle 300-850 (credit traditionnel)
  "risk_score": 180,    // echelle TXCloud 0-1000
  "risk_level": "low",
  "grade": "B+"
}

Composants du Score

Les scores de risque sont calcules a partir de multiples signaux :

Signaux d’Identite

SignalImpactDescription
Fraude documentaire+300-500Falsification detectee
Non-correspondance faciale+200-400Le selfie ne correspond pas au document
Echec de vivacite+300-500Pas une personne vivante
Incoherence des donnees+100-200Les donnees extraites sont en conflit

Signaux d’Appareil

SignalImpactDescription
Appareil connu-50Appareil precedemment verifie
Nouvel appareil+50Premiere fois que l’appareil est vu
VPN detecte+100-200Connexion VPN active
Emulateur+300Execution dans un emulateur
Root/jailbreak+200Appareil modifie

Signaux Comportementaux

SignalImpactDescription
Montant inhabituel+100-200En dehors de la plage normale
Heure inhabituelle+50-100Transaction tard dans la nuit
Velocite depassee+200-400Trop de tentatives
Nouveau destinataire+50Premier transfert vers ce destinataire

Utiliser les Scores de Risque

Seuils de Decision

Configurez des seuils pour des decisions automatisees :
const SEUILS = {
  APPROBATION_AUTO: 300,    // Score <= 300 : approbation automatique
  REVISION_MANUELLE: 600,   // 301-600 : mise en file d'attente pour revision
  REFUS_AUTO: 800           // Score > 800 : refus automatique
};

function prendreDecision(scoreRisque) {
  if (scoreRisque <= SEUILS.APPROBATION_AUTO) {
    return 'approuver';
  } else if (scoreRisque <= SEUILS.REVISION_MANUELLE) {
    return 'reviser';
  } else {
    return 'refuser';
  }
}

Regles Personnalisees

Creez des regles qui ajustent les scores selon votre logique metier :
// Creer une regle personnalisee
await txcloud.fraud.rules.create({
  name: 'Nouvel Utilisateur Haute Valeur',
  condition: 'user.age_days < 7 AND transaction.amount > 10000',
  action: 'review',
  score_adjustment: 200  // Ajouter 200 au score de risque
});

Explications des Scores

Fournissez toujours du contexte pour vos decisions :
const verification = await txcloud.identity.verify({ ... });

// Obtenir une explication lisible par l'humain
const explication = verification.risk_factors
  .map(f => `${f.code}: +${f.weight} points`)
  .join('\n');

console.log('Facteurs de Risque:');
console.log(explication);
// Sortie:
// Facteurs de Risque:
// new_device: +50 points
// vpn_detected: +150 points
// unusual_time: +75 points

Bonnes Pratiques

Commencez avec des seuils stricts et assouplissez en collectant des donnees :
  • Semaine 1-2 : Revision manuelle au score > 400
  • Semaine 3-4 : Analysez le taux de faux positifs
  • Semaine 5+ : Ajustez les seuils selon les donnees
Ne vous fiez pas uniquement au score - considerez :
  • L’historique utilisateur
  • Le type de transaction
  • Le contexte metier
  • La sensibilite temporelle
Stockez les scores de risque et les facteurs pour :
  • Les audits de conformite
  • L’amelioration des modeles
  • La resolution des litiges
Suivez votre distribution de scores dans le temps :
  • Des pics soudains peuvent indiquer des attaques
  • Des changements graduels peuvent indiquer une derive du modele

Analytics

Suivez vos metriques de risque dans le tableau de bord :
const analytics = await txcloud.transactions.analytics.summary({
  period: '30d'
});

console.log('Distribution des Risques:', analytics.risk_distribution);
// { low: 85000, medium: 12000, high: 2500, critical: 500 }

console.log('Taux de Fraude:', analytics.fraud.fraud_rate);
// 0.00036 (0.036%)

Voir le Tableau de Bord Analytics

Accedez aux analytics de risque detailles dans votre tableau de bord