---
name: ru-yookassa-webhooks
description: Webhook ЮKassa для российского сервиса ЮKassa
version: 1.0.0
source: https://yookassa.ru/developers
---

# Webhook ЮKassa

Используй этот скилл, когда пользователь просит выполнить задачу в ЮKassa: Обработать уведомление и перепроверить объект через API перед изменением заказа.

## Перед началом

1. Открой актуальную официальную документацию: https://yookassa.ru/developers
2. Уточни целевой аккаунт, объект, период и ожидаемый результат.
3. Проверь авторизацию: shopId и секретный ключ либо OAuth-токен.
4. Никогда не проси вставлять секрет в чат и не выводи его в команды, логи или ответ.

## Порядок работы

1. Сначала выполни доступный read-only запрос и проверь идентификаторы объектов.
2. Учитывай пагинацию, лимиты, актуальную версию API и повтор с backoff для 429/5xx.
3. Выполни задачу: Обработать уведомление и перепроверить объект через API перед изменением заказа.
4. Для повторяемой записи используй идемпотентность либо предварительную проверку текущего состояния.
5. После изменения перечитай объект через API и сравни фактическое состояние с запросом пользователя.
6. Верни краткий отчёт: что изменено, идентификаторы, ошибки и что осталось сделать вручную.

## Ограничения безопасности

- Перед удалением, публикацией, денежной операцией, запуском рекламы или необратимой сменой статуса получи явное подтверждение.
- Не расширяй права токена и не работай с аккаунтами, которые пользователь не указал.
- Не обходи модерацию, тарифные ограничения, rate limits и правила обработки персональных данных.
- Если документация расходится с памятью или примером, следуй текущей официальной документации.

## Источник

- https://yookassa.ru/developers