Idempotenz und Wiederholungen

Zwei Idempotenzebenen ermöglichen Wiederholungen nach Timeouts, ohne Zahlungen, Erstattungen oder Nebenwirkungen zu duplizieren.

Wichtige Hinweise

out_trade_no und out_refund_no sichern die dauerhafte fachliche Eindeutigkeit von Bestellungen und Erstattungen.
Idempotency-Key gilt für alle schreibenden Endpunkte 24 Stunden lang. Derselbe Schlüssel mit anderem Request-Body führt zu einem Fehler.
2xx- und abschließende 4xx-Antworten werden erneut ausgegeben; 5xx wird nicht gespeichert. Vermeiden Sie Webhook-Duplikate zusätzlich per Ereignis-ID.

json

{
  "out_trade_no": "ORDER_20260921_0001",
  "amount": 2990,
  "currency": "USD"
}