Loslegen mit Smart DisputesÖffentliche Vorschau

Erfahren Sie, wie Sie Stripe Smart Disputes einrichten und konfigurieren, um angefochtene Zahlungen automatisch zu bearbeiten und Ihre Erfolgsquote bei Zahlungsanfechtungen zu verbessern.

Smart Disputes erstellt und übermittelt automatisch hochwertige Nachweispakete in Ihrem Namen, noch bevor die Anfechtungsfrist abläuft. Dadurch können Sie Umsätze zurückgewinnen, die Sie sonst durch Zeitüberschreitungen oder unvollständige Einreichungen verlieren könnten – und behalten dennoch die volle Kontrolle, um Ihre eigenen Nachweise zu prüfen, zu bearbeiten oder einzureichen.

Nachdem Sie Ihr Konto bei Smart Disputes registriert haben, ist keine zusätzliche Einrichtung erforderlich. Stripe erstellt und übermittelt Beweise automatisch, wenn genügend Daten verfügbar sind. Sie können diese Pakete auch manuell ergänzen, um die Leistung zu verbessern.

Funktionsweise von Smart Disputes

Nachdem Sie über eine angefochtene Zahlung informiert wurden:

Stripe erstellt automatisch Beweispakete für jede berechtigte angefochtene Zahlung.
Sie behalten die volle Kontrolle und können:
- Reichen Sie entweder Ihre eigenen Beweise oder das Smart-Disputes-Paket manuell ein.
- Akzeptieren Sie die angefochtene Zahlung.
- Verlassen Sie sich darauf, dass Smart Disputes die Nachweise automatisch vor Ablauf der Frist für die Zahlungsanfechtung einreicht.
- Verbessern Sie Ihre Erfolgschancen, indem Sie Beweise zu einem Smart Disputes-Paket hinzufügen.

Wenn Sie nichts unternehmen, übermittelt Smart Disputes das Paket automatisch, damit Sie nicht die Gelegenheit verpassen, auf die Zahlungsanfechtung zu reagieren. Wenn Sie möchten, können Sie auch manuell eingreifen, indem Sie das Paket vor Ablauf der Frist einreichen oder zusätzliche Beweise hinzufügen, um Ihre Erfolgschancen zu erhöhen:

Bei Zahlungsanfechtungen, für die bereits ein Paket verfügbar ist, kann Stripe empfehlen, zusätzliche Beweise hinzuzufügen (z. B. Ausführungsdetails oder Kommunikationsprotokolle), um Ihre Erfolgschancen zu erhöhen. Dies ist jedoch nicht zwingend erforderlich.
Bei anderen Zahlungsanfechtungen kann das Hinzufügen der empfohlenen Beweise dazu führen, dass sie für die Einreichung von Smart Disputes berechtigt werden. Weitere Informationen zum Verfügbarkeitsstatus finden Sie unten.

Smart Disputes mit der API verwenden

Wenn Sie Zahlungsanfechtungen programmgesteuert verwalten, aktualisieren Sie Ihre Integration, um die Vorteile von Smart Disputes zu nutzen.

Beabsichtigte Einreichungsmethode

Die Disputes API enthält das Feld intended_submission_method, um festzustellen, ob Sie oder Stripe die Beweise für die Zahlungsanfechtung einreichen. Weitere Informationen finden Sie in der API zur Aktualisierung einer angefochtenen Zahlung.

Feld	Beschreibung
prefer_manual	Standardmäßig reicht Stripe Ihre Beweise ein, falls Sie welche hinzugefügt haben. Wenn nicht, reicht Stripe ein Smart-Disputes-Paket ein (sofern verfügbar).
prefer_smart_disputes	Stripe kombiniert Ihre Beweise mit den von Smart Disputes generierten Beweisen und reicht das bestmögliche Paket ein. Empfohlen, um die Erfolgsquote zu maximieren.

