Bewertungen mit Transaktionsereignissen annotieren

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

Für eine optimale Leistung benötigt der Transaktionsschutz Einblick in die Ereignisse des Zahlungslebenszyklus für Transaktionen. Wir empfehlen daher, Anmerkungen für die mit Transaktionsdaten erstellten Bewertungen zu senden. Sie können die Transaktionsinformationen beispielsweise als Transaktionsereignis in den folgenden Szenarien an Transaction Defense senden:

  • Der Zahlungsanbieter akzeptiert oder lehnt die Transaktion ab.

  • Der Händler erstattet den Betrag.

  • Der Zahlungsaussteller reicht eine Erstattung ein.

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

Wir empfehlen, diese Anfragen automatisch im Rahmen 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 Analyse mit eingeschlossenen Transaktionsdaten erstellt haben, gibt Transaction Defense ein Ergebnis und einen Analysenamen zurück. Annotieren Sie die Bewertung mit Transaktionsereignissen in den folgenden wichtigen Phasen des Zahlungslebenszyklus, wenn sie eintreten:

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 Wenn Sie die zu verarbeitende Transaktion einreichen 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 (für eine teilweise Rückbuchung von 20 Währungseinheiten)

Geben Sie zusammen mit dem Ereignistyp CHARGEBACK den vom Kartenaussteller angegebenen Rückbuchungsgrundcode über das Feld reason an. Geben Sie außerdem den zurückgebuchten Betrag im Feld value an, wenn die Transaktion teilweise zurückgebucht wurde.

Fügen Sie im Feld „Transaktionsereignis“ reason entweder erläuternde Begriffe ein, um mehr Kontext zum Grund für das Ereignis zu liefern, oder geben Sie Grundcodes an, die direkt vom Zahlungsnetzwerk oder vom Kartenaussteller stammen. Diese Begriffe und Codes unterscheiden sich je nach Ereignistyp.

In der folgenden Tabelle finden Sie die vollständige Liste der Transaktionsereignistypen:

Grund für die Anmerkung Beschreibung
MERCHANT_APPROVE Gibt an, dass die Transaktion vom Händler genehmigt wurde. Die entsprechenden Gründe können Begriffe wie IN_HOUSE, ACCERTIFY, CYBERSOURCE oder MANUAL_REVIEW enthalten.
MERCHANT_DENY Gibt an, dass die Transaktion aufgrund von Risiken, die vom Händler erkannt wurden, abgelehnt und abgeschlossen wurde. Die entsprechenden Gründe können Begriffe wie IN_HOUSE, ACCERTIFY, CYBERSOURCE oder MANUAL_REVIEW enthalten.
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 der Autorisierungsversuch beim Kartenaussteller fehlgeschlagen ist. Die entsprechenden Gründe können unter anderem 54 von Visa sein, was darauf hindeutet, dass die Karte abgelaufen ist, oder 82, was darauf hindeutet, dass die CVV falsch ist.
PAYMENT_CAPTURE Gibt an, dass die Transaktion abgeschlossen ist, weil die Zahlung erfolgt ist.
PAYMENT_CAPTURE_DECLINE Gibt an, dass die Transaktion nicht abgeschlossen werden konnte, weil die Zahlung nicht erfolgt ist.
CANCEL Gibt an, dass die Transaktion storniert wurde. Geben Sie den Grund für die Kündigung an. Beispiel: INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Gibt an, dass der Händler aufgrund von Betrug eine Rückbuchungsanfrage für die Transaktion erhalten hat, in der zusätzliche Informationen angefordert werden, bevor eine Betrugsrückbuchung offiziell ausgestellt und eine formelle Rückbuchungsbenachrichtigung gesendet wird.
CHARGEBACK_ALERT Gibt an, dass der Händler aufgrund von Betrug eine Rückbuchungsbenachrichtigung für die Transaktion erhalten hat. Das Verfahren zur Beilegung des Streitfalls ohne Einbeziehung des Zahlungsnetzwerks wird eingeleitet.
FRAUD_NOTIFICATION Gibt an, dass für die Transaktion eine Betrugsbenachrichtigung ausgestellt wurde, die 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 aufzunehmen. Bei teilweisen Rückbuchungen empfehlen wir, im Feld value einen Betrag anzugeben.
CHARGEBACK Gibt an, dass der Händler vom Zahlungsnetzwerk darüber informiert wird, dass die Transaktion aufgrund von Betrug in das Rückbuchungsverfahren eingetreten ist. Beispiele für Grundcodes sind 6005 und 6041 von Discover. Bei teilweisen Rückbuchungen empfehlen wir, im Feld value einen Betrag anzugeben.
CHARGEBACK_REPRESENTMENT Gibt an, dass die Transaktion aufgrund von Betrug in das Chargeback-Verfahren eingetreten ist und der Händler sich für die erneute Einreichung entschieden hat. Beispiele für Gründe sind 6005 und 6041 in Discover. Bei teilweisen Rückbuchungen empfehlen wir, im Feld value einen Betrag anzugeben.
CHARGEBACK_REVERSE Gibt an, dass für die Transaktion ein betrügerischer Chargeback vorlag, der unrechtmäßig war und daher rückgängig gemacht wurde. Bei teilweisen Rückbuchungen empfehlen wir, im Feld value einen Betrag anzugeben.
REFUND_REQUEST Gibt an, dass der Händler eine Erstattung für eine abgeschlossene Transaktion erhalten hat. Bei Teilerstattungen empfehlen wir, im Feld value einen Betrag anzugeben. Beispiel für Grund: FRAUD.
REFUND_DECLINE Gibt an, dass der Händler einen Erstattungsantrag für diese Transaktion erhalten, ihn jedoch abgelehnt hat. Bei Teilerstattungen empfehlen wir, im Feld value einen Betrag anzugeben. Beispiel für Grund: FRAUD.
REFUND Gibt an, dass die abgeschlossene Transaktion vom Händler erstattet wurde. Bei Teilerstattungen empfehlen wir, im Feld value einen Betrag anzugeben. Beispiel für Grund: PROACTIVE_FRAUD.
REFUND_REVERSE Gibt an, dass die abgeschlossene Transaktion vom Händler erstattet und diese Erstattung rückgängig gemacht wurde. Bei Teilerstattungen empfehlen wir, im Feld value einen Betrag anzugeben.

Das folgende Beispiel zeigt eine Beispielnutzlast für Anmerkungen mit einem Transaktionsereignis. Weitere Informationen finden Sie unter Bewertungen annotieren.

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

Nächste Schritte