Auf dieser Seite
Testen
Den echten Weg von Sandbox-Rechnung und Webhook-Zustellung aus dem interaktiven Playground der Dokumentation durchspielen.
Der Playground durchläuft den echten Sandbox-Weg. Er erstellt eine Rechnung über die Händler-API, bestätigt deren Zahlungsauswahl, löst das gewählte Sandbox-Ergebnis aus und wartet, bis der Zustell-Worker Ihren aktiven Endpunkt aufruft.
Er sendet kein erfundenes Ereignis direkt an Ihre URL. Verarbeitet wird das Ereignis von derselben Outbox und demselben Code für Signatur, Zeitgrenze, Wiederholung und Zustellung, den auch der normale Sandbox-Betrieb nutzt.
Voraussetzungen
- Schalten Sie das Dashboard auf Sandbox.
- Wählen Sie ein Projekt mit mindestens einem aktivierten Test-Token.
- Legen Sie einen aktiven Sandbox-Payment-Schlüssel an.
- Registrieren Sie einen aktiven Sandbox-Webhook-Endpunkt.
- Machen Sie den HTTPS-Endpunkt aus dem öffentlichen Internet erreichbar.
Das Senden in der Produktion ist im Playground bewusst deaktiviert.
Verfügbare Szenarien
| Szenario | Ausgelöstes Ereignis |
|---|---|
| Exakte Zahlung | invoice.paid |
| Überzahlung | invoice.paid_over |
| Endgültige Unterzahlung | invoice.underpaid |
| Stornierung | invoice.cancelled |
Öffnen Sie Dashboard → Entwickler → Dokumentation — dieselbe Seite, dort jedoch mit dem Tab Playground über der Anleitung. Wählen Sie Ereignistyp, Betrag und Währung und klicken Sie auf Simulieren. Das Antwortfeld zeigt den abschließenden Aufruf der Händler-API. Der Zustellstatus erscheint, sobald Paymos den Webhook-Versuch registriert hat.
Einen Test auswerten
Öffnen Sie Dashboard → Entwickler → Webhooks, um das Ereignis und jeden Zustellversuch zu prüfen. Vergleichen Sie zuerst diese Werte:
X-Webhook-Idgegenevent_idim Payload.- Den empfangenen Rohtext gegen die Bytes, die Sie an Ihre Prüfung übergeben.
- Antwortstatus und Antwortzeit des Endpunkts gegen die Zustellregeln.
- Das Sandbox-Geheimnis des Endpunkts gegen das Geheimnis, das Ihr Server verwendet.
Nachdem Sie einen fehlgeschlagenen Empfänger repariert haben, spielen Sie das Ereignis aus seiner Detailansicht erneut ein. Beim erneuten Einspielen bleibt die Ereigniskennung gleich, Ihre Idempotenz-Absicherung greift also weiterhin.