Webhook to nowa funkcja umożliwiająca automatyczne otrzymywanie informacji o wpłatach w czasie rzeczywistym oraz integrację z własnymi systemami.

Funkcja została przygotowana z myślą o twórcach, developerach oraz osobach korzystających z automatyzacji, własnych backendów, alertów streamowych i narzędzi analitycznych.

Czym jest webhook?

Webhook to mechanizm powiadomień, który automatycznie wysyła dane do wskazanego adresu URL w momencie wystąpienia określonego zdarzenia.

Zamiast cyklicznie sprawdzać, czy pojawiła się nowa wpłata, system wysyła żądanie HTTP POST bezpośrednio do Twojego endpointu w chwili jej zaksięgowania.

Jak działa webhook?

1. Podajesz adres URL endpointu odbierającego dane (wymagany protokół HTTPS).
2. Zapisujesz konfigurację webhooka w panelu użytkownika.
3. Generowany jest unikalny hash webhooka.
4. Przy każdej wpłacie wysyłane jest żądanie POST z danymi.
5. Endpoint powinien zwrócić odpowiedź HTTP 200.

Jeżeli serwer nie zwróci poprawnej odpowiedzi, wysyłka webhooka zostanie ponowiona maksymalnie pięć razy.

Przykładowy payload webhooka

{
  "settled_at": "2025-12-30T21:56:10.000Z",
  "order_id": "543041BMJT4MNP1",
  "amount": 6000,
  "currency": "PLN",
  "payer_name": "Marcin",
  "message": "Dzięki za super stream!",
  "fundraising_title": "Na Porsche"
}

Opis pól

• settled_at - data i godzina wpłaty (UTC)
• order_id - unikalny identyfikator zamówienia
• amount - kwota wpłaty w groszach
• currency - waluta (np. PLN)
• payer_name - podpis wpłacającego
• message - wiadomość od wpłacającego
• fundraising_title - tytuł zbiórki (opcjonalnie)

Weryfikacja i bezpieczeństwo

Każde żądanie webhooka zawiera unikalny nagłówek x-tipped-signature, który umożliwia weryfikację autentyczności żądania oraz potwierdzenie, że pochodzi ono z systemu.

Zastosowanie

Webhook może być wykorzystany m.in. do:

• automatycznych alertów na streamie,
• integracji z OBS, Streamlabs lub własnymi overlayami,
• wysyłania powiadomień do Discorda lub Slacka,
• tworzenia raportów i systemów księgowych,

Jak skonfigurować webhooka?

Konfiguracja webhooka dostępna jest w panelu użytkownika w zakładce API.
Wystarczy podać adres endpointu i zapisać ustawienia.