Tizon Mobile

Tizon Mobile is a B2B API for selling eSIMs and mobile top-ups. Every account has a closed-loop USD wallet: funding credits it, purchases debit it, and nothing else moves the balance. There are no withdrawals, and the balance is spendable only on products.

You can integrate end to end on a test key before any KYC and before any real money moves.

How a purchase worksCopy Anchor Link

1. Find an offer. GET /v1/offers is the catalog — eSIM plans and top-ups, each priced in USD. The price on an offer is what a quote will debit; Tizon's margin is already in it.
2. Quote it. POST /v1/quotes prices the offer and pays for it. With payment_source: wallet the balance is debited immediately. With lightning, usdt, usdc or bank_transfer the quote waits in awaiting_funds and tells you where to send the money.
3. Collect the order. A paid quote creates an order, fulfilled in the background. Wait for the order.fulfilled webhook, or poll GET /v1/orders/{order_id}. Its deliverable carries the eSIM profile or the top-up receipt.

Two ways to payCopy Anchor Link

The wallet is the fast path: fund it once, then every purchase is a single call that either succeeds or returns 402 with the shortfall. Nothing waits.

You can also pay per purchase, without funding anything first — quote with payment_source: lightning and the response carries a BOLT11 invoice for exactly that purchase. Paying it credits the wallet in USD and settles the quote in one move. See on-the-fly payment.

Base URLCopy Anchor Link

https://api.tizon.mobile

There is one base URL. The API key decides the mode, not the host: tz_test_… is the sandbox, tz_live_… is real money. Test and live data are fully isolated — separate wallets, ledgers, provider credentials and webhook secrets.