50
Cestujúcich na ponuku
Môžete naceniť 1 až 50 osôb jedným volaním. Nad desať cestujúcich preberá vedenie skupinový produkt: rovnaká cena za osobu bez ohľadu na vek.
Vývojárska platforma
API na predaj cestovného poistenia priamo vo vašom produkte
Podpísané konverzné API, sledované deep linky a S2S postback do vášho stacku. Zadarmo na integráciu aj na volanie: platí vás provízia.
Čo je za API
Katalóg
193
Krajín pobytu
Cestujúci dostane cenu bez ohľadu na to, z ktorej krajiny vyráža.
193
Destinácií
Všetky destinácie vrátane rizikových oblastí.
26
Jazykov
Priebeh, dokumenty a zhrnutie v jazyku cestujúceho.
33
Mien
Cena sa zobrazí v mene cestujúceho.
28
Krytí
Zdravie, asistencia, cesta, batožina, zodpovednosť, aktivity, expat. Limity a spoluúčasti v odpovedi.
Čo nemusíte stavať
Tri veci, ktoré nikdy nepostavíte
Žiadna vlastná licencia
HelloSafe je registrovaný distribútor a nesie compliance. Vy zabudujete zážitok, nie reguláciu.
Žiadna integrácia na poisťovňu
Jedno volanie, celý katalóg. Napojenia, zmeny produktov a zmluvné dokumenty zostávajú u nás.
Žiadny obchodník na volanie
Sandbox kľúč je na jedno kliknutie z vášho účtu. Bez revízie, bez karty, bez stretnutia.
Cesty integrácie
Päť spôsobov, ako zapojiť HelloSafe
Od sledovaného odkazu za jedno popoludnie po REST API na nacenenie: vyberte si úroveň integrácie. Rovnaké krytie, rovnaké provízie.
Sledované deep linky
Jeden sledovaný odkaz na obsah alebo kampaň, so Sub-ID. Najrýchlejší štart, bez kódu.
- Deep linky na stránku aj na ponuku
- Sub-ID na kampaň, obsah alebo predajné miesto
- Atribučná cookie na 90 dní, last-click
API konverzného postbacku
Dajte Atlasu vedieť, keď priradený predaj príde alebo zmení stav. Požiadavka podpísaná HMAC, stavový automat, idempotentná.
- Podpísané kľúče na volajúceho (HMAC-SHA256)
- Stavy: pending, validated, cancelled
- Suma v pôvodnej mene: províziu počíta server
S2S postback do vášho stacku
Posielajte konverzie tam, kde riadite biznis: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow alebo webhook do BI.
- Štandardné S2S konektory
- Webhook do vášho BI
- Export do CSV
REST API na nacenenie
Naceňte cestu u viacerých poisťovní, vytvorte sledovaný predajný odkaz a zistite, čo karta cestujúceho nekryje. Jeden kľúč na všetko. Založte si účet a sandbox kľúč je na jedno kliknutie.
- Ponuky viacerých poisťovní v reálnom čase
- Sledovaný predajný odkaz so zabudovanou atribúciou
- Verejná dokumentácia a špecifikácia OpenAPI
MCP server pre AI agentov
Typované nástroje, aby váš LLM alebo agent mohol hľadať, porovnávať a uzatvárať na aktuálnych dátach.
- Typované nástroje pre Claude, ChatGPT aj vlastných agentov
- Odpovede opreté o reálne dáta
- Agentný checkout
Dokumentácia
Prečítajte si to skôr, než začnete stavať
Dokumentácia je verejná a v angličtine. Bez prihlásenia, bez formulára: všetko, čo API vracia, je popísané.
Rýchly štart
Sandbox kľúč, podpísaná požiadavka, prvé nacenené ponuky. Node, cURL a PHP.
Rýchly štart →Referenčná príručka API
Endpointy, polia cesty, kódy krytia, chybové kódy a limity.
Referenčná príručka API →Špecifikácia OpenAPI
Strojovo čitateľná zmluva pre váš generátor klienta.
Špecifikácia OpenAPI →Stav API
Živá kontrola API, záväzky dostupnosti a záznam incidentov.
Stav API →Konverzné API v praxi
Od postbacku k provízii v jednej podpísanej požiadavke
Konverzné API beží už dnes. Odošlete priradený predaj, Atlas ho spáruje s odkazom, prepočíta na eurá a vypočíta províziu podľa vašej sadzby.
- 01
Získajte kľúč
Vo fáze spustenia sa kľúče vydávajú na požiadanie. Dostanete key_id a signing secret viazané na vašu integráciu.
- 02
Podpíšte požiadavku
Vypočítajte HMAC-SHA256 tajomstva nad timestamp.body a odošlite hlavičky x-atlas-key-id, x-atlas-timestamp a x-atlas-signature. Okno pre replay je 5 minút.
- 03
Odošlite konverziu
Pošlite ref a externalOrderId spolu s hrubou sumou v pôvodnej mene a stavom. Atlas zafixuje kurz, vypočíta províziu a vráti uplatnený stav.
postback.js
import { createHmac } from "node:crypto";
const secret = process.env.ATLAS_SIGNING_SECRET;
const body = JSON.stringify({
ref: "hs-acme-7f3k9",
externalOrderId: "ORDER-5821",
amount: 89.90,
currency: "USD",
status: "validated"
});
const ts = Math.floor(Date.now() / 1000).toString();
const signature = "v1=" + createHmac("sha256", secret)
.update(`${ts}.${body}`)
.digest("hex");
await fetch("https://atlas.hellosafe.com/api/postback/conversion", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-atlas-key-id": "pbk_live_a1b2c3",
"x-atlas-timestamp": ts,
"x-atlas-signature": signature
},
body
});
// → 200 { ok: true, action: "inserted", status: "validated" }Jedna podpísaná požiadavka. Atlas odpovie uplatneným stavom a vypočítanou províziou.
Referenčný payload
Telo požiadavky
JSON. ref a externalOrderId sú povinné, zvyšok je voliteľný. Provízia, ktorú pošlete, sa ignoruje: zdrojom pravdy je účtovná kniha.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ref | string | Áno | Identifikátor atribúcie vo formáte partnerCode-shortCode. |
externalOrderId | string | Áno | Vaše číslo objednávky. Na strane Atlasu slúži ako kľúč idempotencie. |
amount | number | Nie | Hrubá suma predaja v pôvodnej mene. |
currency | string (3) | Nie | Kód ISO 4217. Neznáma mena sa uloží ako needs_fx a nacení sa neskôr. |
status | enum | Nie | pending, validated alebo cancelled. Predvolené je pending. |
subId | string | Nie | Podidentifikátor kampane alebo obsahu pre váš reporting. |
Kódy odpovedí
Čo API vracia
Jednoznačné HTTP kódy. Zakázané prechody stavu sa nikdy neuplatnia potichu.
| Kód | Význam |
|---|---|
200 | Konverzia zaznamenaná. action: inserted, updated, transitioned alebo unchanged. |
400 | Chýbajúce polia, neplatný ref alebo ref, ktorý nepatrí vlastníkovi odkazu. |
401 | Neplatný podpis, kľúč alebo timestamp (okno 5 minút). |
404 | Pre tento ref sa nenašiel žiadny odkaz. |
409 | Zakázaný prechod stavu: stavový automat ho odmieta. |
422 | Suma nad bezpečnostným stropom na jednu konverziu. |
Overovanie a bezpečnosť
Podpísané, vymedzené, auditovateľné
Každý volajúci má vlastný kľúč a vlastné tajomstvo. Nič sa nezdieľa, všetko sa dá zrušiť.
Kľúče na volajúceho
Samostatné key_id a signing secret pre každú integráciu. Jeden zrušíte, ostatných sa to nedotkne.
Podpis HMAC-SHA256
Podpis pokrýva timestamp.body bajt po bajte. Akákoľvek zmena tela požiadavku zneplatní.
Ochrana proti replay
Požiadavky, ktorých timestamp sa líši o viac než 5 minút, sú odmietnuté. Zachytenú požiadavku nemožno prehrať znova.
Idempotentný stavový automat
pending na validated alebo cancelled; validated len na cancelled; cancelled je konečný. Poslať rovnaký stav znova nič neurobí.
Spoľahlivosť a podpora
Postavené, aby bežalo, odpovedajú ľudia
Konverzné API a sledované odkazy bežia na edge sieti Cloudflare. S týmto môžete počítať, pokiaľ ide o dostupnosť, opakovania a podporu.
99.9%
Cieľová dostupnosť
Postbacky a sledované odkazy bežia na Cloudflare Workers s automatickým prepnutím. Žiadny jednotlivý región službu nepoloží.
300+
Edge lokalít
Požiadavky obsluhuje najbližší bod Cloudflare; provízia a prepočet meny sa potom počítajú asynchrónne, mimo kritickej cesty vašej pokladne.
< 24h
Čas odozvy podpory
E-mailová podpora odpovedá do jedného pracovného dňa. Otázky k integrácii mieria k partnerskému inžinierskemu tímu, nie do anonymného radu.
5 min
Bezpečné okno opakovania
Idempotentné podľa externalOrderId: opakujte po každom timeoute bez dvojitého započítania, a zachytená požiadavka je po piatich minútach nepoužiteľná.
Stránka stavu je verejná: živá kontrola API, k čomu sa zaväzujeme, a každý incident od otvorenia API. Vaším kontaktom pre integráciu a incidenty zostáva partnerský tím, dostupný cez kontaktnú stránku. Stav API →
AI agenti
Váš agent zavolá nástroj, HelloSafe vráti skutočnú cenu
MCP server vystavuje nacenenie, porovnanie a kontrolu karty ako typované nástroje. Prístup na požiadanie.
MCP server
Žiadna integrácia na poisťovňu, žiadna cenová logika na písanie, žiadne regulačné inštalatérstvo. Váš kopilot, chatbot alebo rezervačný tok zavolá nástroj a dostane skutočnú ponuku, s limitmi a dokumentmi. Napíšte nám, čo staviate.
Technické otázky
Na čo sa tímy pýtajú pred integráciou.
Koľko API stojí?
Nič. Nie je žiadny zavádzací poplatok, žiadny mesačný poplatok za platformu ani poplatok za volanie konverzného API či deep linkov. Zarábate 50 % provízií z predajov, ktoré vaša integrácia prinesie; to je jediný tok peňazí v programe.
Existuje REST API na nacenenie?
Oboje beží. Konverzné API (postback) aj REST API na nacenenie: založte si účet, vytvorte sandbox kľúč jedným kliknutím a o produkčný prístup požiadajte, keď vám integrácia pobeží.
Ako funguje overovanie?
Podpísané kľúče na volajúceho. Vypočítate HMAC-SHA256 tajomstva nad timestamp.body a pošlete ho v x-atlas-signature, s oknom pre replay 5 minút. Staršia cesta cez Bearer existuje, kým súčasní volajúci nemigrujú.
V akej mene mám sumu posielať?
Hrubú sumu v pôvodnej mene spolu s kódom meny. Atlas zafixuje kurz pri prijatí, prepočíta na eurá (účtovná mena) a vypočíta províziu podľa vašej sadzby. Provízia, ktorú pošlete, sa ignoruje.
Je postback idempotentný?
Áno. Kľúčom je externalOrderId: poslať rovnaký stav znova nič neurobí a stavový automat odmietne zakázané prechody kódom 409 namiesto toho, aby ich potichu uplatnil.
Môžem sa integrovať cez Impact, Partnerize alebo Awin?
Áno. Ponúkame štandardný S2S postback, ktorý sa natívne napojí na Impact, Partnerize, Awin, Voluum, RedTrack a Everflow. Konverzie môžete posielať aj na vlastný BI webhook alebo ich exportovať do CSV.
Máte špecifikáciu OpenAPI?
Áno, verejnú a bez prihlásenia. Referenčná stránka sa z tej špecifikácie generuje pri každom builde, takže dokumentácia a zmluva sa nemôžu rozísť.
Podporujete MCP?
V súkromnej bete. MCP server vystavuje nacenenie, porovnanie a uzatvorenie ako typované nástroje, ktoré môže váš LLM alebo agent volať.
S akou dostupnosťou a podporou môžem počítať?
Konverzné API a sledované odkazy bežia na Cloudflare Workers s automatickým prepnutím; cielime na 99,9 % dostupnosti. E-mailová podpora odpovedá do jedného pracovného dňa a otázky k integrácii mieria k partnerskému inžinierskemu tímu. Stránka stavu je verejná.
Potrebuje Coach druhý kľúč?
Nie. Jeden kľúč otvára celé API: nacenenie, sledované odkazy aj Coach. Rovnaký podpis, rovnaké počítadlo, rovnaké limity.
Technická alebo obchodná otázka? Kontaktujte nás
Poďme stavať
Pridajte do svojho produktu cestovné poistenie
Založte si účet a vytvorte sandbox kľúč jedným kliknutím: pevné ukážkové dáta, žiadna poisťovňa sa nevolá, nič sa nepodpisuje. Produkčný prístup je krátka revízia, len čo vám integrácia pobeží.