Anti-fraude

SOAMTAR intègre un moteur de scoring fraude qui s'exécute avant l'envoi de la demande de paiement à Orange Money. Cette page explique ce que vous, marchand, pouvez voir et configurer. Les règles internes, les seuils et les signaux ne sont pas exposés publiquement afin de préserver leur efficacité.

Pipeline de scoring

POST /payments
   |
   v
[ Validation métier ]      limites marchand, KYC, devise
   |
   v
[ Risk scoring ]           règles internes confidentielles
   |
   |-- allow   : demande envoyée à Orange Money
   |-- review  : transaction créée + flagged, attente de revue
   '-- block   : transaction refusée (422)

Le score et les signaux déclenchés sont stockés pour audit interne. Vous voyez le résultat (allow / review / block) et la décision appliquée, pas les règles qui l'ont produit.

Catégories de signaux

À titre illustratif, sans divulgation des règles précises, le scoring couvre :

• Velocity (fréquence des tentatives par payeur)
• Blacklist et listes de sanctions
• Géolocalisation IP
• Device fingerprinting
• Patterns de montants
• Historique du payeur chez ce marchand

Configuration marchand

Dashboard → Sécurité → Anti-fraude

Vous pouvez :

• Ajouter une blacklist marchand (téléphones, emails)
• Ajouter une whitelist marchand (bypass scoring sur un payeur de confiance)
• Définir des seuils de montant au-delà desquels une revue manuelle est requise côté marchand
• Recevoir les alertes en temps réel par email ou webhook

Les règles plateforme restent appliquées en complément et ne peuvent pas être désactivées par le marchand.

Réagir à une transaction flagged

Quand une transaction passe en is_flagged = true, vous recevez un événement dédié (si vous y êtes abonné). Workflow recommandé :

1. Mettre la commande en statut "review" dans votre système
2. Notifier votre équipe ops / risk
3. Décider : accepter ou refuser côté dashboard
4. La décision est propagée automatiquement à l'état de la transaction

Litiges

Un taux de disputes élevé entraîne une mise en revue manuelle, puis une suspension automatique si le seuil de tolérance est dépassé. Les seuils précis dépendent de votre profil d'activité et sont communiqués à l'onboarding.

Pour rester sous le seuil :

• Reçus automatiques par SMS et email à chaque succès
• Politique de remboursement claire et accessible (lien dans le checkout)
• Logs de livraison des services horodatés (preuve en cas de dispute)
• Intégration payer.email systématique

Monitoring

Dashboard → Analytics → Anti-fraude

• Taux de transactions flagged / blocked / disputées
• Heatmap des heures à risque (heure de Freetown)
• Liste des payeurs récurrents flagged

Reporting d'incident

Vous suspectez une fraude active :

• Bloquer immédiatement le payeur via le dashboard
• Email au support avec les références concernées
• SOAMTAR traite les signalements sous les délais annoncés dans le support