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