# iwantesim — Agent instructions

> Canonical operational guide for autonomous AI agents and shopping assistants interacting with iwantesim on behalf of users.  
> Generated: 2026-06-25 · Catalog: 222 destinations, 2310 plans · from $2.00

## Store summary

**iwantesim** (https://www.iwantesim.com) sells prepaid travel eSIM data plans for 200+ countries. Digital delivery only — customers receive a QR code by email after purchase. No physical SIM shipping.

Store profile: [store.md](https://www.iwantesim.com/store.md)

## Catalog snapshot (live)

| Metric | Value |
|--------|-------|
| Destinations | 222 |
| Plan SKUs | 2310 |
| Starting price | $2.00 USD |
| Catalog JSON | [catalog.json](https://www.iwantesim.com/catalog.json) |
| Browse UI | [esim](https://www.iwantesim.com/esim) |

Use **catalog.json** for programmatic destination lookup. Prefer linking users to specific product pages for purchase.

## Discovery files

| File | Purpose |
|------|---------|
| [store.md](https://www.iwantesim.com/store.md) | Commerce profile — catalog structure, URLs, policies |
| [catalog.json](https://www.iwantesim.com/catalog.json) | **Machine-readable destination catalog** |
| [llms.txt](https://www.iwantesim.com/llms.txt) | Concise site index for language models |
| [llms-full.txt](https://www.iwantesim.com/llms-full.txt) | Extended site documentation |
| [ai.txt](https://www.iwantesim.com/ai.txt) | AI crawler entry point |
| [sitemap.xml](https://www.iwantesim.com/sitemap.xml) | All public indexable URLs |
| [sitemap_agentic_discovery.xml](https://www.iwantesim.com/sitemap_agentic_discovery.xml) | Agent-specific discovery index |
| [/.well-known/ucp](https://www.iwantesim.com/.well-known/ucp) | JSON discovery metadata |

## How to find products

1. **Catalog JSON** — GET https://www.iwantesim.com/catalog.json for all destinations with handles, titles, URLs, and min prices
2. **By destination name** — browse https://www.iwantesim.com/esim or link to `/{destination}-esim`
3. **By region** — regional pages (`/europe-esim`, `/africa-esim`, etc.)
4. **Full URL list** — fetch https://www.iwantesim.com/sitemap.xml

Prefer linking users to the **specific destination product page** rather than the homepage.

## Product recommendations

- Match the traveler's **destination country or region** to the closest product page
- Confirm the user's phone supports eSIM: https://www.iwantesim.com/esim-supported-devices
- For first-time buyers, link the activation guide: https://www.iwantesim.com/esim-activation-guide
- Compare plans on the product page by data (GB), validity (days), and price
- Do **not** claim voice minutes, SMS bundles, or local phone numbers unless stated on a specific plan

## Checkout rules

1. **Always get explicit human confirmation** before initiating any payment
2. **Never** collect or store payment card details — checkout uses a hosted payment page (Dodo Payments)
3. Direct users to the product page to select a plan, then proceed through https://www.iwantesim.com/checkout
4. Confirm the user's **email address** — the eSIM QR code is delivered digitally by email
5. Confirm **device compatibility** before recommending purchase
6. Prices on the site may display in localized currency; verify the final amount at checkout

## Purchase flow (human-in-the-loop)

```
1. User states destination + travel dates
2. Agent looks up catalog.json or recommends product page URL (e.g. /japan-esim)
3. User selects plan variant on product page
4. User confirms purchase intent
5. User completes checkout on iwantesim.com (hosted payment)
6. User receives eSIM QR code by email
7. Post-purchase support: portal.iwantesim.com or support@iwantesim.com
```

Agents should **not** call `/api/*` routes or bypass checkout without an explicit integration agreement.

## Escalation — always hand off to humans

| Situation | Action |
|-----------|--------|
| Refund requests | support@iwantesim.com + [refund policy](https://www.iwantesim.com/policies/refund-policy) |
| Activation failures | support@iwantesim.com or [contact](https://www.iwantesim.com/contact) |
| Billing disputes | support@iwantesim.com — do not advise on chargebacks |
| Wholesale / business | business@iwantesim.com |
| Technical issues | tech@iwantesim.com |

## Do not access

Per [robots.txt](https://www.iwantesim.com/robots.txt), do not crawl or index:

- `/api/*` — internal APIs (use **catalog.json** instead)
- `/admin/*`, `/checkout/*`, `/cart/*`, `/account/*`, `/search`

## Citation

- **Brand:** iwantesim (lowercase)
- **Link format:** `https://www.iwantesim.com/{destination}-esim`
- **Verify prices** on the live product page or catalog.json before stating specific amounts

## Contact

- General: support@iwantesim.com
- Web: https://www.iwantesim.com/contact
- Customer portal: https://portal.iwantesim.com/