Skip to main content
TON Pay SDK is a developer toolkit for integrating payment functionality on the TON blockchain. It supports web applications, Telegram Mini Apps, backend services, and bots. The SDK provides a unified interface for creating, verifying, and managing payments, abstracting blockchain-specific logic.
TON Pay is not a payment processor.

For business

Accept TON and jettons as fiat-equivalent funds in the TON wallet, without intermediaries.

For developers

Integrate payments into web applications, bots, and services using the SDK interface.

​
Supported wallets

TON Pay SDK is compatible with TON wallets through the TON Connect protocol :

Tonkeeper

iOS, Android, web, desktop

MyTonWallet

iOS, Android, desktop

Tonhub

iOS, Android

OpenMask

Web extension

TON Wallet

Web, desktop

Wallet bot

Telegram

​
Features

  • Payment creation: one-time transfers, recurring payments, and subscriptions, with customizable reference IDs and memo fields.
  • Transaction tracking: transaction status tracking, confirmation handling, error reporting, and analytics.
  • UI components: React hooks, ready-to-use payment components, and built-in status indicators.

​
How TON Pay works

  1. TON Pay backend generates a transaction message.
  2. The user reviews and signs the transaction in the wallet.
  3. The transaction is executed and confirmed on the TON blockchain.
  4. TON Pay backend monitors the transaction status and sends webhook notifications to the application upon completion.

​
Security

  • Non-custodial: funds always remain under user control.
  • Standard protocols: built on proven TON standards.
  • Transparency: all transactions are verifiable on-chain.

​
Next steps

Install the SDK and configure the development environment. TON Pay SDK is open source software licensed under the Apache License 2.0.