AIKraft/AI/Войти
AIKraft/Skills/Интеграция вебхуков

Интеграция вебхуков

Complete guide for setting up and handling Dodo Payments webhooks for real-time payment event notifications.

dodopayments official Другое

Что делает навык

Настройка и обработка вебхуков Dodo Payments для получения уведомлений о платёжных событиях в реальном времени. Позволяет автоматизировать рабочие процессы, обновлять базы данных и синхронизировать системы, обеспечивая безопасность через проверку подписи.

Когда применять

  • Создание конечной точки (endpoint) для приема событий платежей, подписок или возвратов.
  • Реализация проверки криптографической подписи для подтверждения подлинности запросов от Dodo.
  • Обработка конкретных типов событий, таких как успешная оплата, продление подписки или возврат средств.
  • Тестирование вебхуков локально во время разработки с использованием тестовых режимов.

Как работает

  1. Создать вебхук в панели разработчика, указав HTTPS-URL и выбрав необходимые события, затем скопировать секрет подписи.
  2. Сохранить секрет подписи в переменной окружения DODO_PAYMENTS_WEBHOOK_KEY или передать её явно при инициализации клиента.
  3. Настроить сервер для получения сырого тела запроса (raw body) до парсинга JSON, чтобы сохранить исходные байты для верификации.
  4. Использовать метод unwrap() SDK (или стандартный пакет standardwebhooks) для проверки заголовков webhook-id, webhook-signature и webhook-timestamp.
  5. Обработать событие после успешной верификации, обеспечив идемпотентность обработки для предотвращения дублирования при повторных попытках доставки.

Примеры запросов агенту

Настрой вебхук-эндпоинт на Express.js с проверкой подписи Dodo Payments.
Обработай событие payment.succeeded и отправь подтверждение клиенту.
Проверь подлинность входящего вебхука от Dodo, используя Python FastAPI и SDK.

Что понадобится

  • Переменная окружения DODO_PAYMENTS_WEBHOOK_KEY (секрет подписи).
  • Переменная окружения DODO_PAYMENTS_API_KEY (bearer token).
  • HTTPS-эндпоинт для приема запросов (обязательно для продакшена).

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «webhook-integration» из репозитория: # https://github.com/dodopayments/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r webhook-integration/ ~/.claude/skills/webhook-integration/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.