Что вы получаете при одном подключении
Вместо интеграции с отдельным дорожным оператором в каждой стране вы подключаетесь один раз и получаете доступ к официальным продуктам-виньеткам для легковых автомобилей, фургонов и мотоциклов в Австрии, Швейцарии, Словении, Венгрии, Словакии, Чехии, Румынии, Болгарии и Молдове, а также к альпийским посекционным сборам Австрии (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm и Bosruck), которые не входят в обычную виньетку.
Каждый продукт поступает от национального провайдера, а не от скрыто добавленной наценки третьей стороны: каталог возвращает государственную цену и вашу комиссию как отдельные поля, поэтому то, что вы показываете клиенту, и то, что остаётся у вас, никогда не является загадкой.
Три способа интеграции
Выберите вариант интеграции, соответствующий тому, сколько контроля вам нужно и сколько времени разработчиков у вас есть.
- REST API: полный контроль над каталогом, оформлением заказа и жизненным циклом заказа внутри вашего собственного продукта и валюты. Подходит разработчикам, создающим собственный процесс оплаты, поток бронирования или автоматизацию бэкенда.
- Оплата через iframe или встраиваемый виджет: готовая оплата, размещаемая на вашей странице или в приложении, с перенаправлением обратно к вам при успехе или неудаче. Подходит командам, которым нужен работающий процесс покупки быстро, без создания собственной логики платежей.
- Партнёрская панель: панель для ручного создания и управления заказами, без написания кода. Подходит агентам и брокерам, продающим индивидуально, а также служит местом, где любой партнёр тестирует и отслеживает заказы независимо от типа интеграции.
Что именно делает API
Оно охватывает весь жизненный цикл заказа, а не только список продуктов: запрашивайте актуальный каталог по стране, типу продукта, типу транспортного средства и валюте, проверяйте, доступна ли страна или период, прежде чем отображать оформление заказа, проверяйте транспортное средство перед оплатой и проверяйте полный заказ перед его подтверждением.
Заказы, оформленные через API, и заказы, уже созданные в вашей собственной системе, могут быть отражены в Vignette ID — вторые как внешние заказы, что поддерживает синхронность ваших записей и стороны провайдера. Заказы можно изменять, ожидающие или отложенные заказы можно отменять, а один процесс может сочетать разные страны и типы транспортных средств.
Цены и ваша комиссия
Конечная точка продуктов возвращает три показателя для каждого товара: государственную цену, установленную национальным провайдером, вашу партнёрскую комиссию и итоговую цену, которую платит конечный клиент, уже включая вашу комиссию. Такое разделение показывает вашу маржу по продукту, по стране и по типу транспортного средства, вместо того чтобы заставлять вас вычислять её из одного смешанного числа.
Цены можно запрашивать в вашей собственной валюте, включая EUR, UAH, USD, PLN и HUF, среди прочих.
Механика комиссии, условия распределения дохода и любой депозит указаны в соглашении о сотрудничестве, составленном для вашего аккаунта после регистрации; эти цифры зависят от вашей модели оплаты и объёма, поэтому им место в этом соглашении, а не в маркетинговых материалах.
Начало работы
Зарегистрируйтесь через партнёрскую форму, чтобы получить отдельные API-ключи для тестовой и боевой среды. Войдите в партнёрскую панель, чтобы пригласить разработчиков, настроить вебхук и адреса перенаправления, а также получить доступ к калькулятору дохода, который составляет проект вашего соглашения о сотрудничестве на основе выбранной вами модели оплаты.
Сначала полностью соберите и протестируйте всё на тестовом хосте: создавайте заказы, вызывайте события вебхука и отрабатывайте отмены и изменения, не затрагивая реальные платежи или реальные государственные системы. Боевые учётные данные активируются после подписания соглашения. Если вы хотите сначала пройтись по настройке API или iframe, доступен звонок по интеграции с командой.
Что полезно знать перед интеграцией
Конечная точка каталога продуктов ограничена по количеству запросов на партнёра в минуту, с большим запасом по мере роста вашего объёма; кэшируйте данные каталога вместо того, чтобы опрашивать его при каждом оформлении заказа, и предпочитайте вебхуки повторному опросу статуса заказа.
Некоторые продукты несут условия, которые должно учитывать оформление заказа: в некоторых странах дата начала действия доступна только с завтрашнего дня, а не с сегодняшнего, а в некоторых требуется VIN или дополнительные данные водителя перед созданием заказа. Проверка транспортного средства и ограничений продукта перед оформлением заказа помогает избежать неудачных заказов на этапе оплаты.
Заказы проходят через определённый жизненный цикл — от создания до активной, готовой к использованию виньетки, с отдельными состояниями для заказов, ожидающих ответа провайдера, заказов, отложенных до будущей даты начала, и заказов, завершившихся отменой или возвратом средств. Настройте вебхук, чтобы ваша система автоматически обновлялась при каждом изменении статуса.
Кому это подходит
Туристическим агентствам и туроператорам, добавляющим дорожные сборы к существующему процессу бронирования. Страховым брокерам, объединяющим виньетку с полисом. Приложениям для флота и мобильности, покрывающим транспортные средства, пересекающие несколько стран. Компаниям по аренде автомобилей, покрывающим клиента на период аренды. Разработчикам и системным интеграторам, которым нужны документированное API и тестовая среда вместо ручного процесса.
