Stripe-Zahlungen: Push-Benachrichtigung aufs iPhone

Verbinde Stripe mit Honk, und jede fehlgeschlagene Zahlung, jede Rückbuchung (bei Stripe „Anfechtung“, englisch dispute) und jede fehlgeschlagene Auszahlung kommt als Push auf dein iPhone. Auf Wunsch gibt es für jeden Verkauf ein Tüt-tüt dazu. Code brauchst du dafür nicht: Stripe schickt seine Ereignisse an eine einzige URL, und Honk prüft die Signatur von Stripe, gibt jedem Ereignis eine Stufe auf der Honk-Skala und bündelt Wiederholungen.

Zahlungsprobleme landen im selben Posteingang wie dein Shop, deine Website und deine Server. Wird die Karte eines Kunden fünfmal hintereinander abgelehnt, ist das eine Gruppe mit Zähler, nicht fünf einzelne Alarme.

Voraussetzungen

• Ein Honk-Konto. Honk gibt es vorerst nur auf Einladung: Zugang anfragen.
• Ein Projekt für Zahlungen, zum Beispiel „Shop“, in einem Workspace, in dem du Inhaber oder Admin bist.
• Ein Stripe-Konto, in dem du Webhooks anlegen darfst.

1. Die Verbindung in Honk anlegen

Öffne in der Honk-Web-App das Projekt, geh zu Verbindungen und klick auf Dienst verbinden. Wähle Stripe, behalte den Namen oder ändere ihn, und klick auf Verbinden.

Honk zeigt die Webhook-URL der Verbindung. Sie beginnt mit https://honk-honk.app/v1/hooks/stripe/. Kopiere sie und lass die Seite offen: In Schritt 3 fügst du hier den Signaturschlüssel von Stripe ein.

2. Ein Ereignisziel in Stripe anlegen

Öffne im Stripe-Dashboard Workbench ▸ Webhooks und klick auf Create an event destination. Die Beschriftungen stammen aus dem englischsprachigen Dashboard. Dann:

• Wähle Your account und als Payload-Format Snapshot. Honk liest Snapshot-Ereignisse, also das Format, das die Zahlung selbst mitliefert. Stripe empfiehlt Thin, aber ein Thin-Ereignis enthält nur eine ID: Honk weist es ab, und die Verbindung zeigt einen Fehler.
• Wähle die Ereignisse: payment_intent.payment_failed, invoice.payment_failed, charge.dispute.created und payout.failed. Für Verkäufe kommt checkout.session.completed oder payment_intent.succeeded dazu, für Erstattungen charge.refunded, für Kündigungen customer.subscription.deleted.
• Wähle Webhook endpoint als Zieltyp und füge die URL von Honk als Endpoint URL ein.

Nimm nur eines der beiden Verkaufsereignisse, nicht beide. Eine Zahlung über Stripe Checkout löst beide aus, und du bekämst jeden Verkauf doppelt gemeldet.

3. Den Signaturschlüssel in Honk einfügen

Auf der Seite des neuen Ziels zeigt Stripe einen Signaturschlüssel, der mit whsec_ beginnt. Klick auf Reveal secret und kopiere ihn. Füge ihn in Honk bei Signaturschlüssel ein und klick auf Schlüssel speichern.

Bis der Schlüssel gespeichert ist, weist Honk die Zustellungen von Stripe ab. Danach prüft es die Signatur jeder Zustellung: Was nicht passt oder vor mehr als 5 Minuten signiert wurde, wird nie zur Nachricht.

4. In einer Sandbox ausprobieren

Eine Stripe-Sandbox hat eigene Ereignisziele und Signaturschlüssel und braucht deshalb eine eigene Verbindung in Honk. Leg auf dieselbe Weise eine zweite Verbindung an, richte das Ziel in der Sandbox ein und sende mit der Stripe CLI ein Testereignis:

# with the Stripe CLI, signed in to the sandbox
stripe trigger payment_intent.payment_failed

