Вебхуки сообщают вашему серверу о каждом изменении платежей, покупок и выплат. Добавьте один адрес на проект и проверяйте подпись при каждом вызове.
Добавьте адрес
- Откройте проект и заполните 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.
- Забирайте ценность обратно, если платёж откачен, см. Защита трейда и досрочное подтверждение.
Каждая доставка, ответ на неё и повторы видны в разделе Вебхуки личного кабинета. Если ничего не приходит, см. Вебхуки не приходят: что проверить.