Dla programistów

Webhooki

Twoje systemy dowiadują się, co dzieje się w przestrzeni roboczej: podpisane wywołania dla wybranych zdarzeń, z ponowieniami i dziennikiem.

Zdarzenia

  • Partnerzy: utworzony, zaktualizowany, usunięty, zmiana statusu, zmiana poziomu, zmiana menedżera.
  • Metody wypłat: utworzona, zaktualizowana.
  • Zgłoszenia z formularzy: utworzone, zaktualizowane, usunięte.
  • Konwersje: utworzona, zaktualizowana, zmiana statusu.
  • Rozliczenia i płatności: rozliczenie utworzone, zmiana statusu płatności.
  • Oferty: utworzona, zaktualizowana, usunięta; dostęp przyznany, dostęp odebrany.
  • Postbacki: błąd.
  • White labele: utworzony, zaktualizowany, usunięty.

Jak utworzyć

  1. Ustawienia › Dla programistów › Webhooki › Nowy webhook: URL Twojego endpointu i zdarzenia.
  2. Wysyłaj tylko, gdy (opcjonalnie): reguły na polach rekordu, wszystkie albo dowolna, porównanie z wartością, listą albo innym polem.
  3. Co wysyłać: Zgodny (krótkie formy, których oczekuje istniejąca integracja) albo Pełny rekord (każde pole, z wartościami przed i po przy zmianach). Przykład aktualizuje się w trakcie wybierania.
  4. Dodatkowe nagłówki, jeśli Twój endpoint ich potrzebuje.

Sprawdzanie podpisu

Każde wywołanie ma nagłówek Signature: HMAC-SHA256 treści z sekretem podpisu Twojego webhooka. Sekret jest pokazywany raz, przy tworzeniu webhooka; Nowy sekret go zastępuje.

Dostarczanie

  • Wywołanie, na które serwer odpowiedział źle, jest ponawiane.
  • Dziennik dostarczeń pokazuje każde wywołanie, próby i to, co zostało wysłane; Wyślij ponownie powtarza wywołanie.
  • Wyślij test wysyła zdarzenie z Twoim ostatnim prawdziwym rekordem (albo z przykładem).
  • Po 20 błędach z rzędu webhook sam się wstrzymuje i dostajesz powiadomienie. Napraw endpoint, potem kliknij Wznów.

Sprawdzone z aplikacją 18 października 2026