Прочитајте API документацију

Продајте европске вињете кроз сопствени производ

Један API за путарине у девет земаља, повезан с вашом апликацијом, сајтом или бек-офисом

Шта добијате једном везом

Уместо да интегришете посебну тол управу за сваку земљу, повезујете се једном и добијате приступ званичним производима вињета за путничка возила, комбије и мотоцикле у Аустрији, Швајцарској, Словенији, Мађарској, Словачкој, Чешкој, Румунији, Бугарској и Молдавији, као и аустријским алпским путаринама за деонице (Бренер, Тауерн, Качберг, Караванкен, Арлберг, Глајналм и Босрук), које стоје ван обичне вињете.

Сваки производ долази од националног провајдера, а не с надценом треће стране накнадно и незапажено додатом одозго: каталог враћа државну цену и вашу накнаду као одвојена поља, тако да оно што показујете купцу и оно што ви задржавате никада није загонетка.

Три начина интеграције

Изаберите интеграцију која одговара нивоу контроле који вам је потребан и времену програмирања којим располажете.

  • REST API: потпуна контрола над каталогом, наплатом и животним циклусом поруџбине унутар вашег сопственог производа и валуте. Погодно за програмере који граде прилагођену наплату, ток резервације или бекенд аутоматизацију.
  • Iframe или уградиви виџет за плаћање: хостовано плаћање уграђено на вашу страницу или у апликацију, с преусмеравањем назад код успеха или неуспеха. Погодно за тимове који желе функционалан ток куповине брзо, без сопственог управљања логиком плаћања.
  • Партнерски панел: контролна табла за ручно креирање и управљање поруџбинама, без потребе за кодом. Погодно за агенте и брокере који продају од случаја до случаја, а служи и као место где сваки партнер тестира и надгледа поруџбине, без обзира на врсту интеграције.

Шта API заправо ради

Он покрива цео животни циклус поруџбине, не само листу производа: претражујете актуелан каталог по земљи, врсти производа, врсти возила и валути, проверавате да ли су земља или период доступни пре приказивања наплате, валидирате возило пре плаћања и валидирате целу поруџбину пре него што је потврдите.

Поруџбине направљене преко API-ја и поруџбине већ креиране у вашем сопственом систему могу обе бити приказане у Vignette ID-у, ове друге као спољне поруџбине, чиме се ваша евиденција и страна провајдера одржавају усклађеним. Поруџбине се могу мењати, поруџбине на чекању или одложене могу се отказати, а исти ток може комбиновати земље и врсте возила.

Цене и ваша провизија

Крајња тачка за производе враћа три вредности за сваку ставку: државну цену коју одређује национални провајдер, вашу партнерску накнаду и укупну цену коју плаћа крајњи купац, с вашом накнадом већ укљученом. То раздвајање показује вашу маржу по производу, по земљи и по врсти возила, уместо да морате да је рачунате уназад из једног измешаног броја.

Цене се могу тражити у вашој сопственој валути, укључујући EUR, UAH, USD, PLN и HUF, између осталих.

Механизам провизије, услови поделе прихода и сваки депозит утврђени су у уговору о сарадњи који се саставља за ваш налог након регистрације; ти износи зависе од вашег модела плаћања и обима, па припадају том уговору, а не маркетиншким материјалима.

Како да почнете

Региструјте се преко партнерског обрасца да бисте добили одвојене sandbox и продукционе API кључеве. Пријавите се на партнерски панел да бисте позвали програмере, подесили webhook и redirect адресе, и дошли до калкулатора прихода који израђује нацрт вашег уговора о сарадњи на основу изабраног модела плаћања.

Прво изградите и тестирајте у потпуности над sandbox окружењем: креирајте поруџбине, покренете webhook догађаје и вежбајте отказивања и измене, без додиривања стварних плаћања или стварних државних система. Продукциони приступни подаци активирају се када уговор буде потписан. Позив ради интеграције с тимом доступан је ако желите прво да прођете кроз подешавање API-ја или iframe-a.

