Skip to main content

​
💎 What is TON Pay SDK?

TON Pay SDK is a developer toolkit for integrating payment functionality on the TON blockchain. It is designed for Web applications, Telegram Mini Apps, backend services, and bots. The SDK provides a unified interface to create, verify, and manage payments — without requiring developers to implement blockchain logic manually.

For Business

Accept TON and Jettons as fiat-equivalent funds in your TON wallet — without intermediaries.

For Developers

Simple SDK integration for web applications, bots, and other apps — no deep blockchain knowledge required.

​
🦄 Why TON Pay Makes Payments Simple

  • Accept Jettons and TON coin without blockchain expertise
  • Convert funds to fiat seamlessly through partner services (⏳coming soon⌛️)
  • Integrate the SDK into websites, bots, or services — no need to rebuild core blockchain logic
  • Easy setup: minimal configuration and built-in components for rapid integration
  • Unified API handles common payment workflows, reducing the need for custom code

​
🏆 Key Advantages

Decentralized

Payments are processed on-chain, without intermediaries.

Low Fees

Enjoy low transaction costs and near-instant confirmations on the TON network.

Unified API

The unified API abstracts blockchain complexity, allowing you to focus on application development.

TON Connect Integration

Natively integrated with TON Connect, supporting both custodial and non-custodial wallets.

​
🔐 Supported Wallets

TON Pay SDK is compatible with all major 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

​
🎯 Who is TON Pay For

​
Merchants and Businesses

  • E-commerce stores — integrate payments directly into online shops
  • Service providers — accept payments for services and subscriptions
  • Content platforms — enable seamless content monetization
  • Physical stores — support POS terminals for retail outlets (⏳coming soon⌛️)

​
Developers

  • Web developers — integrate payments into web applications
  • Telegram bot developers — enable payments in bots
  • Mobile developers — integrate payments into mobile applications
  • Backend developers — implement server-side payment processing

​
🚀 Key Features

Payment Creation

One-time transfers, recurring payments, and subscriptions with customizable reference IDs and memo fields

Transaction Tracking

Real-time status monitoring, confirmation receipts, error handling, and detailed analytics

UI Components

React hooks for fast integration, ready-to-use payment components, and built-in status indicators

​
🔄 How TON Pay Works

The payment flow consists of four simple steps:
  1. Transaction creation — TON Pay backend generates a transaction message.
  2. Wallet signing — the user reviews and signs the transaction in their wallet.
  3. Confirmation — the transaction is executed and confirmed on the TON blockchain.
  4. Notification — TON Pay backend monitors the transaction status and sends webhook notifications to your application upon completion.
Important: TON Pay is not a payment processor. It is a protocol and a set of tools for direct interaction with the TON blockchain.

​
🛡️ Security

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

​
🔗 What’s Next?

Installation and Setup

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