ОСАГО в тематических разделах Директа: кто может, кампания, API-интеграция и передача продаж
ОСАГО продвигается в тематическом разделе «Страховые продукты» поиска и в сервисе Яндекс Финансы. Платят за целевое действие, то есть за проданный полис. Страховым агентам и брокерам нужны договоры не менее чем с 10 страховыми компаниями. Интеграция строится по спецификации OSAGO Integration API 1.6.0: опрос расчёта не чаще 1 раза в секунду до 3 минут, черновик и полис — раз в 5 секунд до 5 минут. Продажи передаются в Директ в течение 3 дней, не позже 11.
Цифры
Условия
| Параметр | Значение |
|---|---|
| Кто допускается | страховые компании; операторы финансовых платформ по данным ЦБ РФ; партнёры, привлекаемые финплатформами; страховые агенты и брокеры из реестра страховых брокеров ЦБ РФ |
| Условие для агентов и брокеров | агентские договоры, договоры брокера в интересах страховщика или иные схемы с правом действовать от имени не менее чем 10 страховых компаний |
| Продукт в кампании | Полис ОСАГО |
| Целевое действие | проданный полис, оплата полиса |
| Устройства | все типы, после ввода данных о транспортном средстве и водителе |
| Ранжирование | ставка (цена целевого действия), кликабельность, коэффициент релевантности |
| Валидация методов API | до 72 часов; сервер партнёра должен отвечать на GET /healthcheck |
| Категории ТС в справочниках | A, B, C, D, E |
| Столбец «Конверсии» | количество оплаченных полисов |
| Спецификация интеграции | OSAGO Integration API 1.6.0 от 23.03.2026 |
| Подключение как партнёр | письмо на finance-search@yandex-team.ru с заголовком «Интеграция API в страховании» и названием организации |
| Передача данных о продаже | на https://ya.ru/finance/osago/api/v1: GET /confirm или POST /confirm (пакетно — POST) |
| Срок передачи данных о продаже | рекомендуется в течение 3 дней, крайний срок — 11 дней после фактической оплаты |
Методы API
| Метод | Сторона | Назначение |
|---|---|---|
| GET /auto/info | партнёр | автозаполнение по VIN и/или госномеру (параметры vin и car_number); ответ — объект VehicleInfo с категорией ТС, маркой, моделью, годом, мощностью, реквизитами СТС/ПТС/ЭПТС |
| GET /dictionaries/brands и другие справочники | партнёр | бренды, модели, годы выпуска, мощности двигателя; модификации и иерархия — необязательные |
| POST /osago/calculate | партнёр | создание запроса на расчёт (модель CalculateOsagoRequest) |
| GET /osago/calculate | партнёр | получение результата расчёта по request_id |
| GET /osago/calculate/status | партнёр | статус расчёта, метод необязательный |
| GET /osago/offer | партнёр | получение предложения, метод необязательный |
| POST /osago/offer | партнёр | подтверждение выбранного предложения (ConfirmOsagoOfferRequest); используется не всеми партнёрами |
| GET /osago/offer/draft | партнёр | pdf-черновик полиса |
| GET /osago/offer/policy | партнёр | оформленный полис после оплаты |
| GET /confirm или POST /confirm | Яндекс | подтверждение продажи; для пакетной передачи — POST |
Регламент опроса
| Что опрашивается | Частота | Предел |
|---|---|---|
| Расчёт (GET /osago/calculate?request_id) | не чаще 1 раза в секунду | не дольше 3 минут, до финального статуса |
| Черновик полиса (GET /osago/offer/draft) | каждые 5 секунд | не более 5 минут, до статуса success |
| Полис (GET /osago/offer/policy) | каждые 5 секунд | не более 5 минут |
Финальные статусы расчёта: CALCULATION_READY — расчёт готов, сформированы предложения; NO_CALCULATION_AVAILABLE — доступных расчётов нет (компания отклонила заявку); CALCULATION_ERROR — ошибка расчёта на стороне партнёра.
Передача продаж (модель ConfirmItem)
| Поле | Тип | Обязательно | Что передаётся |
|---|---|---|---|
| request_id | UUID | да | идентификатор запроса расчёта |
| partner_id | integer | да | идентификатор партнёра, с которым настроена интеграция |
| counterparty_id | integer | да | идентификатор страховой компании, выдавшей полис |
| offer_id | string | нет | идентификатор предложения |
| amount | number | да | сумма совокупной страховой премии |
| conversion_date | date-time | да | дата и время покупки по ISO 8601 в UTC+0 |
| is_upsaled | boolean | да | true, если вместе с полисом куплены сопутствующие продукты |
Данные уходят на https://ya.ru/finance/osago/api/v1. Токен доступа выдаётся единоразово при подключении. Передавать рекомендуется в течение 3 дней, крайний срок — 11 дней после фактической оплаты.
Кросс-продажи (upsales)
| Поле предложения | Значение |
|---|---|
| is_cross_allowed в запросе расчёта | разрешены ли кросс-продажи и вменённое страхование |
| is_reinsurance_pool | входит ли предложение в перестраховочный пул; если true, кросс-продажи обязательны, отказ от них отменяет всё предложение |
| policy_start_date | скорректированная дата начала полиса, если страховщик выдаёт полис только с другой даты |
| upsales | массив UpsaleInfo: id, short_name, options обязательны; full_name, insured, insurance_period, is_required по необходимости |
| Опция UpsaleOption | id, name, description, kid_link (КИД в PDF), price, is_default, compatibility_id; опции с разными compatibility_id нельзя выбрать одновременно |
Подробности
Как пользователь видит предложения
- Вводит госномер или VIN и нажимает «Рассчитать»; параметры автомобиля подставляются через GET /auto/info.
- Авторизуется в Яндекс ID или подтверждает профиль, дополняет данные о водителях, собственнике и страхователе; страховая компания проверяет данные и считает полис.
- Видит карточки предложений разных страховых компаний; если партнёр поддерживает кросс-продажи, показываются сопутствующие продукты.
- Знакомится с черновиком полиса, подтверждает вариант и платит напрямую; выпущенный полис отображается сразу после подтверждения транзакции.
Как настроить кампанию
- Добавить → Кампанию → Режим эксперта → Продвижение в тематических разделах → Финансы и страхование; в блоке «Продвигаемый продукт» выбрать «Полис ОСАГО».
- Бюджет — ограничение расхода в неделю; цена целевого действия — плата за каждый проданный полис, не ниже минимального порога, иначе показы прекращаются.
- География показов: список регионов или регион на карте; при необходимости блок «Корректировки по географии» с повышающими и понижающими коэффициентами.
- Блок «Интеграция»: API, Client ID, Client Secret.
- Запустить кампанию; после проверки статус «Активна».
Подключение как партнёра
- Написать на finance-search@yandex-team.ru с заголовком «Интеграция API в страховании» и названием организации.
- Дождаться менеджера, реализовать публичный API-эндпоинт, пройти проверку интеграции.
- Справочники транспортных средств Яндекс обновляет автоматически по планировщику. ID справочников должны быть уникальными и не меняться при обновлении; об изменениях справочников нужно предупредить команду Яндекса. Агрегатору нужен единый справочник.
Отчёты
Результаты доступны в Мастере отчётов и на странице «Кампании». Группировки: Тип кампании → Продвижение в тематических разделах или Вид размещения → Тематический раздел.
Важно знать
- Параметры запросов и ответов методов, кроме модели ConfirmItem и перечня полей на странице «Страхование», в скачанных страницах не приведены: у методов есть только путь, назначение и регламент. Страница кодов ответов содержит один код: 400 Bad Request с полями request_id, message, properties.
- Метод подтверждения предложения на странице интеграции описан как вызов при выборе пользователем карточки, а на странице метода — как используемый не всеми партнёрами.
- Если расчёт не получился, страница расчёта советует вызвать метод получения предложения для финального расчёта; как это сочетается со статусами CALCULATION_READY и CALCULATION_ERROR, справка не поясняет.
- Путь справочников дан только для списка брендов (GET /dictionaries/brands); пути остальных справочников в тексте нет.
- В справке не нашли: минимальное значение цены целевого действия, перечень полей запроса расчёта и ответа, полный список кодов ответов методов ОСАГО.
Источник: Справка Директа: Страхованиепроверено 02.11.2026Ещё: Справка Директа: Страхование — API для партнеров, Справка Директа: Создание запроса на расчет ОСАГО, Справка Директа: Получение расчета ОСАГО, Справка Директа: Получение статуса расчета ОСАГО, Справка Директа: Получение предложения ОСАГО, Справка Директа: Подтверждение предложения ОСАГО, Справка Директа: Запрос на получение pdf-файла с черновиком полиса, Справка Директа: Запрос на получение полиса, Справка Директа: Подтверждение продажи, Справка Директа: Получение справочников транспортных средств, Справка Директа: Стандартные коды ответов (Страхование)