# Zahlungen annehmen

Zahlungsblöcke stellen der Person direkt im Dialog eine Rechnung: Der Bot sendet einen Link zur Seite des Zahlungssystems und führt das Szenario nach der Zahlung weiter. Für jedes Zahlungssystem gibt es einen eigenen Block, aber alle sind gleich aufgebaut.

## So funktioniert ein Zahlungsblock

1. Das Szenario erreicht den Block. Der Block legt im Zahlungssystem eine Zahlung an und sendet der Person eine Nachricht mit einem Link-Button zur Zahlungsseite.
2. Gleich danach geht das Szenario über den Ausgang „Fortsetzen“ weiter — ohne auf das Geld zu warten.
3. Sobald das Zahlungssystem meldet, dass die Rechnung bezahlt ist, führt der Bot die Person über den Ausgang „Erfolgreiche Zahlung“.

### Zahlungssystem verbinden

Der Block arbeitet nur mit einem verbundenen Zahlungssystem. Es wird für jeden Bot einzeln verbunden: Öffnen Sie im Bot die „Einstellungen“, den Tab „Integrationen“, wählen Sie das System in der Liste „Verfügbare Integrationen“ und geben Sie die Schlüssel aus seinem Kundenkonto ein.

![Verbindungsfenster für YooKassa in den Integrationen des Bots: Shop-ID, geheimer Schlüssel, Währung, Steuern](https://support.watbot.org/_media/de/01-chatbots/03-blocks/09-payments/_images/payment-connect.webp?v=1791781229)

Bei den meisten Systemen erscheint nach dem Speichern eine Adresse für Benachrichtigungen (Webhook). Kopieren Sie sie in das Kundenkonto des Zahlungssystems — über diese Adresse meldet es dem Bot die Zahlung. Ohne sie wird der Ausgang „Erfolgreiche Zahlung“ nicht ausgelöst.

> [!WARNING]
> Ist das System nicht verbunden, erhält die Person statt der Rechnung eine Nachricht der Form „Das Zahlungssystem ‚…‘ ist nicht verbunden.“. Verbinden Sie das System, bevor Sie den Bot starten.

### Einstellungen

Die Felder der Blöcke unterscheiden sich leicht, die wichtigsten wiederholen sich aber:

- **„Zahlungszweck“** — wofür die Person bezahlt. Das Feld muss ausgefüllt sein: Mit leerem Zweck stellt der Block keine Rechnung, sondern sendet der Person eine Fehlermeldung.
- **„Zahlungsbeschreibung“** — eine Erläuterung zur Zahlung. Ebenfalls Pflicht.
- **„Betrag“** — wie viel zu zahlen ist. Die Währung wird nicht im Block gewählt: Sie hängt vom Zahlungssystem und seinen Einstellungen in der Integration ab.
- **„Betrag aus einer Benutzervariable lesen“** — schalten Sie das ein, wenn das Szenario den Betrag berechnet. Es erscheint das Feld **„Variablenname“**: Der Block nimmt den Betrag aus dieser Kontaktvariable. Hat der Kontakt die Variable nicht, erhält er die Nachricht „Betrag nicht gefunden. Bitte beginnen Sie von vorn.“.
- **„Geld dem Benutzerkonto gutschreiben“** — nach der Zahlung wird der Betrag dem internen Konto des Kontakts im Bot gutgeschrieben. Von diesem Konto lässt er sich mit dem Block „Vom Kontaktkonto abbuchen“ abbuchen.
- **„Abrechnungsart“** und **„Abrechnungsgegenstand“** — Merkmale für den Kassenbeleg: volle Vorauszahlung oder vollständige Abrechnung, Ware oder Dienstleistung und so weiter. Es gibt sie in den Blöcken der Systeme, die Belegdaten übermitteln.
- **„Chatbot-Nachricht“** — der Text, mit dem der Zahlungslink kommt. Schreiben Sie `{url}` an die Stelle, an der der Link stehen soll. Bleibt das Feld leer, sendet der Bot „Link zur Zahlung: …“.
- **„Name des Zahlungsbuttons“** — die Beschriftung des Buttons, bis zu 30 Zeichen. Anstelle von `{amount}` wird der Betrag eingesetzt. Bleibt das Feld leer, stehen auf dem Button der Betrag und „bezahlen“.

Im Zweck, in der Beschreibung und im Text der Nachricht funktionieren [Platzhalter](https://support.watbot.org/de/chatbots/templates).

![Einstellungen des Zahlungsblocks: Zweck und Beschreibung, Betrag aus einer Variable, Gutschrift auf das Kontaktkonto, Nachricht und Button](https://support.watbot.org/_media/de/01-chatbots/03-blocks/09-payments/_images/payment-settings.webp?v=1791781229)

### Ausgänge

- „Fortsetzen“ — sofort, nachdem der Bot den Zahlungslink gesendet hat. Hier lässt sich gut eine Nachricht „Wir warten auf die Zahlung“ oder eine Erinnerung anschließen.
- „Erfolgreiche Zahlung“ — sobald das Zahlungssystem die Zahlung bestätigt hat. Wird auch dann ausgelöst, wenn die Person inzwischen im Szenario weitergegangen ist.

![Zahlungsblock im Schema: Ausgänge „Erfolgreiche Zahlung“ und „Weiter“](https://support.watbot.org/_media/de/01-chatbots/03-blocks/09-payments/_images/payment-outputs.webp?v=1791781229)

Eigene Ausgänge für eine abgelehnte Zahlung oder eine abgelaufene Rechnung haben die Blöcke nicht.

### Besonderheiten

- Der Link-Button kommt in Telegram, VK, MAX und im Web-Chat an. In den übrigen Kanälen gibt es keinen Button, und der Link geht als Text der Nachricht hinaus. Wenn Sie also eine eigene „Chatbot-Nachricht“ schreiben, vergessen Sie darin `{url}` nicht.
- Einen Betrag von null oder einen negativen Betrag nimmt der Block nicht an: Die Person erhält statt der Rechnung eine Fehlermeldung.
- Über gestellte und bezahlte Rechnungen erhalten Sie Benachrichtigungen — per E-Mail und in die Chats, die in den Einstellungen des Bots im Tab „Benachrichtigungen“ verbunden sind.