Annoter les évaluations avec des événements de transaction

Les annotations d'événements de transaction dans Fraud Defense vous permettent de fournir des données de cycle de vie des paiements post-évaluation, telles que les règlements, les débits compensatoires et les remboursements. Ces commentaires vous aident à affiner votre modèle spécifique au site et à améliorer les futurs verdicts de fraude.

Pour de meilleures performances, Transaction defense a besoin de visibilité sur les événements de cycle de vie des paiements pour les transactions. Par conséquent, nous vous recommandons d'envoyer des annotations pour les évaluations que vous avez créées avec des données de transaction. Par exemple, vous pouvez fournir les informations de transaction à Transaction defense en tant qu'événement de transaction dans les scénarios suivants :

  • Le fournisseur de services de paiement accepte ou refuse la transaction.

  • Le marchand émet un remboursement.

  • L'émetteur du paiement demande un remboursement.

Pour en savoir plus sur l'envoi d'annotations, consultez Annoter des évaluations.

Nous vous recommandons d'effectuer ces requêtes automatiquement dans le cadre de la logique correspondante de votre système lorsque les données sont disponibles, par exemple lorsque l'état d'une transaction change.

Une fois que vous avez créé une évaluation incluant des données de transaction, Transaction defense renvoie un verdict et un nom d'évaluation. Annotez l'évaluation avec les événements de transaction aux étapes importantes suivantes du cycle de vie du paiement lorsqu'ils se produisent :

Type d'événement Description Exemple de motif Exemple de valeur
MERCHANT_APPROVE | MERCHANT_DENY Cas où vous décidez si la transaction doit être autorisée ou non. IN_HOUSE N/A
AUTHORIZATION | AUTHORIZATION_DECLINE Cas où vous envoyez la transaction à traiter et où l'émetteur de la carte décide de l'autoriser ou non. 82 (un code de motif indiquant que le CVV était incorrect) N/A
CHARGEBACK Cas où la transaction est rejetée. Card Reported Stolen 20 (représentant un rejet de débit partiel de 20 unités de devise)

En plus du type d'événement CHARGEBACK, incluez le code de motif de rejet de débit fourni par l'émetteur de la carte à l'aide du champ reason. Incluez également le montant monétaire rejeté dans le champ value si la transaction a été partiellement rejetée.

Dans le champ reason de l'événement de transaction, incluez des termes explicatifs pour fournir plus de contexte sur la raison de l'événement, ou fournissez des codes de motif obtenus directement auprès du réseau de paiement ou de l'émetteur de la carte. Ces termes et codes diffèrent selon le type d'événement.

Le tableau suivant présente la liste complète des types d'événements de transaction :

Motif de l'annotation Description
MERCHANT_APPROVE Indique que la transaction est approuvée par le marchand. Les raisons associées peuvent inclure des termes tels que IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MERCHANT_DENY Indique que la transaction est refusée et conclue en raison de risques détectés par le marchand. Les raisons associées peuvent inclure des termes tels que IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MANUAL_REVIEW Indique que la transaction est en cours d'évaluation par un humain en raison d'un soupçon ou d'un risque.
AUTHORIZATION Indique que la tentative d'autorisation auprès de l'émetteur de la carte a réussi.
AUTHORIZATION_DECLINE Indique que la tentative d'autorisation auprès de l'émetteur de la carte a échoué. Les raisons associées peuvent inclure le code 54 de Visa, qui indique que la carte a expiré, ou le code 82, qui indique que le CVV est incorrect.
PAYMENT_CAPTURE Indique que la transaction est terminée, car les fonds ont été réglés.
PAYMENT_CAPTURE_DECLINE Indique que la transaction n'a pas pu être finalisée, car les fonds n'ont pas été réglés.
CANCEL Indique que la transaction est annulée. Indiquez le motif de l'annulation. Par exemple, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Indique que le marchand a reçu une demande de rejet de débit pour fraude concernant la transaction, demandant des informations supplémentaires avant qu'un rejet de débit pour fraude ne soit officiellement émis et qu'une notification de rejet de débit formelle ne soit envoyée.
CHARGEBACK_ALERT Indique que le marchand a reçu une alerte de rejet de débit pour fraude concernant la transaction. La procédure de résolution du litige sans l'intervention du réseau de paiement est lancée.
FRAUD_NOTIFICATION Indique qu'une notification de fraude est émise pour la transaction, envoyée par la banque émettrice de l'instrument de paiement, car la transaction semble frauduleuse. Nous vous recommandons d'inclure des données TC40 ou SAFE dans le champ reason pour ce type d'événement. Pour les rejets de débit partiels, nous vous recommandons d'inclure un montant dans le champ value.
CHARGEBACK Indique que le marchand est informé par le réseau de paiement que la transaction est entrée dans le processus de rétrofacturation en raison d'une fraude. Les codes de motif incluent par exemple 6005 et 6041 de Discover. Pour les rejets de débit partiels, nous vous recommandons d'inclure un montant dans le champ value.
CHARGEBACK_REPRESENTMENT Indique que la transaction est entrée dans le processus de rejet de débit pour cause de fraude et que le marchand a choisi de contester le rejet de débit. Par exemple, les raisons 6005 et 6041 de Discover. Pour les rejets de débit partiels, nous vous recommandons d'inclure un montant dans le champ value.
CHARGEBACK_REVERSE Indique que la transaction a fait l'objet d'un rejet de débit pour fraude illégitime, qui a donc été annulé. Pour les rejets de débit partiels, nous vous recommandons d'inclure un montant dans le champ value.
REFUND_REQUEST Indique que le marchand a reçu un remboursement pour une transaction finalisée. Pour les remboursements partiels, nous vous recommandons d'inclure un montant dans le champ value. Exemple de motif : FRAUD.
REFUND_DECLINE Indique que le marchand a reçu une demande de remboursement pour cette transaction, mais qu'il l'a refusée. Pour les remboursements partiels, nous vous recommandons d'inclure un montant dans le champ value. Exemple de motif : FRAUD.
REFUND Indique que la transaction finalisée a été remboursée par le marchand. Pour les remboursements partiels, nous vous recommandons d'inclure un montant dans le champ value. Exemple de motif : PROACTIVE_FRAUD.
REFUND_REVERSE Indique que la transaction finalisée a été remboursée par le marchand et que ce remboursement a été annulé. Pour les remboursements partiels, nous vous recommandons d'inclure un montant dans le champ value.

L'exemple suivant montre un exemple de charge utile d'annotation contenant un événement de transaction. Pour en savoir plus, consultez Annoter des évaluations.

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
{
  "transaction_event": {
    "event_type": "CHARGEBACK",
    "reason": "Card Reported Stolen",
    "value": 20
  }
}

Étapes suivantes