Vorautorisierung

Reserviere einen festen Betrag auf einem Zahlungsmittel.

• Der zu belastende Betrag darf niedriger sein als der reservierte Betrag, aber nicht höher
• Das Belasten der Vorautorisierung funktioniert zuverlässig
• Vorautorisierungen gelten etwa 5 Tage (abhängig vom Issuer)

Ablauf

Gateway erstellen

Vorautorisierungen lassen sich einfach über das zahls.ch Gateway umsetzen.
Verwende dazu den Parameter reservation.

Gateway erstellen→

Kundenautorisierung

Dieser Schritt entspricht dem Schritt «Zahlung» in der Gateway-Dokumentation.
Bei einer Vorautorisierung wird der Betrag nicht belastet, sondern reserviert.

Zusätzlich wird ein Transaktions-Webhook mit dem Transaktionsstatus reserved ausgelöst.

Reservierten Betrag belasten

Transaktions-ID ermitteln

Die Transaktions-ID steht im Transaktions-Webhook.

Du findest sie auch, wenn du ein Gateway abrufst über die zahls.ch API.
Kurzer Hinweis, wo die Transaktions-ID in der Gateway-Antwort steht:

{
    "status": "success",
    "data": [
        {
            "id": 1,
            "status": "reserved",
            "invoices": [
                {
                    "transactions": [
                        {
                            "id": 2012844,
                        }
                    ],
                }
            ],
        }
    ]
}

Belastung ausführen

Mit Charge a Pre-Authorized/Reserved Transaction belastest du die reservierte Transaktion. Dafür brauchst du die ID der Transaktion mit Status «reserved».