ЮKassa: Webhook ЮKassa

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