esim_create_order
Create a pending eSIM order and get a Stripe payment link or Bitcoin payment details to complete the purchase.
Instructions
Create a pending order. With payment_method: "stripe" (default) you get back a payment_link_url — present it to the user to tap and pay on Stripe's hosted page. With payment_method: "btc" you get back a btc block (on-chain address + amount + QR data URI + expiry) — present the address and amount to the user to pay from any Bitcoin wallet; no redirect. If the user hasn't said how they want to pay, ask: card or Bitcoin. The eSIM QR code arrives at email within ~30 seconds of payment clearing. Use esim_check_order to poll status.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Buyer's email address. The eSIM QR code will be delivered here. | ||
| variation_id | Yes | The specific variation ID to buy (from esim_search_plans or esim_get_plan). | |
| payment_method | No | How the buyer pays. 'stripe' (default) → hosted card checkout, returns a payment_link_url. 'btc' → on-chain Bitcoin, returns a btc block (address + sats + QR) to show the user directly. BTC may be declined for small orders during network-fee spikes — the call then returns a btc_unavailable error and you should offer card instead. | stripe |
| agent_source | No | Optional: identifier for the calling agent (e.g. 'claude-code', 'cursor'). Used for our analytics; not seen by the buyer. |