Bewertungen mit Transaktionsereignissen annotieren

Mit Anmerkungen zu Transaktionsereignissen in Fraud Defense können Sie Daten zum Zahlungslebenszyklus nach der Bewertung angeben, z. B. Abrechnungen, Rückbuchungen und Erstattungen. Dieses Feedback hilft Ihnen, Ihr Website-spezifisches Modell zu optimieren und zukünftige Betrugsentscheidungen zu verbessern.

Für eine optimale Leistung benötigt Transaction Defense Einblick in die Zahlungs-Lifecycle-Events für Transaktionen. Daher empfehlen wir, Annotationen für die Bewertungen zu senden, die Sie mit Transaktionsdaten erstellt haben. In den folgenden Szenarien können Sie die Transaktionsinformationen beispielsweise als Transaktionsereignis an Transaction Defense senden:

  • Der Zahlungsdienstleister akzeptiert die Transaktion oder lehnt sie ab.

  • Der Händler veranlasst eine Erstattung.

  • Der Aussteller der Zahlungsmethode beantragt eine Erstattung.

Weitere Informationen zum Senden von Annotationen finden Sie unter Bewertungen annotieren.

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, gibt Transaction Defense ein Ergebnis und einen Bewertungsnamen zurück. Fügen Sie der Bewertung Transaktionsereignisse in den folgenden wichtigen Phasen des Zahlungslebenszyklus hinzu, wenn sie auftreten:

Ereignistyp Beschreibung Beispiel für Grund Beispielwert
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 (steht für eine teilweise Rückbuchung von 20 Währungseinheiten)

Geben Sie zusammen mit dem Ereignistyp CHARGEBACK den vom Kartenaussteller bereitgestellten Grundcode für die Rückbuchung im Feld reason an. Geben Sie außerdem den zurückgebuchten Geldbetrag im Feld value an, wenn die Transaktion teilweise zurückgebucht wurde.

Geben Sie im Feld reason des Transaktionsereignisses entweder klärende Begriffe an, um mehr Kontext zum Grund für das Ereignis zu liefern, oder geben Sie Ursachencodes an, die direkt vom Zahlungsnetzwerk oder 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 Annotation Beschreibung
MERCHANT_APPROVE Gibt an, dass die Transaktion vom Händler genehmigt wurde. Die zugehörigen Gründe können Begriffe wie IN_HOUSE, ACCERTIFY, CYBERSOURCE oder MANUAL_REVIEW enthalten.
MERCHANT_DENY Gibt an, dass die Transaktion aufgrund von vom Händler erkannten Risiken abgelehnt und abgeschlossen wurde. Die zugehörigen Gründe können Begriffe wie IN_HOUSE, ACCERTIFY, CYBERSOURCE oder MANUAL_REVIEW enthalten.
MANUAL_REVIEW Gibt an, dass die Transaktion aufgrund eines Verdachts oder Risikos von einem Menschen geprüft wird.
AUTHORIZATION Gibt an, dass der Autorisierungsversuch beim Kartenaussteller erfolgreich war.
AUTHORIZATION_DECLINE Gibt an, dass der Autorisierungsversuch beim Kartenaussteller fehlgeschlagen ist. Zu den Gründen können der Visa-Code 54 gehören, der angibt, dass die Karte abgelaufen ist, oder der Code 82, der angibt, dass die CVV falsch ist.
PAYMENT_CAPTURE Gibt an, dass die Transaktion abgeschlossen ist, weil das Geld abgerechnet wurde.
PAYMENT_CAPTURE_DECLINE Gibt an, dass die Transaktion nicht abgeschlossen werden konnte, weil die Zahlung nicht abgewickelt wurde.
CANCEL Gibt an, dass die Transaktion abgebrochen wurde. Geben Sie den Grund für die Stornierung an. Beispiel: INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Gibt an, dass der Händler eine Rückbuchungsanfrage aufgrund von Betrug für die Transaktion erhalten hat und 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ückbuchungswarnung für die Transaktion erhalten hat. Der Prozess zur Beilegung des Streitfalls ohne Beteiligung des Zahlungsnetzwerks wird gestartet.
FRAUD_NOTIFICATION Gibt an, dass für die Transaktion eine Betrugsbenachrichtigung von der ausstellenden Bank des Zahlungsmittels ausgegeben wurde, weil die Transaktion betrügerisch zu sein scheint. Wir empfehlen, für diesen Ereignistyp TC40- oder SAFE-Daten in das Feld reason aufzunehmen. 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 die Transaktion aufgrund von Betrug in den Rückbuchungsprozess eingetreten ist. Beispiele für Ursachencodes 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 den Rückbuchungsprozess eingetreten ist und der Händler sich für eine erneute Einreichung entschieden hat. Beispiele für Gründe sind 6005 und 6041 von Discover. Bei teilweisen Rückbuchungen empfehlen wir, im Feld value einen Betrag anzugeben.
CHARGEBACK_REVERSE Gibt an, dass für die Transaktion eine betrügerische Rückbuchung vorgenommen wurde, 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, im Feld value einen Betrag anzugeben. Beispiel für einen Grund: FRAUD.
REFUND_DECLINE Gibt an, dass der Händler einen Erstattungsantrag für diese Transaktion erhalten, aber abgelehnt hat. Bei teilweisen Erstattungen empfehlen wir, im Feld value einen Betrag anzugeben. Beispiel für einen Grund: FRAUD.
REFUND Gibt an, dass die abgeschlossene Transaktion vom Händler erstattet wurde. Bei teilweisen Erstattungen empfehlen wir, im Feld value einen Betrag anzugeben. Beispiel für einen Grund: PROACTIVE_FRAUD.
REFUND_REVERSE Gibt an, dass die abgeschlossene Transaktion vom Händler erstattet und diese Erstattung rückgängig gemacht wurde. Bei teilweisen Erstattungen empfehlen wir, im Feld value einen Betrag anzugeben.

Das folgende Beispiel zeigt eine Beispiel-Annotationsnutzlast mit einem Transaktionsereignis. 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