SEONConnecteurStable

Submit fraud feedback (SEON)

Transmet à SEON le résultat réellement observé d’une transaction afin d’alimenter la boucle d’apprentissage et la qualité future des décisions antifraude.

Type de retour

Transmettre un retour d’information fraude (SEON)

Label SEON

Statut du feedback

Vue d’ensemble

Une décision antifraude n’est qu’une prédiction au moment de l’action. Ce node ferme la boucle lorsque le résultat réel devient connu : fraude confirmée, activité légitime, chargeback ou faux positif.

Soumettez le feedback lorsque vous disposez d’un résultat suffisamment fiable, pas immédiatement après le scoring.
Utilisez une référence de source stable pour rattacher le feedback à une preuve ou à un événement métier.
Le feedback améliore la donnée disponible côté SEON mais ne modifie pas rétroactivement vos objets ou décisions Ormuz.

Scénario type

Plusieurs jours après un paiement approuvé, un chargeback est reçu. Le processus retrouve la transaction SEON depuis le paiement ou la sortie conservée, soumet feedback_type = chargeback, renseigne l’identifiant du chargeback comme source_reference et conserve le label retourné pour l’audit.

Prise en main

Le mode recommandé consiste à transmettre directement la transaction SEON et un résultat observé clairement qualifié.

Cible

Reliez seon_transaction à la transaction évaluée. À défaut, utilisez le même subject et la même configuration SEON.

Résultat

Choisissez feedback_type selon le résultat réellement confirmé, puis précisez fraud_category si votre taxonomie le permet.

Traçabilité

Renseignez occurred_at avec la date du fait observé et source_reference avec une référence stable de preuve.

Exemple de configuration

Paramètre	Binding	Rôle
`extension_config_id`	`seon_config_id`	Configuration de l’évaluation initiale
`seon_transaction`	`assess_fraud.seon_transaction`	Transaction à labelliser
`feedback_type`	`chargeback`	Résultat réellement observé
`source_reference`	`chargeback.id`	Preuve et traçabilité
`occurred_at`	`chargeback.created_at`	Date du résultat observé

Attention Concevez le processus pour envoyer un feedback une seule fois par résultat métier. source_reference est transmise à SEON, mais le node n’effectue pas lui-même de déduplication locale.

Exemple de processus

Chargeback confirmé

Transmettre un retour d’information fraude (SEON)

Conserver le feedback

Lorsqu’un résultat réel est confirmé, retrouver la transaction évaluée, soumettre le feedback à SEON puis conserver le statut retourné.

Résolution des données

La transaction ciblée est résolue selon la même priorité que pour Get transaction (SEON).

Priorité	Source	Usage recommandé
1	`seon_transaction.id`	Transaction conservée depuis l’évaluation ou une relecture.
2	`transaction_reference`	Référence directe connue par l’intégration.
3	`subject`	Association créée lors de l’évaluation initiale avec la même configuration.

Paramètres 9

Transaction ciblée

Configuration et moyens alternatifs de retrouver la transaction.

extension_config_idRequisref(extension_config:seon)

Configuration SEON active utilisée pour soumettre le feedback. Utilisez la même configuration que celle ayant évalué la transaction.

seon_transactionOptionnelSeon transaction

Transaction retournée par Assess fraud (SEON) ou Get transaction (SEON). Son identifiant est prioritaire pour cibler le feedback.

subjectOptionnelobject

Objet métier évalué à l’origine. Il permet de retrouver la transaction lorsque son association a été créée avec la même configuration SEON.

transaction_referenceOptionnelstring

Identifiant ou référence directe utilisable pour cibler la transaction SEON lorsque les objets précédents ne sont pas disponibles.

Résultat observé

Qualification métier du résultat transmis à SEON.

feedback_typeRequisenum

Résultat observé à transmettre à SEON.

Valeur	Quand l’utiliser
`fraud`	La transaction ou l’activité a été confirmée comme frauduleuse.
`legitimate`	L’activité a été confirmée comme légitime.
`chargeback`	Un chargeback lié à la transaction a été constaté.
`false_positive`	Une décision négative ou une alerte s’est révélée injustifiée.
`other`	Résultat connu mais non couvert par les catégories précédentes.

fraud_categoryOptionnelstring

Catégorie métier plus précise, par exemple fraude au paiement, usurpation de compte ou abus promotionnel. Renseignez-la lorsque votre taxonomie et SEON peuvent l’exploiter.

occurred_atOptionneldatetime

Date et heure auxquelles le résultat a réellement été observé. Si elle est absente, la date de soumission est utilisée.

Traçabilité

Contexte complémentaire utile à l’audit et au rapprochement avec vos événements métier.

commentOptionnelstring

Commentaire de contexte destiné au suivi du feedback. Évitez d’y placer des données personnelles ou sensibles non nécessaires.

source_referenceOptionnelstring

Référence stable de la preuve ou de l’événement ayant déclenché le feedback, par exemple un identifiant de chargeback, de revue ou de dossier interne.

Sorties 3

Confirmation du feedback

Résultat à conserver pour le suivi et l’audit.

seon_labelSeon label

Label SEON normalisé, avec l’identifiant retourné, la transaction ciblée, le type de feedback et la réponse provider.

feedback_statusstring

Statut normalisé retourné par SEON. Lorsque le provider ne fournit pas de statut explicite, la valeur est submitted.

submitted_atdatetime

Date et heure auxquelles Ormuz a soumis le feedback à SEON.

Comportement

Résoudre la transaction

Le node utilise la transaction SEON, la référence explicite ou l’association de l’objet métier.

Construire le feedback

Le résultat observé, la catégorie, le commentaire, la date et la référence source sont préparés pour SEON.

Appliquer la date par défaut

Lorsque occurred_at n’est pas fourni, la date de soumission est utilisée comme date du résultat.

Soumettre et confirmer

SEON reçoit le label et Ormuz expose l’objet seon_label, le statut normalisé et submitted_at.

Limites et responsabilités

Le node ne détermine pas automatiquement si une transaction est frauduleuse ou légitime : cette qualification doit provenir d’un résultat métier fiable.
Il ne modifie pas la décision initiale, la commande, le paiement, le client ou un autre objet métier Ormuz.
Il ne garantit pas la déduplication de plusieurs soumissions portant sur le même résultat.
Une source_reference stable facilite le rapprochement, mais le processus reste responsable de n’envoyer qu’un feedback pertinent.
Les commentaires et catégories doivent respecter votre politique de minimisation des données.

Résolution des problèmes

Transaction introuvable

Passez directement seon_transaction ou vérifiez que le sujet et la configuration correspondent à l’évaluation initiale.

Feedback envoyé plusieurs fois

Ajoutez une garde métier dans le processus et utilisez une source_reference stable liée à l’événement observé.

Date du résultat incorrecte

Renseignez occurred_at avec la date de la fraude, du chargeback ou de la revue. Sans valeur, la date de soumission est utilisée.

Type de feedback incertain

Utilisez false_positive pour une alerte injustifiée, legitimate pour une activité confirmée comme normale et other seulement lorsqu’aucune catégorie standard ne convient.