Webhook nach der Zahlung
Das Telefon kann nach jeder erfolgreichen Zahlung eine Adresse Ihrer Wahl aufrufen, damit Ihr eigenes System davon erfährt. Es ist nicht der Webhook von Stripe: Der Aufruf kommt vom Telefon.
Nach jeder Zahlung aufrufen |
Der Schalter. |
|---|---|
Adresse |
Die HTTPS-Adresse Ihres Empfängers, wie im ersten Beispiel. Nach dem Host können Variablen wie {reference} verwendet werden. |
Methode |
GET, POST oder PUT. Standard ist POST. |
Format des Bodys |
JSON, FORM oder TEXT. Standard ist JSON. |
Header |
Eine Name: value pro Zeile, zum Beispiel für einen API-Schlüssel oder ein Token. |
Body (Vorlage) |
Der Body mit Variablen. Standard ist das JSON aus dem zweiten Beispiel mit Zahlungs-ID, Referenz, Betrag, Währung und Zeit. |
Signaturgeheimnis (optional) |
Wenn gesetzt, trägt jeder Aufruf X-QR2Stripe-Timestamp und X-QR2Stripe-Signature (HMAC-SHA256). |
Wann er aufgerufen wird: einmal nach jeder erfolgreichen Zahlung, in jedem Modus, vom Telefon aus, solange die App geöffnet ist. Ist das Netz weg, versucht die App es erneut, legt den Aufruf in eine Warteschlange und stellt ihn beim nächsten Start der App zu oder wenn Sie Jetzt zustellen antippen. Nach 10 Versuchen wird der Aufruf aufgegeben.
Einrichten in der App: Händlereinstellungen → Webhook nach der Zahlung → Webhook einrichten. Schalten Sie Nach jeder Zahlung aufrufen ein, geben Sie die Adresse ein und tippen Sie auf Testaufruf senden und Speichern. Der Testaufruf sendet eine erfundene Zahlung, sodass Sie sofort sehen, ob der Empfänger sie annimmt.
Der Empfänger kann Ihr eigener Server oder ein No-Code-Werkzeug (n8n, Make, Zapier) mit einem Webhook-Auslöser sein. Antworten Sie schnell mit einem 2xx-Status; dieselbe Zahlung kann zweimal eintreffen, erkennen Sie sie daher an payment_id.
Variablen wie {reference}, {amount}, {amount_decimal}, {currency} und {payment_id} füllen die Daten der Zahlung ein (die vollständige Liste steht in der Spezifikation). Der Standard-Body ist das JSON aus dem zweiten Beispiel.
Setzen Sie ein Signaturgeheimnis, damit Ihr System die Signatur jedes Aufrufs prüfen kann, und veröffentlichen Sie die Adresse nicht. Ohne es könnte jeder, der die Adresse kennt, Ihnen einen gefälschten Aufruf senden.
Der Aufruf kommt vom Telefon, nicht von Stripe. Im Inline-Modus ist amount_from_qr gleich true, das heißt, kein Server hat den Betrag geprüft. Bevor Sie wertvolle Ware herausgeben, suchen Sie die Zahlung im Stripe Dashboard.
https://example.com/hook
{
"event": "payment.succeeded",
"payment_id": "{payment_id}",
"reference": "{reference}",
"description": "{description}",
"amount": {amount},
"currency": "{currency}",
"merchant": "{merchant}",
"site": "{site}",
"paid_at": "{paid_at}",
"amount_from_qr": {amount_from_qr}
}