# Travel eSIMs an AI agent can buy

Freeland lets an AI agent discover a live prepaid eSIM plan, prepare an order, pay the exact quote in native USDC on Base through x402, and return the installation credentials to the wallet owner.

There is no card checkout in this flow. The x402 payer becomes the owner, and the paid response returns a private order-scoped delivery token that works even when the wallet cannot sign arbitrary login messages.

## Give this task to your agent

> Buy me a prepaid travel eSIM for **[country]**. Use the live Freeland catalog at `https://api.x402card.org/api/esim/plans`, show me the selected plan and exact USDC quote before payment, pay only through x402 on Base, preserve the returned private delivery token, wait for fulfillment, then return the installation QR code and activation details privately. Settle the payment at most once. If the paid response is lost, recover only with the same idempotency key.

## Machine entry points

- Agent guide: <https://x402card.org/for-agents/>
- Markdown guide: <https://x402card.org/for-agents/index.md>
- Live catalog: <https://api.x402card.org/api/esim/plans>
- Direct x402 purchase: `POST https://api.x402card.org/api/esim/purchase`
- eSIM discovery contract: <https://api.x402card.org/api/esim/discovery>
- eSIM readiness: <https://api.x402card.org/api/esim/ready>
- Agent contract: <https://api.x402card.org/api/agent>
- OpenAPI: <https://api.x402card.org/api/openapi.json>
- Service metadata: <https://x402card.org/.well-known/agent.json>
- MCP discovery: <https://api.x402card.org/mcp>
- Runtime config: <https://api.x402card.org/api/config>

## Contract

1. Discover the live catalog and select a plan.
2. POST the live plan id and one stable idempotency key to `/api/esim/purchase` without a payment header.
3. Read the HTTP 402 `PAYMENT-REQUIRED` response and verify the plan price and exact Base-USDC requirements.
4. Repeat the same POST once with `PAYMENT-SIGNATURE`; the payer becomes the owner.
5. Preserve `orderId` and `delivery.token`; poll the order with `X-Esim-Delivery-Token` until it is fulfilled or fails.
6. Retrieve installation credentials with the same private delivery header. Wallet-signature authentication remains a fallback.

The catalog, price, and availability are dynamic. Treat the live API response as authoritative. Never infer a price from this page.

## Privacy and safety

- Never send a seed phrase or private key to Freeland.
- Remote MCP is for read-only discovery and has no wallet authority.
- A payment is the only value-changing commit in the purchase flow.
- Installation credentials are private, owner-only, and returned with no-store caching policy.
- If the payment result is ambiguous, do not replay it. Continue by reading the same order.