Nach wenigen Sekunden kommt ein Lautes Hupen an. Sandbox-Ereignisse tragen die Umgebung test und landen deshalb nie in einer Gruppe mit Live-Ereignissen. Im Free-Tarif ist die Sandbox-Verbindung deine zweite und letzte: Lösch sie wieder, sobald du gesehen hast, dass alles klappt. Im Livemodus zeigt die Verbindung, wann Stripe zuletzt etwas zugestellt hat, oder den letzten Fehler, etwa eine Signatur, die nicht gepasst hat.

Was aus jedem Ereignis wird

• Eine fehlgeschlagene Zahlung (payment_intent.payment_failed) oder eine fehlgeschlagene Rechnungszahlung (invoice.payment_failed): ein Lautes Hupen mit dem Titel „Payment failed: 49.00 EUR“, dazu der Grund von Stripe und der Kunde. Jeder Kunde hat seine eigene Gruppe, wiederholte Fehlschläge eines Kunden landen also in derselben Gruppe.
• Eine neue Rückbuchung (charge.dispute.created): ein Langes Hupen, mit Betrag und Grund.
• Eine fehlgeschlagene Auszahlung (payout.failed): ein Langes Hupen, mit der Erklärung von Stripe.
• Ein Verkauf (checkout.session.completed oder payment_intent.succeeded): ein Tüt-tüt, „New sale: 49.00 EUR“ oder „Payment received: 49.00 EUR“. Alle Verkäufe teilen sich eine Gruppe.
• Eine Erstattung (charge.refunded): ein Leichtes Hupen, „Payment refunded: 49.00 EUR“ oder bei einer Teilerstattung „Partial refund: 20.00 EUR“, mit dem erstatteten Anteil der Zahlung. Die Erstattungen eines Kunden landen in einer Gruppe.
• Ein gekündigtes Abo (customer.subscription.deleted): ein Leichtes Hupen.

Andere Ereignistypen nimmt Honk an und verwirft sie. Beträge stehen in der Haupteinheit der Währung, und die meisten Nachrichten verlinken auf die Zahlung, die Rückbuchung, die Auszahlung oder das Abo im Stripe-Dashboard.

Das erste Ereignis einer Gruppe wird sofort gepusht. Weitere derselben Art kommen als Update mit dem aktuellen Zähler, höchstens eines alle 5 Minuten. Nach 24 Stunden ohne Ereignisse (die Voreinstellung) fängt eine Gruppe von vorn an, und das nächste Ereignis wird wieder gepusht. Stripe meldet nie, dass eine fehlgeschlagene Zahlung erledigt ist. Deshalb sind das Ereignisse, keine Vorfälle: Auf eine Entwarnung wartest du hier nicht. Schlagen innerhalb weniger Minuten Zahlungen mehrerer Kunden fehl, wird jede trotzdem gepusht, aber nur die erste mit Ton.

Wählen, worüber du informiert wirst

Jeder Ereignistyp oben ist standardmäßig eingeschaltet. Entferne bei der Verbindung unter Ereignisse, die zu Nachrichten werden den Haken bei denen, die du nicht willst, zum Beispiel bei den Verkäufen, und klick auf Speichern.

Sollen Verkäufe keinen Push auslösen, aber sichtbar bleiben, leg im Projekt unter Regeln eine Regel an: Wenn Kanal gleich payment_intent.succeeded (oder checkout.session.completed) ist, stell Mitteilungen auf Nur Zusammenfassung. Verkäufe kommen dann gesammelt in einer Zusammenfassung, standardmäßig alle 15 Minuten, während Rückbuchungen und fehlgeschlagene Auszahlungen weiter sofort gepusht werden.

Tarife und Limits

Jede Verbindung zählt zum Tarif deines Workspaces: Free enthält 2, Pro 20 und Team 100. Nachrichten von Stripe zählen wie alle anderen zu den täglichen Limits des Tarifs für Nachrichten und Pushes; die Preise listen sie auf.

Pushes kommen in Honk für iPhone und auf deiner Apple Watch an. Verkaufst du auch über Shopify oder WooCommerce, bringen die Shopify-Anleitung und die WooCommerce-Anleitung die Bestellungen in denselben Posteingang, und die Seite Integrationen zeigt alle anderen Wege, Honk etwas zu schicken.