Руководство по интеграции

Интеграция через Webhook

Подключение платформы Gupil к сайтам на Tilda, интернет-магазинам и платёжным формам.

1Получение секретного ключа (Webhook Secret)

В личном кабинете Gupil откройте карточку вашего проекта. В блоке настроек скопируйте уникальный секрет проекта. Ваш итоговый адрес для приёма хуков будет иметь вид:

https://gupil.ru/api/webhook/YOUR_WEBHOOK_SECRET

2Настройка приёма заказов из Tilda

В панели управления сайтом Tilda Publishing:

Перейдите в Настройки сайта → Формы → Webhook.
В поле URL укажите ваш вебхук-адрес Gupil.
В параметрах передачи данных выберите отправку данных о платежах (Payment info).
Подключите созданный сервис Webhook ко всем корзинам и платежным формам на страницах.

Gupil автоматически распознает формат данных Tilda (application/x-www-form-urlencoded), регистрирует клиента, производит начисление кэшбэка и приветственных бонусов.

3Прямой вызов API списания бонусов

Если вы используете кастомную форму оплаты, отправьте POST-запрос с действием spend_bonuses:

POST /api/webhook/{webhookSecret}
Content-Type: application/json

{
  "action": "spend_bonuses",
  "payload": {
    "email": "customer@example.com",
    "amount": 300,
    "orderId": "ORDER-5541",
    "description": "Оплата бонусами части заказа"
  }
}

Режим работы проекта (С ботом / Без бота)

В режиме WITH_BOT списание бонусов становится доступным после того, как клиент нажмет /start в Telegram-боте. В режиме WITHOUT_BOT списание работает мгновенно через веб-виджет без необходимости обязательного подключения к Telegram.