WhatsApp-Zahlungsbestätigung per PayPal-Webhook
PayPal ist für viele Webshops und die Rechnungsstellung von Freelancern immer noch der Standard-Bezahlbutton, doch die Bestätigungs-E-Mail geht in einem vollen Posteingang leicht unter. Die Webhooks-API von PayPal meldet dir bereits in dem Moment, in dem eine Zahlung abgeschlossen, abgelehnt oder erstattet wird, Bescheid – was fehlt, ist der Schritt, dieses Ereignis in eine Nachricht zu verwandeln, die dein Kunde auch wirklich sieht. So verbindest du PayPal direkt mit der TextMeFlow-API, ganz ohne zwischengeschaltetes Automatisierungstool eines Drittanbieters.
Warum direkt von PayPal zur API
PayPal unterstützt Webhooks seit Jahren, aber die meisten „WhatsApp für PayPal"-Setups laufen über eine generische Automatisierungsplattform, die eigene Verzögerung, ein eigenes Dashboard und einen Mittelsmann mit deinen Zahlungsdaten hinzufügt. Die Webhook-Payload von PayPal enthält bereits Namen des Zahlers, Betrag, Währung und Transaktions-ID – genug, um mit einem kleinen Empfängerskript eine Bestätigungsnachricht zu bauen. Dieses Skript sendet an die Nachrichten-API von TextMeFlow, sodass die einzigen laufenden Kosten das Nachrichtenkontingent deines bestehenden Tarifs sind.
Schritt 1: Die richtigen Ereignistypen abonnieren
Füge im PayPal Developer Dashboard unter den Webhooks-Einstellungen deiner App eine Endpunkt-URL hinzu und wähle nur die Ereignisse aus, die eine Nachricht an den Kunden wert sind:
PAYMENT.CAPTURE.COMPLETED– ZahlungsbestätigungPAYMENT.CAPTURE.DENIED– Benachrichtigung über fehlgeschlagene ZahlungPAYMENT.CAPTURE.REFUNDED– ErstattungsbestätigungCUSTOMER.DISPUTE.CREATED– interne Benachrichtigung, nicht für den Kunden – leite sie stattdessen an die Nummer deines eigenen Teams weiter
Alle verfügbaren Ereignistypen zu abonnieren bedeutet nur, dass du später das Rauschen herausfiltern musst. Wähle die Handvoll Ereignisse, die einer Nachricht entsprechen, die du tatsächlich senden willst.
Schritt 2: Den Webhook prüfen, bevor du ihm vertraust
PayPal signiert jeden Webhook mit einem Zertifikat und einer Übertragungssignatur (PAYPAL-TRANSMISSION-SIG, PAYPAL-CERT-URL, PAYPAL-TRANSMISSION-ID), die du über den Endpunkt /v1/notifications/verify-webhook-signature von PayPal verifizierst. Überspringe diesen Schritt niemals – eine ungeprüfte Webhook-URL ist ein öffentlicher Endpunkt, an den jeder POSTen kann. Dieselbe Sorgfalt gilt in der Gegenrichtung: Prüfe immer die HMAC-Signatur der TextMeFlow-eigenen Webhooks, bevor du auf ein eingehendes Ereignis reagierst.
app.post('/webhooks/paypal', express.json(), async (req, res) => {
const verified = await verifyPaypalSignature(req.headers, req.body);
if (!verified) return res.status(400).send('signature verification failed');
const event = req.body;
if (event.event_type === 'PAYMENT.CAPTURE.COMPLETED') {
const capture = event.resource;
const phone = capture.custom_id; // see step 3 on where this comes from
if (phone) await sendPaymentConfirmation(phone, capture);
}
res.status(200).send('ok');
});
Schritt 3: Eine Telefonnummer in die Payload bekommen
Das Capture-Objekt von PayPal enthält standardmäßig keine Telefonnummer. Der zuverlässige Weg, eine in den Webhook zu bekommen, ist, sie beim Erstellen der Bestellung als custom_id (oder in purchase_units[].custom_id) zu setzen, bevor du den Käufer zu PayPal weiterleitest – entnommen aus deinem Checkout-Formular oder deinem eigenen Kundendatensatz. Ohne diesen Schritt wird der Webhook zwar ausgelöst, aber dein Empfänger hat keine Nummer, an die er eine Nachricht senden könnte. Das Problem muss also beim Checkout gelöst werden, nicht im Webhook-Handler.
Schritt 4: 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 PayPal-Zahlung über 49,00 € für Bestellung #ORD-3312 erhalten. Vielen Dank für deinen Einkauf!"
}'
Halte den Ton bei einer abgelehnten Zahlung praktisch statt alarmierend – „deine PayPal-Zahlung konnte nicht abgeschlossen werden, bitte versuche es erneut oder nutze eine andere Karte" kommt besser an als alles, was wie eine Warnung klingt. Wenn du neben dem Text auch eine PDF-Quittung mitschickst, akzeptiert derselbe Endpunkt Anhänge bis 100 MB in einem Aufruf.
Schritt 5: Wiederholungen und Opt-outs korrekt behandeln
Zwei Dinge sind speziell bei einer PayPal-Integration wichtig:
- Dedupliziere anhand der Webhook-ID. PayPal wiederholt nicht zugestellte Webhooks nach einem eigenen Zeitplan. Hat dein Empfänger zusätzlich eine eigene Retry-Logik, kann dieselbe Bestätigung doppelt versendet werden – speichere das
id-Feld des Webhooks und überspringe alles, was bereits verarbeitet wurde. - Respektiere STOP. Eine Zahlung hebt ein früheres Opt-out nicht auf. TextMeFlow blockiert Sendungen an eine Nummer, die sich abgemeldet hat, unabhängig davon, welches Ereignis den Versand ausgelöst hat – sieh dir an, wie die STOP-Verarbeitung in die übergeordnete Anti-Spam-Pipeline passt.
Eine Zahlungsbestätigung ist eine transaktionale Eins-zu-eins-Nachricht, die durch die eigene Handlung des Kunden ausgelöst wird, und liegt damit außerhalb der Broadcast-artigen Prüfungen, die für Massenversand gelten – STOP und Deduplizierung gelten aber für jede Nachricht, unabhängig vom Auslöser.
Mehr als die Bestätigungs-E-Mail
PayPal verschickt bereits eine Quittung per E-Mail, sobald ein Capture abgeschlossen ist – das hier ist also kein Ersatz, sondern die Nachricht, die dein Kunde in den ersten Minuten nach der Zahlung tatsächlich liest. Zustell- und Lesebestätigungen kommen über den eigenen Webhook von TextMeFlow zurück, sodass du erkennst, ob eine Bestätigung gesehen und nicht nur gesendet wurde. Dasselbe Empfängermuster lässt sich auf Abrechnungsereignisse für Abonnements erweitern, wenn du PayPal für wiederkehrende Zahlungen nutzt, oder auf eine Nachricht „Erstattung veranlasst", wenn bei dir eine Rücksendung bearbeitet wird.
Kostenlos mit TextMeFlow starten – 50 Nachrichten pro Monat, ohne Zeitlimit, genug, um einen kompletten PayPal-Bestätigungsablauf zu bauen und zu testen, bevor du dich für einen kostenpflichtigen 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