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

Cette page explique comment annoter les évaluations avec des événements de transaction pour les affiner votre modèle spécifique à votre site.

Pour optimiser les performances, la prévention des fraudes de reCAPTCHA a besoin de visibilité dans les événements de cycle de vie des paiements pour les transactions. Par conséquent, nous vous recommandons 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 à la détection des fraudes reCAPTCHA 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 dépose un remboursement.

Pour savoir comment envoyer des annotations, consultez Annoter les évaluations.

Nous vous recommandons d'effectuer ces demandes automatiquement lors du la logique correspondante dans votre système lorsque les données sont disponibles, par exemple lorsque l'état d'une transaction change.

Après avoir créé une évaluation avec des données de transaction incluses, La prévention des fraudes de reCAPTCHA renvoie un verdict et une nom de l'évaluation. Annotez l'évaluation avec des événements de transaction aux étapes importantes suivantes du cycle de vie des paiements 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 Lorsque vous envoyez la transaction à traiter et que l'émetteur de la carte décide d'autoriser ou non la transaction. 82 (code de motif indiquant que le CVC était incorrect) N/A
CHARGEBACK Cas où la transaction est rejetée. Card Reported Stolen 20 (correspondant à un rejet 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 les montant monétaire remboursé dans le champ value si la transaction a été être partiellement rechargés.

Dans le champ reason de l'événement de transaction, incluez des termes de clarification pour fournir plus de contexte sur le motif 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. Les présentes Conditions d'utilisation et différents selon le type d'événement.

Le tableau suivant spécifie 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. La les motifs qui l'accompagnent 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 des risques détectés par le marchand. Les motifs associés peuvent inclure des termes tels que en tant que IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MANUAL_REVIEW Indique que la transaction est évaluée 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é. La les motifs correspondants peuvent inclure l'54 de Visa indiquant que la carte est expiré ou 82 indiquant que le CVV est incorrect.
PAYMENT_CAPTURE Indique que la transaction a été effectuée, car les fonds ont été sont réglées.
PAYMENT_CAPTURE_DECLINE Indique que la transaction n'a pas pu être finalisée, car les fonds n'ont pas été soldé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 pour la transaction, en demandant des informations supplémentaires avant qu'une fraude un rejet de débit est émis officiellement et une notification officielle envoyé.
CHARGEBACK_ALERT Indique que le marchand a reçu une alerte de rejet de débit pour fraude pour la transaction. Le processus de résolution du litige sans impliquer le réseau de paiement est lancé.
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 indiquez un montant dans le champ value.
CHARGEBACK Indique que le marchand est informé par le réseau de paiement que la transaction a été soumise au processus de rejet de débit en raison de fraude. Voici quelques exemples de codes de motif : 6005 et 6041 de Discover. Pour les rejets partiels, nous vous recommandons d'inclure un montant dans le champ value.
CHARGEBACK_REPRESENTMENT Indique que la transaction a été soumise au processus de rejet de débit en raison d'une fraude et que le marchand a choisi de procéder à une demande de remboursement. Exemples de raisons : 6005 et 6041 de Discover. Pour les rejets partiels, nous vous recommandons d'inclure un montant dans le champ value.
CHARGEBACK_REVERSE Indique qu'un rejet frauduleux a été effectué pour la transaction, ce qui a entraîné son annulation. Pour les rejets 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 terminé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 cet article transaction, mais qu'il l'a refusée. Pour les remboursements partiels, nous nous vous recommandons d'indiquer un montant dans le champ value. Exemple de motif : FRAUD.
REFUND Indique que la transaction terminée a été remboursée par le marchand. Pour Pour les remboursements partiels, nous vous recommandons d'indiquer un montant dans le value . Exemple de motif: PROACTIVE_FRAUD.
REFUND_REVERSE indique que la transaction terminée a été remboursée par le marchand ; que ce remboursement a été annulé. Pour les remboursements partiels, nous vous recommandons d'inclure un montant dans le champ value.

L'exemple suivant présente un exemple de charge utile d'annotation contenant une 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
  }
}

Étape suivante