Webhook po płatności
Telefon może po każdej udanej płatności wywołać wybrany przez Ciebie adres, aby Twój własny system dowiedział się o niej. To nie jest webhook Stripe: wywołanie pochodzi z telefonu.
Wywołuj po każdej płatności |
Przełącznik. |
|---|---|
Adres |
Adres HTTPS Twojego odbiorcy, jak w pierwszym przykładzie. Po hoście można używać zmiennych, na przykład {reference}. |
Metoda |
GET, POST lub PUT. Domyślnie POST. |
Format treści |
JSON, FORM lub TEXT. Domyślnie JSON. |
Nagłówki |
Jedno Name: value w wierszu, na przykład dla klucza API lub tokenu. |
Treść (szablon) |
Treść ze zmiennymi. Domyślnie jest to JSON z drugiego przykładu z identyfikatorem płatności, referencją, kwotą, walutą i czasem. |
Sekret podpisu (opcjonalny) |
Jeśli ustawiony, każde wywołanie niesie X-QR2Stripe-Timestamp i X-QR2Stripe-Signature (HMAC-SHA256). |
Kiedy jest wywoływany: raz po każdej udanej płatności, w każdym trybie, z telefonu, gdy aplikacja jest otwarta. Gdy nie ma sieci, aplikacja ponawia próbę, wstawia wywołanie do kolejki i dostarcza je przy następnym uruchomieniu lub gdy dotkniesz Dostarcz teraz. Po 10 próbach wywołanie jest porzucane.
Konfiguracja w aplikacji: Ustawienia sprzedawcy → Webhook po płatności → Skonfiguruj webhook. Włącz Wywołuj po każdej płatności, wpisz adres, dotknij Wyślij wywołanie testowe i Zapisz. Wywołanie testowe wysyła zmyśloną płatność, więc od razu widzisz, czy odbiorca ją przyjmuje.
Odbiorcą może być Twój własny serwer lub narzędzie no-code (n8n, Make, Zapier) z wyzwalaczem webhook. Odpowiadaj szybko statusem 2xx; ta sama płatność może dotrzeć dwa razy, więc rozpoznawaj ją po payment_id.
Zmienne takie jak {reference}, {amount}, {amount_decimal}, {currency} i {payment_id} wstawiają dane płatności (pełna lista jest w specyfikacji). Domyślna treść to JSON z drugiego przykładu.
Ustaw sekret podpisu, aby Twój system mógł sprawdzać podpis każdego wywołania, i nie publikuj adresu. Bez niego każdy, kto zna adres, mógłby przysłać Ci podrobione wywołanie.
Wywołanie pochodzi z telefonu, nie od Stripe. W trybie inline amount_from_qr ma wartość true, co oznacza, że żaden serwer nie zweryfikował kwoty. Zanim wydasz cenny towar, znajdź płatność w 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}
}