Bewertungen mit Transaktionsereignissen annotieren

Auf dieser Seite wird beschrieben, wie Sie Bewertungen mit Transaktionsereignissen annotieren, um Ihr standortspezifisches Modell zu optimieren.

Für eine optimale Leistung benötigt reCAPTCHA Fraud Prevention Sichtbarkeit Zahlungslebenszyklus-Ereignisse für Transaktionen. Daher empfehlen wir Ihnen, Anmerkungen zu den Bewertungen zu senden, die Sie mit Transaktionsdaten erstellt haben. Für können Sie die Transaktionsinformationen reCAPTCHA Fraud Prevention als Transaktionsereignis im folgende Szenarien:

  • Der Zahlungsdienstleister akzeptiert oder lehnt die Transaktion ab.

  • Der Händler veranlasst eine Erstattung.

  • Der Zahlungsaussteller beantragt eine Erstattung.

Weitere Informationen zum Senden von Anmerkungen finden Sie unter Bewertungen mit Anmerkungen versehen.

Wir empfehlen, diese Anfragen automatisch als Teil der entsprechenden Logik in Ihrem System zu stellen, wenn die Daten verfügbar sind, z. B. wenn sich der Status einer Transaktion ändert.

Nachdem Sie eine Bewertung mit Transaktionsdaten erstellt haben, reCAPTCHA Fraud Prevention gibt ein Ergebnis und eine Name der Prüfung. Fügen Sie der Bewertung bei den folgenden wichtigen Phasen des Zahlungszyklus Transaktionsereignisse hinzu, wenn sie auftreten:

Ereignistyp Beschreibung Beispiel für Grund Beispiel für Wert
MERCHANT_APPROVE | MERCHANT_DENY Wenn Sie entscheiden, ob die Transaktion fortgesetzt werden darf. IN_HOUSE
AUTHORIZATION | AUTHORIZATION_DECLINE Wann du die zu verarbeitende Transaktion einreichst und der Kartenaussteller entscheidet, ob die Transaktion fortgesetzt werden darf. 82 (Ursachencode für falsche CVV)
CHARGEBACK Wenn die Transaktion zurückgebucht wird. Card Reported Stolen 20 (eine teilweise Rückbuchung von 20 Währungseinheiten)

Geben Sie neben dem Ereignistyp CHARGEBACK den Code für den Grund der Rückbuchung an, wurde vom Kartenaussteller mithilfe des Felds reason angegeben. Fügen Sie außerdem den Geldbetrag im Feld value zurückgebucht, falls die Transaktion war teilweise rückgebucht.

Geben Sie im Feld „reason“ des Transaktionsereignisses klärende Bedingungen an, mehr Kontext zum Grund des Ereignisses geben oder Ursachencodes angeben, die werden direkt vom Zahlungsnetzwerk oder Kartenaussteller bezogen. Diese Nutzungsbedingungen und unterscheiden sich je nach Ereignistyp.

In der folgenden Tabelle ist die vollständige Liste der Transaktionsereignistypen aufgeführt:

