Skip to main content
T TON Adoption
← Glossary
NODE/03 · Term

TON deep-link

URL scheme `ton://...` for passing operation parameters directly to a TON wallet: recipient address, amount, comment, optionally a payload. The base UX abstraction that unites different wallets.

Aliases: ton deep link, deeplink, deep link

TON deep-link is the URL scheme ton://transfer/<address>?amount=<nano>&text=<message>. When a user clicks such a link, the OS opens the registered TON wallet (Tonkeeper, MyTonWallet, @Wallet, etc.) with the transaction form pre-filled.

Base parameters

  • amount — in nano-TON (1 TON = 10^9 nano).
  • text — comment (UTF-8, ≤ ~120 bytes).
  • bin — base64 payload for a smart-contract call (jetton transfer, NFT action, etc.).
  • expires — Unix timestamp deadline.

When to use it

  • Donation links, QR codes for offline payments, payment requests in chat — the simplest and serverless option.
  • An alternative to TON Connect for one-shot operations that don’t need a long-lived authorisation.

Limits

  • You can’t get a response back from the wallet in the browser (this is fire-and-forget) — for interactive flows you need TON Connect 2.x.
  • On desktop with no TON wallet installed, the link won’t open — the fallback should show a QR code.

Related terms