# Mit der API auf Anfechtungen reagieren

Erfahren Sie, wie Sie angefochtene Zahlungen programmgesteuert handhaben können.

Sie können Zahlungsanfechtungen mithilfe der API programmgesteuert verwalten. Mit der API können Sie mithilfe von Webhooks Beweise hochladen, auf Zahlungsanfechtungen reagieren und Zahlungsanfechtungen empfangen.

Wenn Sie Zahlungsanfechtungen über das Dashboard statt über die API verwalten möchten, lesen Sie [auf Zahlungsanfechtungen reagieren](https://docs.stripe.com/disputes/responding.md).

## Eine Zahlungsanfechtung abrufen

Für Details zu einer angefochtenen Zahlung [rufen Sie](https://docs.stripe.com/api/disputes/retrieve.md) ein `Dispute`-Objekt ab:

```curl
curl https://api.stripe.com/v1/disputes/{{DISPUTE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

Die Antwort enthält Informationen über die angefochtene Zahlung und alle Antworten oder Nachweise, die bereits vorgelegt wurden.

```json
{
  object: "dispute"
  id: "{{DISPUTE_ID}}",
  charge: "ch_5Q4BjL06oPWwho",
  evidence: {
    customer_name: "Jane Austen",
    customer_purchase_ip: "127.0.0.1",
    product_description: "Widget ABC, color: red",
    shipping_tracking_number: "Z01234567890",
    uncategorized_text: "Additional notes and comments",
  },
  evidence_details: {
    due_by: 1403047735,
    submission_count: 1
  }
  ...
}
```

## Zahlungsanfechtung aktualisieren

Sie [aktualisieren](https://docs.stripe.com/api/disputes/update.md) das Objekt `Dispute` und übergeben strukturierte Beweise mit dem Parameter `evidence`.

```curl
curl https://api.stripe.com/v1/disputes/{{DISPUTE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  --data-urlencode "evidence[customer_email_address]=email@example.com" \
  -d "evidence[shipping_date]=2024-02-01" \
  -d "evidence[shipping_documentation]={{FILE_ID}}"
```

Um alle verfügbaren Felder des Parameters `evidence` einzusehen, siehe [Beweise zu Zahlungsanfechtungen](https://docs.stripe.com/api/disputes/update.md#update_dispute-evidence). Es gibt zwei Arten von Beweisen, die Sie je nach dem zu aktualisierenden Feld bereitstellen können:

- Textbasierte Nachweise, z.&nbsp;B. `customer_email` und `service_date`. Für diese Arten von Nachweisen ist eine Textzeichenfolge erforderlich.
- Dateibasierte Beweise, wie z.&nbsp;B. `service_documentation` und `customer_communication`. Diese benötigen eine [file_upload](https://docs.stripe.com/api/files/object.md#file_object-id)-Objekt-ID.

> Die kombinierte Zeichenanzahl für alle textbasierten übermittelten Nachweisfelder ist auf 150.000 begrenzt.

Sie können Dokumente oder Bilder (zum Beispiel einen Vertrag oder Screenshots) als Teil des Beweises über die angefochtene Zahlung über die [File Upload API](https://docs.stripe.com/file-upload.md) bereitstellen. Sie laden zunächst ein Dokument mit dem Zweck `dispute_evidence` hoch, wodurch ein `File_upload`-Objekt generiert wird, das Sie beim Einreichen von Beweisen verwenden können. Stellen Sie sicher, dass die Datei den [Empfehlungen von Stripe](https://docs.stripe.com/disputes/best-practices.md#file-upload-recommendations) entspricht, bevor Sie diese zur Übermittlung von Beweisen hochladen.

Wenn Sie nur eine einzelne Datei oder eine große Menge Klartext als Nachweis einreichen möchten, verwenden Sie `uncategorized_text` oder `uncategorized_file`. Füllen Sie jedoch so viele Felder wie möglich aus, damit Sie die größtmögliche Chance haben, eine Zahlungsanfechtung abzuwenden.

## Mehrere angefochtene Zahlungen für eine einzige Zahlung

Es ist zwar nicht üblich, aber Kundinnen/Kunden können dieselbe Zahlung mehr als einmal anfechten. Beispielsweise könnte eine Zahlung für einen Artikel einer Bestellung teilweise angefochten werden, weil der Artikel bei der Zustellung beschädigt wurde. Dann kann eine Zahlungsanfechtung für einen weiteren Artikel erstellt werden, weil dieser nicht ordnungsgemäß funktioniert.

Stripe unterscheidet alle Zahlungsanfechtungen anhand einer eindeutigen Kennung. Dabei ist irrelevant ob sie sich auf eine einzelne Zahlung beziehen. Wenn Sie [Zahlungsanfechtungen auflisten](https://docs.stripe.com/api/disputes/list.md), können Sie die Ergebnisse so filtern, dass nur Zahlungsanfechtungen für eine bestimmte Zahlung angezeigt werden. Geben Sie dafür die `id` des `PaymentIntent` oder `Charge`-Objekts und den Filter [payment_intent](https://docs.stripe.com/api/disputes/list.md#list_disputes-payment_intent) oder [charge](https://docs.stripe.com/api/disputes/list.md#list_disputes-charge) an.

#### Nach PaymentIntent

```curl
curl -G https://api.stripe.com/v1/disputes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d payment_intent={{PAYMENT_INTENT_ID}}
```

#### Nach Zahlung

```curl
curl -G https://api.stripe.com/v1/disputes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d charge={{CHARGE_ID}}
```

Wenn für eine Zahlung mehrere Zahlungsanfechtungen vorliegen, verwenden Sie unbedingt die `id` der zurückgegebene Zahlungsanfechtung aus der Liste. So stellen Sie sicher, dass Sie sich stets auf die richtige Anfechtung beziehen. Die `id` geben Sie beim [Abrufen](https://docs.stripe.com/disputes/api.md#retrieve-a-dispute) oder [Aktualisieren der Zahlungsanfechtung](https://docs.stripe.com/disputes/api.md#update-a-dispute) an.

## See also

- [Zahlungsanfechtungskategorien](https://docs.stripe.com/disputes/categories.md)
- [Erfassung von Zahlungsanfechtungen](https://docs.stripe.com/disputes/measuring.md)
- [Zahlungsanfechtungen und Betrug verhindern](https://docs.stripe.com/disputes/prevention.md)