The catalog is USD; you may pay in anything
This is the part that differs from every other service here. Plans are priced in USD, because that is what the network wholesales in. The account you pay from can hold any currency you hold.
A quote is bound to one account, one plan, and one price, and backs exactly one order. It lapses in about two minutes — long enough for a customer to read a confirmation screen, short enough that the rate is still real.
Catalog
Two levels, both read-only and paged.code is a two-letter country code, or a provider bundle code such as !EU. Treat both as opaque strings and read them from the catalog — it is synchronised from the network and can change.
The eSIM catalog uses the same page shape as bill payments:
totalPages rather than pageCount, and no hasNext or hasPrevious.Order
An order debits immediately and provisions afterwards. It comes backprovisioning far more often than completed, and that is the normal path rather than a problem.
You never claim a refund. A failed order returns the money itself, in the currency it took, whatever the exchange rate has done since.
eSIM
The profile a phone installs. Its whole life is data and time running out.
Only
ready can be cancelled for a refund, and only while nothing has been used. Once data has flowed the network has been paid, and revoking is all that is left.
Installation is a device problem
Install details come in three forms, and you should offer them in this order:universalLinkUrl— one tap, nothing to scan or type.qrCodePayload— render as a QR. It must be scanned from another device; a phone cannot scan its own screen.manual— the SM-DP+ address and activation code, typed by hand.