Вебхуки повідомляють ваш сервер про кожну зміну платежів, покупок і виплат. Додайте одну адресу на проєкт і перевіряйте підпис під час кожного виклику.
Додайте адресу
- Відкрийте проєкт і заповніть URL вебхука. Це має бути публічна адреса з https.
- Натисніть Зберегти налаштування, потім Надіслати test.ping. Панель покаже, чи прийняв його ваш сервер.
Що ми надсилаємо
POST-запит із тілом у JSON: тип події (наприклад deposit.in_hold, deposit.success, deposit.hold_returned, purchase.accepted або payout.paid), бойова вона чи тестова, і сам об’єкт. Усі типи подій перелічено в довіднику API.
Перевірте підпис
Кожен виклик містить заголовок SkinPlata-Signature з міткою часу й підписом HMAC-SHA256, створеним вашим секретом підпису вебхуків. Обчисліть підпис за сирим тілом запиту й порівняйте, перш ніж чомусь довіряти. Готові приклади є в довіднику API.
Відповідайте швидко
Дайте відповідь із будь-яким статусом 2xx протягом кількох секунд, а повільну роботу виконуйте потім. Інші відповіді вважаються помилкою, і ми повторюємо спроби близько двох днів.
Зараховуйте безпечно
- Обробляйте кожну подію один раз: та сама подія може надійти кілька разів.
- Перед видачею цінності на своєму боці перечитайте платіж через API.
- Забирайте цінність назад, якщо платіж скасовано, див. Захист трейду та дострокове підтвердження.
Кожну доставку, відповідь на неї та повтори видно в розділі Вебхуки панелі. Якщо нічого не надходить, див. Вебхуки не надходять: що перевірити.