Zahlung hängt im Status «Ausstehend» — was tun?

Prüfen Sie das Webhook-Zustellungslog in tikento (Einstellungen → Zahlungen → Webhook-Log). Wenn kein Webhook eingegangen ist — überprüfen Sie die URL und die Ereigniseinstellungen im Gateway-Dashboard. Wenn ein Webhook mit Fehler eingegangen ist — prüfen Sie den Antwortcode im Log.

Wie oft wiederholt das Gateway den Webhook-Versand?

YooKassa — bis zu 10 Versuche mit exponentieller Verzögerung (von Sekunden bis Stunden). Tochka — bis zu 5 Versuche im Abstand von 5 Minuten. Wenn alle Versuche erschöpft sind, verwenden Sie den manuellen Retry.

Kann ich eine Zahlung manuell ohne Webhook bestätigen?

Ja. Öffnen Sie den Teilnehmerdatensatz und klicken Sie auf «Aktionen» → «Zahlung manuell bestätigen». Dies aktualisiert den Registrierungsstatus, erstellt aber keinen Zahlungseintrag im Gateway.

Wie überprüfe ich, ob die Webhook-URL korrekt ist?

Öffnen Sie in tikento Einstellungen → Zahlungen → wählen Sie das Gateway. Kopieren Sie die angezeigte Webhook-URL und vergleichen Sie sie mit der URL im Gateway-Dashboard. Sie müssen vollständig übereinstimmen, einschließlich des Protokolls (https://).

Webhook nicht empfangen: Diagnose

Symptome des Problems

Ein Teilnehmer berichtet, dass er das Ticket bezahlt hat, aber:

Der Registrierungsstatus ist «Zahlung ausstehend»
Die E-Mail mit dem Ticket ist nicht angekommen
In der Teilnehmerliste ist der Zahlungsstatus pending

Am häufigsten liegt die Ursache darin, dass der Webhook vom Zahlungs-Gateway nicht zugestellt oder von tikento nicht verarbeitet wurde.

Schritt 1. Webhook-Zustellungslog prüfen

tikento führt ein Log aller eingehenden Webhook-Anfragen:

Öffnen Sie Einstellungen → Zahlungen.
Wählen Sie das Gateway (YooKassa oder Tochka).
Wechseln Sie zum Reiter «Webhook-Log».

Im Log werden angezeigt:

Datum und Uhrzeit der Anfrage
Ereignistyp (payment.succeeded, payment.canceled, refund.succeeded)
HTTP-Antwortcode von tikento
Anfragekörper (zur Diagnose)
Verarbeitungsstatus (Erfolg / Fehler)

Mögliche Ergebnisse

Situation	Bedeutung	Nächster Schritt
Webhook nicht im Log	Gateway hat nicht gesendet oder konnte nicht zustellen	Weiter zu Schritt 2
Webhook vorhanden, Code `200`	Erfolgreich verarbeitet	Prüfen Sie, ob die `payment_id` mit der betroffenen Zahlung übereinstimmt
Webhook vorhanden, Code `4xx`	Validierungsfehler (ungültige Signatur, unbekanntes Format)	Weiter zu Schritt 4
Webhook vorhanden, Code `5xx`	Interner Fehler von tikento	Weiter zu Schritt 5

Schritt 2. Webhook-Einstellungen im Gateway prüfen

Melden Sie sich im Dashboard des Zahlungs-Gateways an und prüfen Sie:

YooKassa

Öffnen Sie «Einstellungen» → «HTTP-Benachrichtigungen».
Stellen Sie sicher, dass die Webhook-URL übereinstimmt:
```
https://app.tikento.com/webhooks/yookassa/{shopId}
```
Prüfen Sie, ob alle erforderlichen Ereignisse ausgewählt sind:
- payment.succeeded
- payment.canceled
- refund.succeeded

Tochka

Öffnen Sie «Integration» → «Benachrichtigungen».
Stellen Sie sicher, dass die Webhook-URL übereinstimmt:
```
https://app.tikento.com/webhooks/tochka/{merchantId}
```
Prüfen Sie die Ereignisfilter.

Häufige Fehler in der URL

https:// fehlt (stattdessen http:// angegeben — Gateways erfordern HTTPS)
Überflüssiger Schrägstrich am Ende der URL
Falsche shopId oder merchantId im Pfad
URL von einer alten Verbindung (wenn Sie das Gateway neu verbunden haben)

Schritt 3. Erreichbarkeit des Webhook-Endpunkts prüfen

Wenn die URL korrekt ist, aber der Webhook nicht zugestellt wird, mögliche Ursachen:

Firewall oder CDN blockiert eingehende POST-Anfragen vom Gateway
Timeout: tikento konnte nicht rechtzeitig antworten (Gateways warten in der Regel 10–30 Sekunden)
DNS-Probleme: Die Domain wird auf der Gateway-Seite nicht aufgelöst

Zur Überprüfung verwenden Sie den Test-Webhook aus dem Gateway-Dashboard (falls verfügbar) oder fordern Sie einen erneuten Versand an.

Schritt 4. Validierungsfehler (4xx)

Wenn der Webhook eingegangen ist, aber tikento einen 4xx-Fehler zurückgegeben hat:

Code	Ursache	Lösung
`400`	Ungültiger Anfragekörper	Prüfen Sie das Benachrichtigungsformat im Gateway. Stellen Sie sicher, dass JSON und nicht XML gewählt ist
`401`	Ungültige Anfragesignatur	Stellen Sie sicher, dass der `secretKey` in tikento aktuell ist. Wenn Sie den Schlüssel im Gateway neu generiert haben, aktualisieren Sie ihn auch in tikento
`404`	Falscher Webhook-URL-Pfad	Prüfen Sie die URL — möglicherweise ist die `shopId` / `merchantId` falsch angegeben
`409`	Doppelter Webhook (bereits verarbeitet)	Dies ist normales Verhalten — der Idempotency-Schutz hat gegriffen. Die Zahlung wurde bereits verarbeitet

Schritt 5. Interner Fehler (5xx)

Wenn der Webhook empfangen wurde, aber tikento 5xx zurückgegeben hat — dies ist ein vorübergehender Fehler auf Seiten von tikento. In den meisten Fällen:

Das Gateway wiederholt die Zustellung automatisch (siehe Retry-Richtlinie unten).
Beim erneuten Versuch wird das Problem in der Regel gelöst.
Wenn der Fehler wiederholt auftritt — kontaktieren Sie den tikento-Support.

Richtlinie für erneute Zustellung

Gateway	Anzahl Versuche	Intervalle
YooKassa	bis zu 10	Exponentielle Verzögerung: 1 s, 5 s, 30 s, 2 min, 10 min, 30 min, 1 h, 3 h, 6 h, 12 h
Tochka	bis zu 5	Festes Intervall: alle 5 Minuten

Wenn alle Versuche erschöpft sind, verwenden Sie den manuellen Retry.

Öffnen Sie die Veranstaltung → «Teilnehmer».
Finden Sie den Eintrag mit dem hängenden Status.
Klicken Sie auf «Aktionen» → «Zahlung manuell bestätigen».
Geben Sie den Grund an (für das Audit).

Die manuelle Bestätigung aktualisiert den Registrierungsstatus und sendet dem Teilnehmer die E-Mail mit dem Ticket.

Webhook testen

Um sicherzustellen, dass der Webhook korrekt funktioniert, vor oder nach der Einrichtung:

Testzahlung

Erstellen Sie eine Testveranstaltung mit einem kostenpflichtigen Ticket.
Verbinden Sie das Gateway im Testmodus.
Bezahlen Sie mit der Testkarte (4111 1111 1111 1111).
Prüfen Sie das Webhook-Log — es sollte ein Eintrag mit Code 200 erscheinen.
Stellen Sie sicher, dass der Registrierungsstatus auf «Bezahlt» aktualisiert wurde.

Test-Webhook vom Gateway

Einige Gateways erlauben das manuelle Senden eines Test-Webhooks:

YooKassa: Im Bereich «HTTP-Benachrichtigungen» Schaltfläche «Testbenachrichtigung senden»
Tochka: Kontaktieren Sie den Tochka-Support für den Versand einer Testbenachrichtigung

Prävention

Um Webhook-Probleme zu vermeiden:

Aktualisieren Sie bei einem Wechsel der API-Schlüssel im Gateway sofort auch die Schlüssel in tikento
Löschen oder ändern Sie die Webhook-URL nicht ohne Notwendigkeit
Prüfen Sie regelmäßig das Webhook-Log auf Fehler
Führen Sie bei erneutem Verbinden des Gateways immer eine Testzahlung durch