Webhooki informują Twój serwer o każdej zmianie płatności, zakupu i wypłaty. Dodaj jeden adres na projekt i sprawdzaj podpis przy każdym wywołaniu.
Dodaj adres
- Otwórz projekt i wypełnij pole URL webhooka. Musi to być publiczny adres https.
- Kliknij Zapisz ustawienia, a potem Wyślij test.ping. Panel pokaże, czy Twój serwer go przyjął.
Co wysyłamy
POST z treścią JSON: typ zdarzenia (np. deposit.in_hold, deposit.success, deposit.hold_returned, purchase.accepted lub payout.paid), informację, czy to produkcja czy test, oraz sam obiekt. Wszystkie typy zdarzeń są wymienione w dokumentacji API.
Sprawdź podpis
Każde wywołanie zawiera nagłówek SkinPlata-Signature ze znacznikiem czasu i podpisem HMAC-SHA256 utworzonym Twoim sekretem do podpisywania webhooków. Oblicz go z surowej treści i porównaj, zanim czemukolwiek zaufasz. W dokumentacji API znajdziesz gotowe przykłady.
Odpowiadaj szybko
Odpowiedz dowolnym statusem 2xx w ciągu kilku sekund, a dopiero potem wykonuj wolniejsze operacje. Inne odpowiedzi liczą się jako błąd i ponawiamy próby przez około dwa dni.
Księguj bezpiecznie
- Obsługuj każde zdarzenie raz: to samo zdarzenie może przyjść więcej niż raz.
- Zanim przyznasz wartość po swojej stronie, odczytaj płatność ponownie z API.
- Odbierz wartość, gdy płatność zostanie cofnięta, zobacz Ochrona wymiany i wcześniejsze zwolnienie.
Każda dostawa, odpowiedź i ponowienie są widoczne w sekcji Webhooki w panelu. Jeśli nic nie dociera, zobacz Webhooki nie docierają: co sprawdzić.