Grund für Anmerkung Beschreibung
MERCHANT_APPROVE Gibt an, dass die Transaktion vom Händler genehmigt wurde. Die begleitenden Gründe können Begriffe wie IN_HOUSE, ACCERTIFY, CYBERSOURCE oder MANUAL_REVIEW enthalten.
MERCHANT_DENY Zeigt an, dass die Transaktion aufgrund von Risiken abgelehnt und abgeschlossen wurde die vom Händler erkannt wurden. Zu den damit verbundenen Gründen können Begriffe gehören wie als IN_HOUSE, ACCERTIFY, CYBERSOURCE oder MANUAL_REVIEW.
MANUAL_REVIEW Gibt an, dass die Transaktion aufgrund von Verdacht oder Risiko von einem Mitarbeiter überprüft wird.
AUTHORIZATION Gibt an, dass der Autorisierungsversuch beim Kartenaussteller erfolgreich war.
AUTHORIZATION_DECLINE Gibt an, dass die Autorisierung beim Kartenaussteller fehlgeschlagen ist. Zu den begleitenden Gründen kann der Visa-Code 54 gehören, der angibt, dass die Karte abgelaufen ist, oder 82, der angibt, dass die CVV falsch ist.
PAYMENT_CAPTURE Gibt an, dass die Transaktion abgeschlossen ist, da die Zahlung erfolgt ist.
PAYMENT_CAPTURE_DECLINE Gibt an, dass die Transaktion nicht abgeschlossen werden konnte, da die Zahlung nicht ausgeführt wurde.
CANCEL Gibt an, dass die Transaktion abgebrochen wurde. Geben Sie den Grund für die Kündigung an. Beispiel: INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Gibt an, dass der Händler eine Anfrage zu einer Rückbuchung aufgrund von Betrug für die Transaktion erhalten hat. Es werden zusätzliche Informationen angefordert, bevor eine offizielle Rückbuchung aufgrund von Betrug veranlasst und eine formelle Rückbuchungsbenachrichtigung gesendet wird.
CHARGEBACK_ALERT Gibt an, dass der Händler eine Benachrichtigung zu einer Rückbuchung aufgrund von Betrug für die Transaktion erhalten hat. Die Beilegung des Streitfalls ohne Einbeziehung des Zahlungsnetzwerks wird eingeleitet.
FRAUD_NOTIFICATION Gibt an, dass für die Transaktion eine Betrugsbenachrichtigung von der ausstellenden Bank des Zahlungsmittels gesendet wurde, da die Transaktion betrügerisch erscheint. Wir empfehlen, für diesen Ereignistyp TC40- oder SAFE-Daten in das Feld reason einzugeben. Bei teilweisen Rückbuchungen empfehlen wir, einen Betrag im Feld value anzugeben.
CHARGEBACK Gibt an, dass der Händler vom Zahlungsnetzwerk darüber informiert wurde, dass der Transaktion wegen Betrugs in den Rückbuchungsprozess eingereist ist. Ursachencode Beispiele sind 6005 und 6041 von Discover. Bei teilweisen Rückbuchungen empfehlen, einen Betrag in das Feld value einzugeben.
CHARGEBACK_REPRESENTMENT Gibt an, dass die Transaktion aufgrund von Betrug in den Prozess der Rückbuchung eingetreten ist und der Händler eine Neuausstellung beantragt hat. Beispiele für Gründe sind 6005 und 6041 von Discover. Bei teilweisen Rückbuchungen empfehlen wir, einen Betrag im Feld value anzugeben.
CHARGEBACK_REVERSE Gibt an, dass für die Transaktion eine betrügerische Rückbuchung erfolgt ist, die unrechtmäßig war und daher rückgängig gemacht wurde. Bei teilweisen Rückbuchungen empfehlen wir, einen Betrag im Feld value anzugeben.
REFUND_REQUEST Gibt an, dass der Händler eine Erstattung für eine abgeschlossene Transaktion erhalten hat. Bei teilweisen Erstattungen empfehlen wir, einen Betrag im Feld value anzugeben. Beispiel für den Grund: FRAUD.
REFUND_DECLINE Gibt an, dass der Händler einen Erstattungsantrag für diese Transaktion erhalten, ihn aber abgelehnt hat. Bei teilweisen Erstattungen empfehlen, einen Betrag in das Feld value einzugeben. Beispiel für Grund: FRAUD
REFUND Gibt an, dass die abgeschlossene Transaktion vom Händler erstattet wurde. Bei teilweisen Erstattungen empfehlen wir, einen Betrag im Feld value anzugeben. Beispiel für einen Grund: PROACTIVE_FRAUD.
REFUND_REVERSE Gibt an, dass die abgeschlossene Transaktion vom Händler erstattet wurde, und dass die Erstattung rückgängig gemacht wurde. Bei teilweisen Erstattungen empfehlen wir, einen Betrag im Feld value anzugeben.

Das folgende Beispiel zeigt eine Beispiel-Annotationsnutzlast, die eine Transaktion enthält. . Weitere Informationen finden Sie unter Bewertungen mit Anmerkungen versehen.

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

Nächste Schritte

  • Weitere Informationen zu den Schutzfunktionen für Nutzerkonten finden Sie hier.