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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"email": "<email>",
"variation_id": "<variation_id>"
},
"name": "esim_create_order"
}
}Input 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. |