Ein Webhook ist eine automatische Nachricht, die 1pay.ch an dein System schickt, wenn etwas passiert: eine bestätigte Zahlung, ein verlängertes Abonnement, eine gestartete Auszahlung. So aktualisiert sich dein Shop oder deine Verwaltungssoftware von selbst, ohne manuelle Kontrollen.
Nutzt du das WooCommerce-Plugin, folge dessen Anweisungen: Der nötige Webhook ist dort bereits vorgesehen.
Einen Webhook erstellen #
- Öffne im Menü Webhooks und klicke auf das Hinzufügen eines Webhooks.
- Name (optional): ein Name zum Wiedererkennen, zum Beispiel «Verwaltungssoftware».
- Webhook-URL: die Adresse deines Systems, die die Nachrichten empfängt. Kopiere sie genau, mit
https. - Webhook-Typ: Normal (PHP-Post) oder JSON, wie von deinem System verlangt.
- Webhook-Version: die in den Anweisungen deines Systems oder von deiner Entwicklung genannte.
- Bei Fehler wiederholen: Aktiviere das nur, wenn dein System es verlangt.
- Ereignisse: Wähle, wann die Nachricht gesendet wird:
- Transaction: wenn eine Zahlung entsteht oder ihr Status wechselt;
- Subscription: wenn bei einem Abonnement etwas Wichtiges passiert;
- Payout: wenn eine Auszahlung auf dein Konto startet.
- Verknüpfung mit der Integration (optional): Verbindet den Webhook mit nur einem API-Schlüssel, sodass er nur dessen Ereignisse erhält. Ohne Integration erhält er alle Ereignisse.
- Klicke auf Hinzufügen.
Sicherheit #
Jeder Webhook hat eine eigene geheime Signatur, die mit jeder Nachricht mitgeschickt wird. Dein System kann sie prüfen, um sicher zu sein, dass die Nachricht wirklich von 1pay.ch stammt. Deine Entwicklung weiss, wie das geht.
Technischer Kontakt #
Gib auf derselben Seite Name und E-Mail des technischen Kontakts an: Diese Person wird benachrichtigt, wenn ein Webhook oder eine API-Anfrage fehlschlägt.
Wenn etwas nicht funktioniert #
Unter Log siehst du jede gesendete Nachricht und die Antwort deines Systems. Die häufigsten Ursachen:
- Die URL ist nicht genau so geschrieben, wie dein System sie will (ein Schrägstrich zu viel,
httpstatthttps); - Format oder Version entsprechen nicht den erwarteten;
- Dein Server lehnt die Anfrage ab oder blockiert sie.
Findest du das Problem nicht, schreib uns mit deinem Kontonamen und der Zeit der betroffenen Zahlung.
