Rückerstattungen

Einen Einzug ganz oder teilweise zurückgeben.

Eine Rückerstattung anlegen

POST /v1/refunds

Feld	Pflicht	Beschreibung
payment_id	ja	Der ursprüngliche Einzug: seine Kennung oder seine Referenz
amount_minor	—	Zeichenkette, in kleinsten Einheiten. Fehlt = der Restbetrag
reason	—	customer_request, duplicate, fraudulent oder other
description	—	Freitext, im Dashboard sichtbar

Die Rückerstattung ist eine vollwertige Operation: eigene id, eigener Status, eigenes Webhook-Ereignis (refund.success / refund.failed).

Regeln

• Nur ein erfolgreicher Einzug lässt sich erstatten.
• Die Summe der Rückerstattungen darf den eingezogenen Betrag nicht überschreiten — darüber antwortet die API 422 invalid_request.
• Einzugsgebühren werden nicht zurückgegeben: sie bleiben bei Ihnen.
• Eine Teilerstattung lässt den ursprünglichen Einzug einsehbar, mit vollständiger Historie.
• Die Mittel werden zum Zeitpunkt des Aufrufs Ihrem verfügbaren Guthaben entnommen, wie bei einer Auszahlung.

Ein Idempotenzschlüssel je Rückerstattung. Nie die Kennung der ursprünglichen Zahlung: ein Einzug kann in mehreren Schritten erstattet werden, und ein Schlüssel mit der Kennung des übergeordneten Objekts ließe die zweite Teilerstattung wie eine Wiederholung der ersten aussehen.

Lesen und auflisten

GET /v1/refunds/{id}
GET /v1/refunds