What varioroam is and how it works, in the shop’s own words: the configurable eSIM, ranges, delivery, payment, hotspot, activation, top-ups (add data or days), e-mails, support. Use for any question that is not a price.
Parametersbucketlanguage
list_destinations
List destinations
Every country varioroam can build an eSIM for, with the number of selectable networks and the starting price (1 GB, 1 day, cheapest network). Use to check coverage or to compare many countries at once.
Parametersbucketcurrencylanguage
get_networks
Networks of a country
The mobile networks the customer can tick for one country (operator name, 4G/5G) with the price of a reference eSIM on each network alone (1 GB · 7 days), so you can say which network is the cheapest and what the others add.
Parametersbucketcurrencylanguagedestinationrequired
quote_esim
Quote one configuration
Use while the customer is still deciding — "how much is …?": the exact price of one eSIM configuration (country, data GB 1–100, days 1–90, networks), the server price the customer would pay. Quote it as returned, never compute or scale it yourself. The result carries a buy_url for reference; when the customer says they want to buy, call start_checkout instead.
Parametersgbrequireddaysrequiredbucketcurrencylanguagenetworksdestinationrequired
Prices for several GB × days combinations of one country in one call (max 8 × 8), e.g. to compare with other providers or to find the best fit for a trip. Same server prices as quote_esim.
Parametersgbrequireddaysrequiredbucketcurrencylanguagenetworksdestinationrequired
recommend_config
Recommend a configuration
Use when the customer describes a trip instead of a size: country (or up to 5), days and how they use data (usage light / normal / heavy, or gb_per_day). Sizes the data pool from the data guide and returns three server-quoted configurations per country — exact, comfortable (×1.5) and generous (×2) — each with its price, networks, a one-line reason and its buy_url, plus trip totals and an optional budget check. Prices are the same as quote_esim. Give destination (one country) or destinations (several) — one of the two is required; a call without a country fails with invalid_argument.
Parametersdaysrequiredusagebucketbudgetcurrencylanguagenetworksgb_per_daydestinationper_countrydestinations
plan_trip
Plan a multi-country trip
A trip through several countries (max 5): one eSIM per country, each quoted with the same data pool and days unless given per country (gb omitted = sized for normal use from the days). Returns one line per country with price and buy_url, plus the total. Use when the customer names two or more countries and a size (2–5 destinations); for one country call quote_esim; use recommend_config when they describe usage instead.
Parametersgbdaysbucketcurrencylanguageper_countrydestinationsrequired
start_checkout
Start secure checkout
Use only once the customer has decided to buy ("I'll take it", "how do I buy?"): the checkout handoff. Returns the buy_url to give the customer, the final price and a ready-to-send checkout block (next_step, payment_methods, delivery) — on the page they press "Get it" and pay securely. No account needed; the eSIM is delivered on screen and by e-mail right after payment. No in-chat order tracking, no discount codes. For prices while the customer is still comparing, use quote_esim.
Parametersgbrequireddaysrequiredbucketcurrencylanguagenetworksdestinationrequired