Um die besten Ergebnisse zu erhalten, setzen Sie intended_submission_method bei der Aktualisierung einer angefochtenen Zahlung auf prefer_smart_disputes. Wenn Sie Beweise hinzufügen, führt Stripe diese mit den automatisch generierten Smart Disputes-Daten zu einem einzigen, umfassenden Paket zusammen.

Leistung von Smart Disputes verbessern

Smart Disputes ist auf Datenqualität angewiesen. Je mehr Transaktions- und Kundendaten Stripe zur Verfügung stehen, desto stärker sind Ihre Beweispakete.

Weitere Daten zum Zeitpunkt der Belastung bereitstellen

Smart Disputes nutzt eine KI-Regel-Engine, um Beweise aus Ihren Transaktionsdaten, internen Stripe-Daten, historischen Erfolgsraten und Karteninhaberdaten zu extrahieren. Das Hinzufügen weiterer Daten beim Erstellen von Zahlungen hilft Stripe, vollständigere und überzeugendere Nachweispakete zu erstellen.

Betrugssignale erfassen

Stellen Sie sicher, dass Ihre Integration Stripe.js enthält oder Radar Sessions verwendet, um Browserinformationen an Stripe zu senden.

Wenn Sie Zahlungen über die API erstellen, fügen Sie möglichst viele der folgenden Felder ein:

Objekt	Feld	Beschreibung
payment_intent, Zahlung, Kundin/Kunde	payment_intent.customer[email], charge.billing_details[email], charge.customer[email]	E-Mail-Adresse des Kunden/der Kundin
payment_intent, Zahlung, Kundin/Kunde	payment_intent.customer[phone], charge.billing_details[phone], charge.customer[phone]	Telefonnummer der Kundin/des Kunden
payment_intent, Zahlung, Karte	payment_intent.customer[address], charge.customer[address], charge.billing_details[address], card[address_*]	Rechnungsadresse der Kundin/des Kunden
payment_intent, Zahlung, Karte	payment_intent.customer[name], charge.billing_details[name], charge.customer[name], card[name], card.customer[name]	Name der Kundin/des Kunden
payment_intent, Bezahlvorgang, Produkt	payment_intent.amount_details[line_items], checkout[line_items]	Detaillierte Informationen zu einzelnen Posten jeder Transaktion bereitstellen
Checkout, Produkt	checkout.line_items.data.price[product], product[images], product[url], product[description]	Produktinformationen, einschließlich Bilder und Beschreibungen
payment_intent, Zahlung, Kundin/Kunde, Versand	payment_intent.shipping[address], charge.shipping[address], customer.shipping[address]	Versandadresse für ein physisches Produkt
payment_intent, Zahlung, Kundin/Kunde, Versand	payment_intent.shipping[tracking_number], charge.shipping[tracking_number], customer.shipping[tracking_number]	Die Tracking-Nummer für ein physisches Produkt
payment_intent, Zahlung, Kundin/Kunde, Versand	payment_intent.shipping[carrier], charge.shipping[carrier], customer.shipping[carrier]	Der für den Versand eines physischen Produkts genutzte Zustelldienst, wie z. B. FedEx, UPS, USPS usw.
payment_intent, Zahlung, Kundin/Kunde, Versand	payment_intent.shipping[phone], charge.shipping[phone], customer.shipping[phone]	Telefonnummer der Paketempfängerin/des Paketempfängers
payment_intent, Zahlung	payment_intent[receipt_email], charge[receipt_email]	E-Mail-Adresse, an die der Zahlungsbeleg für diese Zahlung gesendet wurde.

Die Bereitstellung dieser Daten hilft Stripe bei der Erstellung von Beweisen, die die Identität der Karteninhaberin/des Karteninhabers und die Legitimität der Transaktion unterstützen und wird mit anderen Daten im gesamten Stripe-Netzwerk kombiniert.

Weitere Daten zum Zeitpunkt der Zahlungsanfechtung bereitstellen

