What worldwide eSIM is and how it works, in the shop’s own words: one mobile-data eSIM for the whole world or chosen continents, one data pool, validity (until the data is used up, up to 180 days from the first connection), recharge, delivery, installation, devices, payment, refunds, My eSIM, e-mails, support. Use for any question that is not a price or a country.
輸入參數bucketlanguage
list_coverage
List coverage
The five continents with their number of countries and the starting price of each (the smallest data size for that continent alone) plus the whole world. Pass continent to list its countries (continent "world" lists every country); include_networks adds the operator names and a 5G flag per country. Use to show where the eSIM works.
輸入參數bucketcurrencylanguagecontinentinclude_networks
check_country
Is a country included?
Is one country included? Pass its name in any language or its ISO-2 code (map a city to its country first). Returns included true/false, the continent, the mobile networks (operator names + 5G flag) and the cheapest coverage choice that includes it (its continent alone) with the server price and buy_url, plus the whole world at the same size for comparison.
輸入參數gbbucketcountry必填currencylanguage
Use while the customer is still deciding — "how much is …?": the exact server price of ONE worldwide eSIM for the chosen continents (default: the whole world) and data size — the amount the customer would pay — with the number of countries, the validity (until the data is used up, up to 180 days), hotspot, the recharge options and prices, and a buy_url for reference. Quote the price as returned; never compute or scale it. When the customer says they want to buy, call start_checkout.
輸入參數gbbucketcurrencylanguagecontinents
Every data size (or the sizes asked for) for one coverage choice in one call, each with the server price and its own buy_url; with compare_continents also the whole world against each single continent — to show what a smaller coverage saves. Same server prices as quote_esim.
輸入參數gbbucketcurrencylanguagecontinentscompare_continents
recommend_config
Recommend for a trip
Use when the customer names the countries of a trip instead of continents and a size: returns the smallest set of continents that covers every named country (countries that are not included come back in not_covered), a suggested data size from the days and usage (light ≈ 0.5 GB/day, normal ≈ 1.5, heavy ≈ 4; rounded up to the next size) and server quotes for that size and one size down and up, each with its buy_url, plus the whole world at the suggested size. Same prices as quote_esim.
輸入參數daysusagebucketbudgetcurrencylanguagecountries必填gb_per_day
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 for one choice (same input as quote_esim). Returns the buy_url to give the customer, the final price and a ready-to-send checkout block (next_step, payment_methods, delivery) — the shop page opens preset to exactly this coverage and size; the customer presses the buy button (buy_button in the result, e.g. "Get your eSIM" in English) and pays 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.
輸入參數gbbucketcurrencylanguagecontinents