Webhooks und Zahlungsabgleich

1. Funktionsweise

Das Webhook-System arbeitet polling-basiert:

1. VR Pay sendet Zahlungsbenachrichtigungen an den Lizenzserver.
2. Der Lizenzserver speichert die Webhooks.
3. Business Central ruft die Webhooks regelmäßig ab.
4. Die Transaktionen werden aktualisiert.

VR Pay → Lizenzserver → Business Central
         (Webhook)      (Polling alle 5 Min)

2. Automatischer Webhook-Abruf

2.1 Einrichten

1. Öffnen Sie "VRPay Setup" / "VR Pay Einrichtung".
2. Klicken Sie auf "Aktionen" "Automatischen Webhook-Abruf einrichten".
3. Ein Job Queue Entry wird erstellt (alle 5 Minuten).

2.2 Prüfen ob aktiv

1. Suchen Sie nach "Aufgabenwarteschlangenposten".
2. Suchen Sie nach "VR Pay Webhook-Abruf".
3. Status sollte "Bereit" oder "In Bearbeitung" sein.

2.3 Manueller Abruf

Im "VR Pay Setup" / "VR Pay Einrichtung" klicken Sie auf "Aktionen" in der Aktionsleiste und anschließend auf "Webhooks abrufen". So können Sie nun auch den Abruf der Webhooks manuell vornehmen.

3. Webhook-Verarbeitung

Wenn ein Webhook empfangen wird:

1. Transaktion suchen: Anhand der Transaction ID
2. Status aktualisieren: Auf "Bezahlt" setzen
3. Betrag speichern: Aus dem Webhook extrahiert
4. Webhook bestätigen: ACK an Lizenzserver senden
5. Zähler erhöhen: Webhook-Nutzung +1

4. VR Pay Webhook-Struktur

VR Pay sendet Webhooks im folgenden Format:

{
  "transaction": {
    "uuid": "f9b158ac",
    "amount": 23050,
    "status": "confirmed",
    "invoice": {
      "number": "103215",
      "currency": "EUR"
    }
  }
}

Extrahierte Felder

Webhook-Feld	BC-Feld	Beschreibung
transaction.uuid	Transaction ID	Eindeutige Transaktions-ID
transaction.invoice.number	Reference ID / Source No.	Rechnungsnummer
transaction.amount	Amount	Betrag in Cents (wird durch 100 geteilt)
transaction.status	Status	"confirmed" → Bezahlt

5. Transaktionsübersicht

Wo finden Sie alle VR Pay Transaktionen?

• In der Aktionsleiste vin Business Central unter "VR Pay Transaktionen".

• Oder im VRPay Setup "Navigieren" "Transaktionen"

Transaktionsstatus

Status	Bedeutung
Ausstehend	Warte auf Zahlung
Reserviert	Betrag reserviert
Autorisiert	Zahlung autorisiert
Bezahlt	Zahlung erfolgreich abgeschlossen
Erstattet	Vollständig zurückerstattet
Teilweise erstattet	Teilweise zurückerstattet
Storniert	Abgebrochen
Fehlgeschlagen	Fehler bei Zahlung
Abgelaufen	Zahlungslink abgelaufen

6. Zahlung verbuchen

Nachdem eine Zahlung als "Bezahlt" markiert wurde:

1. Öffnen Sie "Verkauf" "Gebuchte Verkaufsrechnung"
2. Klicken Sie auf "Zugehörig" "VR Pay" "Zahlung erfassen"
3. Die Zahlung wird verbucht und mit der Rechnung ausgeglichen.