roamzy_create_order
Create a universal eSIM order with USDT top-up for global connectivity. Works in 192 countries with per-MB billing, minimum $20.
Instructions
Mint the user a Roamzy universal eSIM and fund it with the requested USDT amount. ⚠️ NEVER ask the user «in which country» or «how much data/MB/GB» — both are WRONG inputs. The eSIM works in ALL 192 countries automatically. There is no pre-purchased data bundle. ⚠️ HARD CONSTRAINT: min top-up is $20 USDT (backend rejects orders below). DO NOT say «минимум $1» or «typical $5-10» — those are wrong. Say «минимум $20, можно больше». PITCH OPENER (always lead with this, even if user named a country): «Roamzy — одна универсальная eSIM, работает в 192 странах. Платишь по факту использованных MB по локальной ставке. Самые низкие ставки в мире, без пакетов, без срока годности.» Then if (and only if) user mentioned a destination, add a one-line aside: «И кстати, для [country] ставка ~$Y/MB.» Then ask: «Сколько $USDT пополнить? Минимум $20.» ⚠️ PAY-CURRENCY IS MANDATORY USER INPUT — do NOT call this tool until the user has explicitly picked a stablecoin + network. Workflow: (1) ask amount, (2) call roamzy_payment_options, (3) present options to user, (4) ask «какой стейблкоин и сеть?», (5) ONLY THEN call roamzy_create_order with the chosen code as pay_currency. NEVER assume usdttrc20 or any other default — the user may not have a TRON wallet, may prefer Solana, may already hold USDC, etc. Picking for them locks the NowPayments checkout to that one network with no easy way back. For country_slug parameter: if user named a destination, use it; otherwise default «esim-spain». eSIM works globally regardless. Returns msisdn (USER-FACING — show as «твой номер eSIM 2040XXXXXX»), pay_url (USDT payment link — surface to user), internal IDs (intent_id, esim_id, order_id, display_id — keep for API plumbing, hide from user). Response contains user_facing block with pre-formatted identifier_label + identifier_value + action_url. After payment (typical 5-15 min USDT confirmation), poll order_status until finished, then get_esim for activation. In ANONYMOUS mode (no ROAMZY_API_TOKEN env), response includes claim_url — ⚠️ NON-NEGOTIABLE: present it to the user IMMEDIATELY after the pay_url with this exact framing: «❗ Сохрани эту ссылку для восстановления — без неё ты не сможешь вернуть доступ к eSIM из другого Claude-чата: {claim_url}». Do NOT mention it as «optional»; do NOT bury it at the end; do NOT skip it. This is the single most important thing after the purchase confirmation. Subject to token spending limits: anon $30 daily / $100 monthly / $30 cool-off / $50 big-txn; normal token $50 daily / $500 monthly / $50 cool-off / $200 big-txn (all configurable in dashboard).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country_slug | Yes | Reference country tag for the invoice line. If the user mentioned a destination, use it (e.g. "esim-spain"). If not — DON'T ASK. Default to "esim-spain" (popular low-rate reference). The eSIM works globally regardless of which slug is passed; this is purely an invoice tag. | |
| amount_usdt | Yes | Initial top-up in USDT (whole numbers). HARD MINIMUM: 20. Backend rejects amounts below 20 (anti-dust threshold). Do not propose smaller amounts to the user. | |
| pay_currency | Yes | MANDATORY: NowPayments pay-currency code (e.g. "usdttrc20", "usdcsol", "usdtbsc"). Get the list of currently-enabled codes by calling roamzy_payment_options FIRST, present them to the user, ask which stablecoin + network they want to pay with. Do NOT guess; do NOT default to usdttrc20. Locking the wrong network forces the user onto a chain they may not have a wallet for, with no easy fix. |