· 4 min · TextMeFlow Team

WhatsApp-Zahlungsbestätigung aus Stripe per Webhook senden

Stripe löst für jedes relevante Zahlungsergebnis ein Webhook-Event aus — erfolgreich, fehlgeschlagen, erstattet, angefochten. Der Großteil dieses Signals landet nur in einem E-Mail-Postfach oder einem Slack-Kanal, den dein Kunde nie sieht. Leitest du dieselben Events direkt an WhatsApp weiter, kommt eine Bestätigung bei der Person an, die gezahlt hat — in dem Kanal, den sie ohnehin offen hat, wenige Sekunden nachdem die Zahlung durchgegangen ist. So verbindest du Stripe direkt mit TextMeFlow, ohne Connector-App eines Drittanbieters.

Warum direkt von Stripe zur API

Eine generische „WhatsApp für Stripe"-Integration bedeutet meist ein weiteres Abo, ein weiteres Dashboard und einen weiteren Anbieter, der deine Zahlungsdaten hält. Die Webhooks von Stripe enthalten bereits alles, was du brauchst — Betrag, Währung, Kunde, Zahlungsmethode —, daher kostet ein kleiner Empfänger, der die relevanten Felder an die Messages-API von TextMeFlow weiterreicht, nichts über das Nachrichtenkontingent deines bestehenden Tarifs hinaus. Du behältst die volle Kontrolle über den Text, die Auslöserlogik und darüber, welche Events tatsächlich eine Nachricht verdienen.

Schritt 1: Abonniere die Events, auf die es ankommt

Füge im Stripe Dashboard unter Developers → Webhooks einen Endpunkt hinzu und wähle nur die Events aus, die eine Nachricht an den Kunden erfordern:

  • payment_intent.succeeded → Zahlungsbestätigung
  • payment_intent.payment_failed → Hinweis bei fehlgeschlagener Zahlung (Karte abgelehnt, nicht genug Guthaben)
  • charge.refunded → Erstattungsbestätigung

Widerstehe der Versuchung, jeden Event-Typ von Stripe zu abonnieren. Jedes Event, mit dem du nichts anfängst, ist Ballast, den dein Empfänger herausfiltern muss, und eine aufgeblähte Event-Liste erschwert die Fehlersuche, wenn etwas schiefgeht.

Schritt 2: Webhook verifizieren und auslesen

Stripe signiert jede Payload mit einem Stripe-Signature-Header. Verifiziere ihn, bevor du dem Body vertraust — mit derselben Sorgfalt, die du ohnehin auf die Webhook-Signaturen von TextMeFlow auf dem Rückweg zu deiner App anwenden solltest.

app.post('/webhooks/stripe', express.raw({ type: 'application/json' }), (req, res) => {
  let event;
  try {
    event = stripe.webhooks.constructEvent(
      req.body,
      req.headers['stripe-signature'],
      process.env.STRIPE_WEBHOOK_SECRET
    );
  } catch (err) {
    return res.status(400).send(`signature verification failed: ${err.message}`);
  }

  if (event.type === 'payment_intent.succeeded') {
    const pi = event.data.object;
    const phone = pi.metadata?.customer_phone;
    if (phone) sendPaymentConfirmation(phone, pi);
  }

  res.status(200).send('ok');
});

Das payment_intent-Objekt enthält standardmäßig keine Telefonnummer — die musst du selbst hineinbringen, typischerweise als Metadaten beim Erstellen des PaymentIntent im Checkout. Fragt dein Checkout-Formular keine Telefonnummer ab, hat dieses Muster schlicht nichts, an das es senden könnte; plane das im Checkout ein, nicht erst im Webhook-Handler.

Schritt 3: Die Bestätigung senden

curl -X POST https://api.textmeflow.eu/v1/messages \
  -H "Authorization: Bearer $TEXTMEFLOW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+32470123456",
    "text": "Hallo Sarah, wir haben deine Zahlung von 49,00 € für Rechnung #INV-2091 erhalten. Vielen Dank!"
  }'

Halte den Ton bei einer fehlgeschlagenen Zahlung sachlich statt alarmierend — „deine Zahlung konnte nicht verarbeitet werden, bitte prüfe deine Kartendaten und versuche es erneut" kommt besser an als alles, was nach Warnung klingt. Stellst du Rechnungen separat aus, akzeptiert derselbe Endpunkt Anhänge bis 100 MB, sodass ein PDF-Beleg im selben Aufruf wie der Text mitgehen kann.

Schritt 4: Innerhalb der Anti-Spam-Regeln bleiben

Eine Zahlungsbestätigung ist transaktional — eine personalisierte Nachricht, ausgelöst durch die eigene Handlung eines Kunden — und berührt daher nicht die Broadcast-artigen Auslöser im Anti-Spam-Risiko-Score von TextMeFlow. Zwei Dinge bleiben bei einer Stripe-Integration trotzdem wichtig:

  1. Wiederhole nicht blind. Stripe wiederholt fehlgeschlagene Webhook-Zustellungen selbst nach eigenem Zeitplan; wiederholt dein Empfänger zusätzlich, riskierst du, dieselbe Bestätigung doppelt zu senden. Nutze die Event-id zur Deduplizierung, bevor du die Messages-API aufrufst.
  2. Respektiere STOP. Hat sich ein Kunde zuvor von WhatsApp abgemeldet, hebt eine neue Zahlung das nicht auf — TextMeFlow lehnt Sendungen an abgemeldete Nummern ab, unabhängig davon, wie der Auslöser eingetroffen ist.

Was das gegenüber E-Mail-Belegen bringt

Stripe versendet ohnehin automatisch einen Beleg per E-Mail, die WhatsApp-Nachricht ersetzt ihn also nicht — sie ist das, was der Kunde in den ersten Minuten tatsächlich liest. Zustell- und Lesebestätigungen kommen auf dem eigenen Webhook von TextMeFlow zurück, sodass du weißt, ob die Bestätigung gesehen und nicht nur gesendet wurde. Dasselbe Muster lässt sich auf jedes Abrechnungsereignis übertragen, für das Stripe einen Webhook auslösen kann: Abo-Verlängerungen, Erinnerungen vor dem Ende einer Testphase oder eine Mahnung, bevor eine Karte abläuft.

Starte kostenlos mit TextMeFlow — 50 Nachrichten pro Monat, ohne Zeitlimit, genug, um einen vollständigen Zahlungsbestätigungs-Flow aufzubauen und zu testen, bevor du dich für einen Tarif entscheidest.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis