find_esim_plans
Find travel eSIM plans
Lists Inbox eSIM data plans for a destination (country, city, region such as Europe, or 'global'), cheapest first, with plan_id, data in GB, validity in days and price in USD. Data only, no phone number; works on unlocked eSIM phones.
輸入參數min_daysdestination必填min_data_gb
buy_esim
Buy a travel eSIM
Starts the purchase of one eSIM plan for the customer and returns a payment link. Pay it with the Machine Payments Protocol (HTTP 402, Stripe shared payment token) to complete the order. Before calling, confirm the plan, the price and the email with the customer, and get their agreement to the terms: By buying, the customer asks for the eSIM to be sent at once and accepts the terms (https://inboxesim.com/terms): the 14-day right to withdraw ends once the eSIM is installed. An eSIM that was never installed or used can be refunded within 30 days from its order page, less the payment fee (in full within 14 days in the EU and UK).
輸入參數plan_id必填customer_email必填customer_agreed_to_terms必填
make_esim_cart
One payment for several eSIMs
For a trip to several countries (or several phones): turns 2 to 6 plan_ids from find_esim_plans into one cart link. The customer opens it, checks the eSIMs and pays once on Stripe; each eSIM comes in its own QR email and can be refunded on its own. 3 or more eSIMs in one cart are 5% off. Nothing is bought until the customer pays on the page.
輸入參數plan_ids必填
check_esim_device
Check a phone for eSIM
Says whether a phone model is likely to take an eSIM (likely, unlikely or check), from the model name, with how to be sure on the phone itself. Call it before buy_esim when the customer is unsure.
輸入參數device必填
get_order_status
Get an eSIM order's status
Where an Inbox eSIM order is (awaiting_payment, preparing, ready_to_install, installed, in_use, ended, refunded, cancelled, with_support), with data used, the end date and the order page. Needs the order number and the email it was bought with.
輸入參數order_id必填customer_email必填