{"uid":"cap_mIHCcX2Otkb_jPYCflw5P","slug":"x402card-freeland-travel-esim-purchase-d9704c16","name":"x402card Freeland Travel eSIM Purchase","description":"Buy a prepaid Freeland travel eSIM and privately receive its installation QR and activation data. Pay native USDC on Base through x402; no API key or provider account is required.","url":"https://api.x402card.org/api/esim/purchase","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"planId":{"type":"string","description":"Live plan id from GET /api/esim/plans. Omit to buy the cheapest currently available plan."},"idempotencyKey":{"type":"string","maxLength":200,"minLength":1,"description":"Stable caller-generated key. Reuse it after an ambiguous response; never generate a replacement to retry payment."}}},"responseSchema":{"type":"json","example":{"ok":true,"seller":"Freeland","status":"paid_unfulfilled","product":"esim","delivery":{"next":"Preserve the token privately, poll the returned order URL, then retrieve owner-only credentials.","token":"<private-order-delivery-token>","header":"X-Esim-Delivery-Token"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.47","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.47/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.47","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.47","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wNZhCvmmY1uYisbNwCZbC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.47","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchases a prepaid Freeland travel eSIM via USDC on Base (x402), returning a private delivery token and order URL to retrieve the QR code and activation data","exampleAgentPrompt":"Buy me a Freeland prepaid travel eSIM using USDC on Base — pick the cheapest available plan and make sure you keep the delivery token private so I can retrieve the QR code to install it on my phone.","exampleUseCases":[{"title":"Solo traveler grabbing last-minute data","prompt":"I'm heading abroad tomorrow and need a prepaid travel eSIM right away — buy me the cheapest Freeland plan available using USDC and get me the QR code to install it."},{"title":"Privacy-first international data plan","prompt":"I want to buy a Freeland travel eSIM without creating any provider accounts — pay with USDC on Base, keep the delivery token private, and give me the activation details when they're ready."},{"title":"Agent auto-provisioning eSIM for trip","prompt":"Before my trip kicks off, go ahead and purchase a Freeland eSIM using USDC — use idempotency key 'trip-2024-eu-esim-001' so we don't accidentally double-charge, and poll for the QR code once the order is confirmed."}],"resultDescription":"Returns a JSON object with ok:true, seller name (Freeland), an order status (e.g. paid_unfulfilled), and a delivery object containing a private order delivery token, the header name to use when polling, and instructions for privately retrieving the eSIM QR code and activation credentials via the returned order URL.","failureModes":["Invalid or expired planId returns an error indicating no matching plan","Duplicate idempotencyKey with different parameters may be rejected or return a conflict error","Insufficient USDC balance on Base causes payment failure and no order is created","Ambiguous or failed payment response should be retried with the same idempotencyKey, never a new one","Freeland fulfillment delay may leave order in paid_unfulfilled state requiring polling","Network timeout may leave payment state unknown — use idempotencyKey to safely retry"],"whenToPreferThis":"Choose this endpoint when you need to programmatically purchase a travel eSIM using USDC on Base (x402) without requiring an API key or provider account registration. It is ideal for privacy-conscious use cases, crypto-native agent workflows, or when you want the cheapest available Freeland plan provisioned on demand. Prefer this over traditional eSIM APIs when the user wants to pay in stablecoin, avoids KYC-heavy provider onboarding, or needs fully automated eSIM purchasing in an agentic pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:31:47.814Z","isFirstParty":false}