Hitly

Правила платформы

Как работает Hitly для клиентов и бизнесов-партнёров

Для клиентов

Если вы перешли по ссылке от агента Hitly

Что такое Hitly?

Hitly — платформа, которая соединяет B2B-сервисы с агентами-продавцами. Агент помогает вам найти и подключить нужный сервис, а взамен получает комиссию от сервиса (не от вас).

Как это работает для вас:

  1. Вы получили ссылку — агент порекомендовал вам B2B-сервис (лидогенерацию, CRM, телефонию и т.д.)
  2. Вы перешли по ссылке — ваш визит зафиксирован в системе. Cookie хранится 90 дней.
  3. Вы оплатили сервис — агент автоматически получает комиссию от сервиса. Для вас цена не меняется.

Важно для клиента:

  • Вы платите ту же цену, что и без агента
  • Агент не имеет доступа к вашим данным оплаты
  • Вы можете обратиться к агенту за помощью в настройке сервиса
  • Cookie можно удалить в любой момент через настройки браузера

Для бизнесов-партнёров

Если вы хотите разместить свой продукт на Hitly

Зачем размещаться на Hitly?

Вы получаете готовую сеть обученных агентов, которые продают ваш продукт. Не нужно строить свой отдел продаж, настраивать рекламу или нанимать сейлзов.

Как подключить свой продукт:

  1. Регистрация — заполните заявку бизнес-аккаунта и подтвердите контактный телефон. Модератор проверяет заявку и открывает работу с офферами.
  2. Настройка оффера — в кабинете указываете:
    • Процент или фиксированную комиссию для агентов
    • Шаблон ссылки для редиректа с макросом {code}
    • Описание и категорию оффера
  3. Интеграция (Postback API) — выпускаете API-ключ в разделе «Интеграция» и сообщаете нам о событиях по клиенту:

    POST https://hitly.ru/api/postback

    # X-Api-Key: ваш_ключ

    # При оплате отправляете:

    {

    "lead_key": "код_заявки_из_ссылки",

    "status": "paid",

    "name": "Иван Петров",

    "phone": "+71234567890",

    "amount": 150000,

    "order_id": "ваш_номер_заказа"

    }

  4. Запуск — после модерации оффер появляется в витрине, агенты начинают продавать

Модель оплаты для бизнеса:

  • Плата за размещение — ежемесячная подписка за присутствие в витрине
  • Процент с продаж — небольшой % с каждой продажи через агентов
  • Комиссию агенту платите вы, не клиент

Трекинг и прозрачность:

  • Переход клиента по ссылке агента заводит заявку и выдаёт её код — lead_key
  • Клик участвует в начислении комиссии 90 дней с момента перехода
  • Postback API фиксирует каждый вызов с полным логом в разделе «Интеграция»
  • Все сделки видны в кабинете с детализацией по агентам
  • API-ключ (X-Api-Key) защищает от подделки вызовов и отзывается в один клик

Postback API — документация

Техническая интеграция: вы сообщаете о регистрациях и оплатах, мы начисляем комиссию агенту

Полное машиночитаемое описание контракта — в Swagger (OpenAPI). Оно открыто без авторизации: интегратору документация нужна до получения ключа.

Endpoint

POST /api/postback

Headers

Content-Type: application/json

X-Api-Key: ваш_api_ключ

Ключ выпускается в кабинете бизнеса, раздел «Интеграция». Показывается один раз при создании, потерянный не восстанавливается — выпускается новый.

Параметры запроса

ПолеТипОбязательноОписание
lead_keystringДаКод заявки, который мы подставили в вашу ссылку при переходе клиента
statusstringДаregister | paid | refund | test
namestringДаИмя клиента
phonestringДаТелефон в международном формате, например +71234567890
amountnumber | stringДля paidСумма оплаты в рублях; принимается и числом, и строкой
order_idstringРекоменд.Ваш номер заказа. С ним повторная отправка того же события безопасна
emailstringНетПочта клиента
telegramstringНетИмя пользователя в Telegram без @
external_user_idstringНетИдентификатор пользователя у вас. Сопоставление идёт по нему раньше, чем по телефону
payment_statusstringНетДетализация платежа: pending, completed, failed, refunded, chargeback, fraud

Подписки и позиции заказа (billing, items) описаны в Swagger — они необязательны, интеграция работает и без них.

Что делает каждый статус

  • register — клиент зарегистрировался у вас: заявка обновляется, сделки нет
  • paid — клиент оплатил: создаётся сделка, агенту начисляется комиссия
  • refund — оплата возвращена: сделка отменяется
  • test — проверка интеграции: ключ и поля валидируются, данные не сохраняются

Ответ (при успехе)

{

"status": "ok",

"message": "Postback accepted"

}

Как получить lead_key на вашей стороне

В настройках оффера вы задаёте шаблон ссылки, на которую уводим клиента. Макрос {code} обязателен: в него подставляется код заявки, который вы возвращаете в lead_key.

# Шаблон в настройках оффера

https://site.ru/register?utm_source=hitly&lead={code}

# Клиент приходит по ссылке

https://site.ru/register?utm_source=hitly&lead=aB3xK9dQ

# Сохраняете aB3xK9dQ и возвращаете его в постбэке

Доступны также макросы {agent_id}, {agent_code} и {offer_id} — они информационные и в постбэке не требуются.

Войти · Регистрация · Swagger