Какво получавате с една връзка
Вместо да интегрирате отделна тол администрация за всяка държава, свързвате се веднъж и достигате до официални винетни продукти за леки автомобили, бусове и мотоциклети в Австрия, Швейцария, Словения, Унгария, Словакия, Чехия, Румъния, България и Молдова, плюс австрийските алпийски отсечни такси (Бренер, Тауерн, Качберг, Караванкен, Арлберг, Гляйналм и Босрук), които са извън обикновената винетка.
Всеки продукт идва от националния доставчик, а не с надценка на трета страна, добавена незабележимо отгоре: каталогът връща държавната цена и вашата такса като отделни полета, така че това, което показвате на клиента, и това, което запазвате, никога не е загадка.
Три начина за интеграция
Изберете интеграцията, която отговаря на нивото контрол, от което се нуждаете, и времето за разработка, с което разполагате.
- REST API: пълен контрол над каталога, плащането и жизнения цикъл на поръчката в рамките на вашия собствен продукт и валута. Подходящо за разработчици, изграждащи персонализирано плащане, поток на резервация или бекенд автоматизация.
- Iframe или вграждаем уиджет за плащане: хоствано плащане, вградено на вашата страница или в приложението, с пренасочване обратно към вас при успех или неуспех. Подходящо за екипи, които искат работещ поток на покупка бързо, без да управляват логиката на плащанията.
- Партньорски панел: табло за създаване и управление на поръчки ръчно, без нужда от код. Подходящо за агенти и брокери, продаващи поединично, а също служи и като мястото, на което всеки партньор тества и наблюдава поръчки, независимо от вида интеграция.
Какво реално прави API
То покрива целия жизнен цикъл на поръчката, не само списък с продукти: заявявате актуалния каталог по държава, тип продукт, тип превозно средство и валута, проверявате дали дадена държава или период са налични, преди да визуализирате плащането, валидирате превозно средство преди плащане и валидирате цяла поръчка, преди да я финализирате.
Поръчки, направени през API, и поръчки, вече създадени във вашата собствена система, могат да бъдат отразени във Vignette ID, вторите — като външни поръчки, така че вашите записи и страната на доставчика остават синхронизирани. Поръчките могат да бъдат променяни, изчакващи или отложени поръчки — отменяни, а един и същ поток може да смесва държави и типове превозни средства.
Ценообразуване и вашата комисиона
Крайната точка за продукти връща три стойности за всеки артикул: държавната цена, определена от националния доставчик, вашата партньорска такса и общата цена, която крайният клиент плаща, вече включваща вашата такса. Това разделение показва маржа ви за всеки продукт, всяка държава и всеки тип превозно средство, вместо да ви кара да го изчислявате обратно от едно смесено число.
Цените могат да бъдат заявявани във вашата собствена валута, включително EUR, UAH, USD, PLN и HUF, наред с други.
Механиката на комисионата, условията за подялба на приходите и всеки депозит се определят в договора за сътрудничество, изготвен за вашия акаунт при регистрация; тези стойности зависят от вашия модел на плащане и обем, затова принадлежат на този договор, а не на маркетингови материали.
Как да започнете
Регистрирайте се чрез партньорския формуляр, за да получите отделни sandbox и продукционни API ключове. Влезте в партньорския панел, за да поканите разработчици, конфигурирате вашите webhook и redirect URL адреси, и достигнете до калкулатора на приходите, който изготвя договора ви за сътрудничество въз основа на избрания от вас модел на плащане.
Изградете и тествайте изцяло срещу sandbox хоста първо: създавайте поръчки, задействайте webhook събития, и упражнявайте отмени и промени, без да засягате реални плащания или реални държавни системи. Продукционните данни за достъп се активират, щом договорът бъде подписан. Разговор за интеграция с екипа е наличен, ако искате първо да преминете през настройката на API или iframe.
Оперативни детайли, полезни преди интеграция
Крайната точка за каталога на продукти има ограничение на честотата на заявките за партньор в минута, с повече свободно пространство, налично с растежа на обема ви; кеширайте данните от каталога, вместо да ги запитвате при всяко плащане, и предпочитайте webhook пред многократно запитване за статуса на поръчка.
Някои продукти носят условия, които плащането трябва да обработи: определени държави позволяват начална дата само от утре, а не от днес, а някои изискват VIN или допълнителни данни за водача, преди поръчката да може да бъде създадена. Валидирането на превозно средство и прочитането на ограниченията на продукт преди плащане избягва неуспешни поръчки в момента на плащане.
Поръчките преминават през определен жизнен цикъл от създаване до активна, използваема винетка, с отделни състояния за поръчки, чакащи отговор от доставчик, поръчки, отложени за бъдеща начална дата, и поръчки, завършващи с отмяна или възстановяване. Конфигурирайте webhook, така че вашата система да се актуализира автоматично при всяка промяна на статуса.
За кого е това
Туристически агенции и туроператори, добавящи пътни такси към съществуващ поток на резервация. Застрахователни брокери, обвързващи винетка с полица. Флотски и мобилни приложения, покриващи превозни средства, преминаващи през няколко държави. Фирми за коли под наем, покриващи клиент за периода на наема. Разработчици и системни интегратори, които искат документирано API и sandbox, а не ръчен процес.
