Skip to content

Home

Jump to bottom
Igor Sazonov edited this page Apr 15, 2026 · 2 revisions

Welcome to the Telegram Wallet Pay PHP SDK Wiki

Accept crypto payments in your PHP application or Laravel project with ease. This SDK provides a robust, type-safe wrapper around the Telegram Wallet Pay API, allowing your users to pay with TON, USDT, BTC, and NOT directly inside Telegram.

Why Choose This SDK?

Building a Telegram bot that requires payment processing can be complex. This package simplifies the integration process by offering:

  • Laravel-First Integration: Enjoy seamless integration with Laravel through a dedicated Service Provider, Facade, and Middleware right out of the box.
  • Universal Compatibility: Designed to work standalone in any PHP 8.1+ project, ensuring flexibility across different frameworks and architectures.
  • Robust Security: Built-in HMAC-SHA256 signature verification for webhooks guarantees that your payment notifications are authentic and secure.
  • Type Safety: Leveraging modern PHP features, the SDK uses enums, Data Transfer Objects (DTOs), and typed exceptions to minimize runtime errors and improve developer experience.
  • Comprehensive Testing: Backed by a thorough test suite, providing confidence in the reliability of your payment flows.

Getting Started

To begin integrating Telegram Wallet Pay into your application, explore the following sections:

  1. Installation & Setup: Learn how to install the package via Composer and configure it for your specific environment, whether standalone or within Laravel.
  2. Creating Orders: Discover how to generate payment links and manage the order lifecycle.
  3. Handling Webhooks: Understand how to securely receive and process payment notifications from Wallet Pay.
  4. Laravel Integration: Dive deep into the Laravel-specific features, including Facades and Middleware.
  5. API Reference: Explore the complete list of available methods, DTOs, and Enums provided by the SDK.

About Wallet Pay

Wallet Pay is a business platform within the Telegram Wallet ecosystem that enables seamless payment transactions between merchants and customers. By integrating this SDK, you tap into a vast user base, offering them a familiar and secure way to transact using cryptocurrencies.

For more detailed information about the underlying API, refer to the official Wallet Pay API Documentation.

Clone this wiki locally