{"id":8718,"date":"2026-10-20T09:32:00","date_gmt":"2026-10-20T07:32:00","guid":{"rendered":"https:\/\/www.1pay.ch\/docs\/webhooks-benachrichtigung\/"},"modified":"2026-11-06T09:03:36","modified_gmt":"2026-11-06T08:03:36","password":"","slug":"webhooks-benachrichtigung","status":"publish","type":"docs","link":"https:\/\/www.1pay.ch\/de\/docs\/webhooks-benachrichtigung\/","title":{"rendered":"Webhooks: dein System bei jeder Zahlung benachrichtigen"},"content":{"rendered":"

Ein Webhook ist eine automatische Nachricht, die 1pay.ch an dein System schickt, wenn etwas passiert: eine best\u00e4tigte Zahlung, ein verl\u00e4ngertes Abonnement, eine gestartete Auszahlung. So aktualisiert sich dein Shop oder deine Verwaltungssoftware von selbst, ohne manuelle Kontrollen.<\/p>\n

Nutzt du das WooCommerce<\/a>-Plugin, folge dessen Anweisungen: Der n\u00f6tige Webhook ist dort bereits vorgesehen.<\/p>\n

Einen Webhook erstellen<\/h2>\n
    \n
  1. \u00d6ffne im Men\u00fc Webhooks<\/strong> und klicke auf das Hinzuf\u00fcgen eines Webhooks.<\/li>\n
  2. Name (optional)<\/strong>: ein Name zum Wiedererkennen, zum Beispiel \u00abVerwaltungssoftware\u00bb.<\/li>\n
  3. Webhook-URL<\/strong>: die Adresse deines Systems, die die Nachrichten empf\u00e4ngt. Kopiere sie genau, mit https<\/code>.<\/li>\n
  4. Webhook-Typ<\/strong>: Normal (PHP-Post) oder JSON, wie von deinem System verlangt.<\/li>\n
  5. Webhook-Version<\/strong>: die in den Anweisungen deines Systems oder von deiner Entwicklung genannte.<\/li>\n
  6. Bei Fehler wiederholen<\/strong>: Aktiviere das nur, wenn dein System es verlangt.<\/li>\n
  7. Ereignisse<\/strong>: W\u00e4hle, wann die Nachricht gesendet wird:\n
      \n
    • Transaction<\/strong>: wenn eine Zahlung entsteht oder ihr Status wechselt;<\/li>\n
    • Subscription<\/strong>: wenn bei einem Abonnement etwas Wichtiges passiert;<\/li>\n
    • Payout<\/strong>: wenn eine Auszahlung auf dein Konto startet.<\/li>\n<\/ul>\n<\/li>\n
    • Verkn\u00fcpfung mit der Integration (optional)<\/strong>: Verbindet den Webhook mit nur einem API-Schl\u00fcssel, sodass er nur dessen Ereignisse erh\u00e4lt. Ohne Integration erh\u00e4lt er alle Ereignisse.<\/li>\n
    • Klicke auf Hinzuf\u00fcgen<\/strong>.<\/li>\n<\/ol>\n

      Sicherheit<\/h2>\n

      Jeder Webhook hat eine eigene geheime Signatur, die mit jeder Nachricht mitgeschickt wird. Dein System kann sie pr\u00fcfen, um sicher zu sein, dass die Nachricht wirklich von 1pay.ch stammt. Deine Entwicklung weiss, wie das geht.<\/p>\n

      Technischer Kontakt<\/h2>\n

      Gib auf derselben Seite Name und E-Mail des technischen Kontakts<\/strong> an: Diese Person wird benachrichtigt, wenn ein Webhook oder eine API-Anfrage fehlschl\u00e4gt.<\/p>\n

      Wenn etwas nicht funktioniert<\/h2>\n

      Unter Log<\/strong> siehst du jede gesendete Nachricht und die Antwort deines Systems. Die h\u00e4ufigsten Ursachen:<\/p>\n

        \n
      • Die URL ist nicht genau so geschrieben, wie dein System sie will (ein Schr\u00e4gstrich zu viel, http<\/code> statt https<\/code>);<\/li>\n
      • Format oder Version entsprechen nicht den erwarteten;<\/li>\n
      • Dein Server lehnt die Anfrage ab oder blockiert sie.<\/li>\n<\/ul>\n

        Findest du das Problem nicht, schreib uns mit deinem Kontonamen und der Zeit der betroffenen Zahlung.<\/p>\n","protected":false},"excerpt":{"rendered":"

        Ein Webhook ist eine automatische Nachricht, die 1pay.ch an dein System schickt, wenn etwas passiert: eine best\u00e4tigte Zahlung, ein verl\u00e4ngertes 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\u00f6tige Webhook ist dort bereits vorgesehen. Einen Webhook erstellen \u00d6ffne […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[195],"doc_tag":[],"class_list":["post-8718","docs","type-docs","status-publish","hentry","doc_category-integrationen"],"acf":[],"year_month":"2026-11","word_count":327,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"1pay.ch","author_nicename":"1pay_admin","author_url":"https:\/\/www.1pay.ch\/de\/author\/1pay_admin\/"},"doc_category_info":[{"term_name":"Integrationen","term_url":"https:\/\/www.1pay.ch\/de\/docs-category\/integrationen\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/docs\/8718","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/comments?post=8718"}],"version-history":[{"count":5,"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/docs\/8718\/revisions"}],"predecessor-version":[{"id":9579,"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/docs\/8718\/revisions\/9579"}],"wp:attachment":[{"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/media?parent=8718"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/doc_category?post=8718"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.1pay.ch\/de\/wp-json\/wp\/v2\/doc_tag?post=8718"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}