Zurück zum Blog
Abrechnung

Security Deposits API: Checkliste für Integrationstests

Prüfen Sie Ihre Kautions-API mit einer Matrix für doppelte Erstellung, Autorisierung, endgültigen Capture, Freigabe und Buchungsänderungen.

13. Oktober 20265 Min. Lesezeit
P
PayRequest Team
PayRequest-Redaktion

Prüfen Sie vor dem Start den gesamten Ablauf der Security Deposits API: Erstellung, Kundenautorisierung, Statusabgleich, unterstützten Einzug und Freigabe. Eine erfolgreiche Erstellung beweist keine reservierten Mittel.

Diese Checkliste ist ein vorgeschlagener Abnahmeplan für Vermietungssoftware, keine Zertifizierung und kein Testbericht.

Bereiten Sie den Kautions-API-Test vor

Bestätigen Sie die unterstützte Testkonfiguration mit PayRequest und Ihrem Anbieter. Verwenden Sie fiktive Kunden und unterstützte Testzugänge; nehmen Sie keinen separaten PayRequest-Sandbox-Host an. Die API-Referenz verlangt billing.read zum Abrufen und billing.write für Erstellung, Capture und Freigabe. Tokens bleiben serverseitig; die ursprünglichen Request-Bytes dienen der Signaturprüfung.

Erfassen Sie für TEST-104 eine fiktive €350-Kaution samt Referenz, ID, Anbieter, Status, captured_amount und capture_before. Verwenden Sie getrennte Testbuchungen für Capture und Freigabe, da beide die Reservierung beenden.

Nutzen Sie diese Kautions-API-Abnahmematrix

Die erwarteten Ergebnisse entsprechen dem dokumentierten Stripe-Ablauf. Prüfen Sie Konto- und Zahlungsmethodenunterstützung.

SzenarioErwartete Prüfung
Zweimal erstellen, gleicher SchlüsselEine Zuordnung und eine Kundennachricht
Kunde hat nicht autorisiertPending; keine Mittel als reserviert anzeigen
Autorisierung in BearbeitungPending und verfügbare Metadaten; kein automatischer Ersatz
Autorisierung abgeschlossenAuthorized und tatsächliche capture_before-Frist
€150 von €350 einziehenCaptured; €200 freigegeben, kein weiterer Capture
Zweiter Capture nach lokaler FinalisierungDokumentiertes HTTP 409, kein zweiter Einzug
Andere aktive Kaution freigebenReleased; Nachricht beschreibt Freigabe
Doppelter oder später WebhookKeine Wiederholung und kein Zurücksetzen des Endzustands

Bewahren Sie überprüfbare Request- und Response-Referenzen ohne Geheimnisse oder Kartendaten auf. Screenshots unterstützen die Prüfung; der aktuelle API-Status belegt den finanziellen Zustand.

Prüfen Sie Buchungsänderungen getrennt

Ändern Sie das Rückgabedatum und prüfen Sie, dass die Autorisierungsfrist unverändert bleibt. Laut Stripe muss Capture vor der tatsächlichen Frist erfolgen. Eine spätere Rückgabe sollte eine verantwortliche Prüfung auslösen, keinen automatischen Volleinzug zur Vermeidung des Ablaufs.

Halten Sie Mietzahlung über Zahlungslinks, Buchungsverfügbarkeit und Kautionsstatus getrennt. Vereinbarung, Schadenbeleg und unterstützte Anbieteraktion bestimmen den Einzug.

Prüfen Sie unklare Antworten vor Wiederholungen

Simulieren Sie eine verlorene Erstellungsantwort und verwenden Sie denselben Schlüssel. Bei unklarer Capture- oder Freigabeantwort zuerst den Datensatz abrufen: Erstellungsgarantien gelten nicht automatisch für andere Aktionen. Siehe Wiederherstellungsplan.

Pending kann einen verarbeiteten oder abgelaufenen Versuch beschreiben; expired betrifft eine zuvor bestätigte, abgelaufene Reservierung. Prüfen Sie außerdem Mobilansicht, ungültige Signaturen, Kontentrennung und Lese- beziehungsweise Schreibrechte.

Starten Sie einen begrenzten Pilot mit PayRequest-Kautionen und prüfen Sie Tarife und Grenzen. Fordern Sie Nachweise je Szenario und einen Verantwortlichen für Ausnahmen.

Redaktioneller Hinweis: KI unterstützte Text und Bild. Dokumentation geprüft am 13. Oktober 2026. Keine Live-Finanzaktion durchgeführt; die Matrix ist eigene Anleitung.

Frequently Asked Questions

Reserviert die Erstellung eines Links bereits Mittel?

Nein. Prüfen Sie authorized und die Anbieterfrist nach der Kundenautorisierung.

Verlängert ein neues Rückgabedatum die Reservierung?

Nein. Eine Buchungsänderung ersetzt die Anbieterfrist nicht. Prüfen Sie die Kaution und einen unterstützten nächsten Schritt.

Diesen Artikel teilen