Оперативни детаљи корисни пре интеграције

Крајња тачка за каталог производа ограничена је по броју захтева по партнеру у минути, с више простора за раст како ваш обим расте; кеширајте податке каталога уместо да их упитујете приликом сваке наплате, и дајте предност webhook-овима у односу на понављано проверавање статуса поруџбине.

Неки производи носе услове које наплата мора да обради: одређене земље дозвољавају датум почетка тек од сутра, а не од данас, а неки захтевају VIN или додатне податке о возачу пре него што поруџбина може бити креирана. Валидација возила и читање ограничења производа пре наплате спречава неуспеле поруџбине у тренутку плаћања.

Поруџбине пролазе кроз дефинисан животни циклус од креирања до активне, употребљиве вињете, с посебним стањима за поруџбине које чекају одговор провајдера, поруџбине одложене за будући датум почетка, и поруџбине које се завршавају отказивањем или повратом новца. Подесите webhook како би се ваш систем аутоматски ажурирао код сваке промене статуса.

Коме је ово намењено

Туристичке агенције и туроператори који додају путарине постојећем току резервације. Осигуравајући брокери који вињету пакују уз полису. Апликације за возне паркове и мобилност које покривају возила која прелазе кроз више земаља. Фирме за изнајмљивање возила које покривају клијента за период изнајмљивања. Програмери и системски интегратори којима је потребан документован API и sandbox, а не ручни процес.

Једноставан, али моћан API

API DocsRead docs

Контролна табла за партнере

Partner DashboardPartner dashboard

Питања за партнере и о API-ју

Постоји ли sandbox против кога могу да тестирам пре пуштања у продукцију?

Да. Регистрација као партнер даје вам одвојене sandbox и продукционе API кључеве, а sandbox подржава цео ток поруџбине, укључујући webhook догађаје, отказивања и измене, без додиривања стварних плаћања или стварних државних система.

Које земље и производи су покривени?

Аустрија, Швајцарска, Словенија, Мађарска, Словачка, Чешка, Румунија, Бугарска и Молдавија, с производима вињета и тунелских путарина за путничка возила, комбије и мотоцикле, укључујући аустријске алпске путарине за деонице, које стоје ван обичне вињете.

Могу ли да продајем у валути различитој од евра?

Да. Каталог производа може се тражити у вашој сопственој валути, укључујући EUR, UAH, USD, PLN и HUF, између осталих, при чему је ваша провизија већ укључена у враћену укупну цену.

Да ли морам сам да изградим наплату, или постоји готова?

Доступне су обе опције. Можете изградити потпуно прилагођену наплату преко REST API-ја, или користити iframe или уградиви виџет за плаћање за функционалан ток куповине с преусмеравањем назад код успеха или неуспеха.

Да ли уопште морам да пишем код?

Не. Партнерски панел вам омогућава да ручно креирате и управљате поруџбинама без икаквог програмирања, што одговара брокерима и агентима који продају од случаја до случаја. Сваки партнер, без обзира на то коју интеграцију користи, може такође користити панел за надгледање и тестирање поруџбина.

Како функционише отказивање или измена поруџбине?

Поруџбина се може изменити после креирања, а поруџбине на чекању или одложене могу се отказати преко API-ја или партнерског панела. Да ли завршена, активна вињета може бити отказана зависи од сопствених правила националног провајдера за ту земљу и производ.

Које информације су ми потребне да направим поруџбину?

Минимум су производ, земља, врста возила и регистарска ознака, унапред валидирани преко крајње тачке за валидацију возила. Неке земље додатно захтевају VIN или податке о возачу, а неке дозвољавају датум почетка тек од сутра, а не од данас, што вам подаци о производу показују пре наплате.

Ко је уговорни субјекат иза API-ја?

Партнерски API компаније Vignette ID и уговоре о сарадњи управља PD Business Services FZ LLC, са седиштем у Абу Дабију, УАЕ.