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 Einblick in die Ereignisse des Zahlungslebenszyklus für Transaktionen. Wir empfehlen daher, Anmerkungen zu den Bewertungen zu senden, die Sie mit Transaktionsdaten erstellt haben. Sie können die Transaktionsinformationen beispielsweise in den folgenden Fällen als Transaktionsereignis an reCAPTCHA Fraud Prevention senden:

  • Der Zahlungsanbieter akzeptiert oder lehnt die Transaktion ab.

  • Der Händler erstattet den Betrag.

  • 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, gibt reCAPTCHA Fraud Prevention ein Urteil und einen Bewertungsnamen zurück. Fügen Sie der Bewertung Transaktionsereignisse in den folgenden wichtigen Phasen des Zahlungszyklus hinzu, wenn sie auftreten:

Ereignistyp Beschreibung Beispiel für Grund Beispiel für einen 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 (entspricht einer teilweisen Rückbuchung von 20 Währungseinheiten)

Gib neben dem Ereignistyp CHARGEBACK den vom Kartenaussteller angegebenen Code für den Grund der Rückbuchung im Feld reason an. Gib im Feld value auch den zurückgebuchten Geldbetrag an, falls die Transaktion teilweise zurückgebucht wurde.

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

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

Grund für die 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 Gibt an, dass die Transaktion aufgrund von vom Händler erkannten Risiken abgelehnt und abgeschlossen wurde. Die begleitenden 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. 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 Erstattungen 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 die Rückbuchung eingetreten ist. Beispiele für den Grundcode sind 6005 und 6041 von Discover. Bei teilweisen Rückbuchungen empfehlen wir, einen Betrag im Feld value anzugeben.
CHARGEBACK_REPRESENTMENT Gibt an, dass die Transaktion aufgrund von Betrug in die 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 Erstattungen empfehlen wir, einen Betrag im Feld value anzugeben.
CHARGEBACK_REVERSE Gibt an, dass für die Transaktion eine betrügerische Rückbuchung stattgefunden hat, 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 einen 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 wir, einen Betrag im Feld value anzugeben. Beispiel für einen 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 und diese Erstattung rückgängig gemacht wurde. Bei teilweisen Erstattungen empfehlen wir, einen Betrag im Feld value anzugeben.

Das folgende Beispiel zeigt eine Beispiel-Annotation-Nutzlast 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