Vorautorisierung: Betrag reservieren und belasten

Eine Vorautorisierung reserviert beim Checkout einen Betrag auf dem Zahlungsmittel des Kunden, ohne ihn zu belasten. Sie ziehen die Mittel später ein — etwa beim Check-out im Hotel oder bei der Rückgabe eines Mietobjekts — oder lassen die Reservation einfach verfallen. Bei FlowAlp Pay aktivieren Sie das mit einem einzigen Gateway-Parameter und belasten über den Transaction-Endpoint.

So funktioniert die Vorautorisierung#

1. Erstellen Sie ein Gateway mit "reservation": true und dem zu blockierenden Betrag.
2. Der Kunde autorisiert die Zahlung im gehosteten Checkout — belastet wird noch nichts.
3. Die Transaktion erhält den Status reserved; Sie erfahren davon per Webhook oder durch Abrufen des Gateways.
4. Sie belasten die reservierte Transaktion — oder lassen die Reservation verfallen.

Drei Eigenschaften prägen das Modell: Der eingezogene Betrag darf niedriger, aber nie höher als die Reservation sein, die Belastung einer Reservation ist verlässlich, weil die Mittel blockiert sind, und pro Reservation ist genau eine Belastung möglich. Möchten Sie einen Kunden wiederholt belasten, verwenden Sie stattdessen die Tokenisierung.

Reservation im Checkout erstellen#

Die Anfrage ist eine normale Gateway-Erstellung mit dem zusätzlichen Flag reservation. Der Betrag wird in der kleinsten Einheit angegeben (CHF 500.00 → 50000).

curl -X POST "https://api.pay.flowalp.com/v1.16/Gateway/?instance=demo-shop" \
  -H "x-api-key: $FLOWALP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "CHF",
    "purpose": "Security deposit apartment 12",
    "referenceId": "BOOKING-2026-0788",
    "reservation": true,
    "successRedirectUrl": "https://rentals.example.com/deposit/success",
    "failedRedirectUrl": "https://rentals.example.com/deposit/failed",
    "cancelRedirectUrl": "https://rentals.example.com/deposit/cancel"
  }'

Reservierten Betrag einziehen#

Zum Einziehen belasten Sie die reservierte Transaktion. Entnehmen Sie die ID der Transaktion mit Status reserved dem Webhook-Payload, oder lesen Sie sie aus den Invoices und Transaktionen des abgerufenen Gateways. Senden Sie dann eine POST-Anfrage an den Transaction-Endpoint — mit dem vollen reservierten oder einem niedrigeren Betrag:

curl -X POST "https://api.pay.flowalp.com/v1.16/Transaction/4711/?instance=demo-shop" \
  -H "x-api-key: $FLOWALP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 38000,
    "purpose": "Final amount after check-out",
    "referenceId": "BOOKING-2026-0788-FINAL"
  }'

Eine erfolgreiche Belastung erzeugt eine Transaktion mit Status confirmed — behandeln Sie sie wie jede andere Zahlung, inklusive Webhook-Verifikation. Endpoint-Parameter, Rückerstattungen und Stornierungen sind unter Transactions belasten, einziehen, erstatten und stornieren dokumentiert.

Gültigkeit einer Reservation#

Reservierte Mittel bleiben nicht unbegrenzt blockiert: Eine Vorautorisierung ist typischerweise rund fünf Tage gültig. Danach verfällt die Reservation und der blockierte Betrag wird automatisch wieder freigegeben — ein API-Aufruf ist dafür nicht nötig.

Typische Anwendungsfälle#

• Hotels und Beherbergung — No-Shows und Extras absichern, die Endabrechnung bei der Abreise einziehen.
• Miete und Sharing — Kaution bei der Übergabe blockieren; bei der Rückgabe freigeben oder teilweise einziehen.
• Anzahlungen für Dienstleistungen und Sonderanfertigungen — vor Arbeitsbeginn sicherstellen, dass die Mittel vorhanden sind, und erst bei Lieferung belasten.
• Später bekannte Endbeträge — eine Obergrenze reservieren und den exakten Betrag (Treibstoff, Extras, Gewichtspreise) einziehen, sobald er feststeht.