Selbst nachdem eine Zahlungsanfechtung erstellt wurde, können Sie die Wirksamkeit von Smart Disputes verbessern, indem Sie zusätzliche Beweise bereitstellen.

Wenn Sie Zahlungsanfechtungen über die API verwalten, stellt Stripe zwei Informationen zur Verfügung, die Ihnen helfen, die Berechtigung für Smart Disputes zu verstehen und zu beeinflussen:

Empfohlene Beweisfelder: Das Objekt angefochtene Zahlung enthält ein Array mit smart_disputes.recommended_evidence, das auflistet, welche Felder (oder Feldgruppen) das Paket stärken oder die angefochtene Zahlung für Smart Disputes qualifizieren würden. Diese Felder werden dynamisch auf der Grundlage des Anfechtungsgrunds und der Netzwerkregeln generiert.
Verfügbarkeit (Paketstatus): Die angefochtene Zahlung enthält den Wert smart_disputes.status, der angibt, ob derzeit ein Smart-Disputes-Paket für die angefochtene Zahlung existiert:

Feld	Beschreibung
verfügbar	Ein Smart Disputes-Paket steht bereit und kann automatisch übermittelt werden.
requires_evidence	Ein Smart Disputes-Paket wird verfügbar, wenn Sie die im `recommended_evidence` aufgeführten erforderlichen Beweise bereitstellen. Wenn Sie die erforderlichen Felder angeben, wird die Zahlungsanfechtung in den Status `verfügbar` verschoben.
nicht verfügbar	Die angefochtene Zahlung ist nicht für Smart Disputes verfügbar. Das Bereitstellen zusätzlicher Felder ändert diesen Status nicht.

Wenn smart_disputes.status nicht verfügbar ist und Sie intended_submission_method auf prefer_smart_disputes gesetzt haben, greift Stripe auf die Übermittlung aller von Ihnen vorgelegten manuellen Beweise (z. B. eines manuellen Pakets) zurück, bis smart_disputes.status verfügbar wird.

Sie können auch benutzerdefinierte Beweisfelder hinzufügen, wie Sie es derzeit über den Endpoint Zahlungsanfechtung aktualisieren tun – selbst wenn diese nicht Teil des Arrays recommended_evidence sind. Stellen Sie sicher, dass intended_submission_method auf prefer_smart_disputes gesetzt ist.

Beispiel: Empfohlene Beweise + Status lesen

GET /v1/disputes/{dispute_id} gibt sowohl die empfohlenen Felder als auch den aktuellen Status des Pakets zurück:

{
  "id": "dp_123",
  "amount": 1000,
  "reason": "fraudulent",
  "smart_disputes": {
    "status": "requires_evidence",
    "recommended_evidence": [
        ["shipping_carrier", "tracking_number"],    // group — both required together
        ["customer_email"]                         // single required field
     ]
  },
}

In diesem Beispiel:

Der Status der Zahlungsanfechtung lautet requires_evidence.
Wenn Sie entweder customer_email oder sowohl shipping_carrier als auch tracking_number bereitstellen, veranlasst Stripe, die Zahlungsanfechtung neu zu bewerten und (sofern die geltenden Regeln erfüllt sind) smart_disputes.status auf verfügbar zu aktualisieren.

Beispiel: Festlegen von intended_submission_method und Einreichen empfohlener Beweise

In diesem Beispiel:

intended_submission_method ist auf prefer_smart_disputes eingestellt, wobei intelligente Zahlungsanfechtungen als bevorzugtes Paket ausgewählt werden.
Beide empfohlenen Beweisfelder (shipping_tracking_number und shipping_carrier) wurden bereitgestellt.
Das Bereitstellen der empfohlenen Nachweise veranlasst Stripe, die Zahlungsanfechtung neu zu bewerten und smart_disputes.status auf verfügbar zu aktualisieren (sofern die entsprechenden Regeln erfüllt sind).

After you submit a dispute, you can view the submission method through the evidence_details.submission_method parameter on the Dispute object.