Erstattungen¶

SecPaid unterstützt programmatische Voll- und Teilerstattungen über die API.

So funktionieren Erstattungen¶

stateDiagram-v2
    [*] --> Bezahlt: Zahlung abgeschlossen
    Bezahlt --> AnfrageGestellt: refundPayment API-Call
    AnfrageGestellt --> Genehmigt: Admin genehmigt
    AnfrageGestellt --> Abgelehnt: Admin lehnt ab
    Genehmigt --> Erstattet: Erstattung verarbeitet

Sie rufen POST /api/v2/refundPayment mit pay_id und refund_amount auf
Eine Erstattungsanfrage wird erstellt (Status: pending)
Ein SecPaid-Admin prüft und genehmigt/lehnt die Erstattung ab
Bei Genehmigung wird die Erstattung auf die originale Zahlungsmethode des Kunden verarbeitet

Anforderungen¶

Immer refund_amount angeben

Das Feld refund_amount ist immer erforderlich — auch bei Vollerstattungen. Setzen Sie es auf den vollen Zahlungsbetrag für eine vollständige Erstattung.

Erstattungstypen¶

Vollerstattung¶

Den gesamten Zahlungsbetrag erstatten:

{
  "pay_id": 12345,
  "refund_amount": 49.99,
  "isFullRefund": true
}

Teilerstattung¶

Einen Teil der Zahlung erstatten:

{
  "pay_id": 12345,
  "refund_amount": 20.00
}

Bedingungen die Erstattungen blockieren¶

Die API lehnt eine Erstattungsanfrage ab wenn:

Bedingung	Fehlermeldung
Link wurde abgebrochen (nicht bezahlt)	Link is cancelled
Ungültige `pay_id`	Link not found
Link-Typ ist "invoice"	Cannot refund invoice-type links
Erstattung für diesen Link bereits angefragt	Refund already requested
Aktiver Dispute auf der Zahlung	Refund blocked by dispute
`refund_amount` übersteigt bezahlten Betrag	Invalid refund amount
`refund_amount` ist 0 oder negativ	Refund amount is required

Erstattungs-Status-Lebenszyklus¶

Status	Bedeutung
`Pending`	Erstattung angefragt, wartet auf Admin-Prüfung
`Approved`	Admin genehmigt, wird verarbeitet
`Rejected`	Admin abgelehnt mit optionalem Grund
`Completed`	Erstattung erfolgreich verarbeitet

Wichtige Hinweise¶

Erstattungen gehen zurück an die originale Zahlungsmethode
Es gibt keine Webhook-Benachrichtigung wenn eine Erstattung verarbeitet wird
Banküberweisung-Zahlungen können ein anderes Erstattungsverfahren haben
Der Erstattungsbetrag kann den originalen Zahlungsbetrag nicht übersteigen
Mehrere Teilerstattungen auf denselben Link werden nicht unterstützt — eine Erstattungsanfrage pro Link

Verwandt¶

refundPayment API-Referenz