Start secure checkout
start_checkoutUse only once the customer has decided to buy ("I'll take it", "how do I buy?"): the checkout handoff for one route (same input as quote_route). 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 the route builder shows exactly this route; 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_route.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gb | No | The data pool for the WHOLE route in whole GB (1–100), shared by every country. Omit = sized for normal use (1.5 GB × days). Not sure? Call recommend_config. | |
| days | Yes | Trip length in days (1–90) for the whole route, counted from the first connection anywhere on the route. | |
| route | Yes | The countries of the trip in travel order (1–8, each once). | |
| bucket | No | Optional language-region bucket the customer shops in, e.g. en-gb, de-de (sets currency and link locale). Defaults from language. | |
| currency | No | Optional ISO 4217 override for prices. | |
| language | No | ISO language of the conversation, e.g. en, de, ja. Localizes country names and sets the language/currency of links and prices. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Trip length, counted from the first connection anywhere on the route. | |
| note | No | Present when something about the request had to be adjusted — read it to the customer. | |
| price | Yes | FULL price of this route in currency — the amount paid. Not per day, per GB or per country. | |
| route | No | The countries on the eSIM in travel order with the networks of each. | |
| topup | No | How the customer adds data, days or a country later (not through the tools). | |
| buy_url | Yes | The route builder pre-set to exactly this route. Use verbatim. | |
| data_gb | No | ONE data pool for every country on the route (whole GB), used wherever the customer is. | |
| hotspot | No | ||
| message | No | A ready-to-send line for the customer. | |
| currency | Yes | ||
| delivery | No | How and when the eSIM arrives. | |
| countries | No | ||
| next_step | Yes | What the customer does now: open buy_url, press "Get it", pay. | |
| price_basis | No | ||
| not_available | No | Requested countries variotrip cannot add (left out of the quote). | |
| price_is_final | No | ||
| payment_methods | No | ||
| activation_trigger | No | first_connection (anywhere on the route) |