Quick Start Guide

Installation

Install NEONPAY using pip package manager:

pip install neonpay

Python Version: NEONPAY requires Python 3.8 or higher. Make sure you have a compatible version installed.

Установка

Установите NEONPAY с помощью менеджера пакетов pip:

pip install neonpay

Версия Python: NEONPAY требует Python 3.8 или выше. Убедитесь, что у вас установлена совместимая версия.

Quraşdırma

NEONPAY-i pip paket meneceri istifadə edərək quraşdırın:

pip install neonpay

Python Versiyası: NEONPAY Python 3.8 və ya daha yuxarısını tələb edir. Uyğun versiya quraşdırdığınıza əmin olun.

Basic Setup

NEONPAY works with all major Telegram bot libraries. Here's how to set it up:

1

Import and Initialize

Start by importing NEONPAY and your preferred bot library:

from neonpay import NeonPay
from aiogram import Bot

# Initialize your bot
bot = Bot("YOUR_BOT_TOKEN")

# Create NEONPAY instance
neonpay = NeonPay.create_for_aiogram(bot)
                            

2

Create Payment Stage

Define what users are paying for:

stage = neonpay.create_stage(
    title="Premium Access",
    description="Unlock all premium features",
    price=100,  # 100 Telegram Stars (XTR)
    logo_url="https://example.com/logo.png"
)
                            

Базовая настройка

NEONPAY работает со всеми основными библиотеками Telegram ботов. Вот как его настроить:

1

Импорт и инициализация

Начните с импорта NEONPAY и вашей предпочитаемой библиотеки для ботов:

from neonpay import NeonPay
from aiogram import Bot

# Инициализируйте ваш бот
bot = Bot("YOUR_BOT_TOKEN")

# Создайте экземпляр NEONPAY
neonpay = NeonPay.create_for_aiogram(bot)
                            

2

Создание этапа платежа

Определите, за что пользователи платят:

stage = neonpay.create_stage(
    title="Премиум доступ",
    description="Разблокируйте все премиум функции",
    price=100,  # 100 Telegram Stars (XTR)
    logo_url="https://example.com/logo.png"
)
                            

Əsas quraşdırma

NEONPAY bütün əsas Telegram bot kitabxanaları ilə işləyir. Onu necə quraşdırmaq lazımdır:

1

İmport və İnisialisasiya

NEONPAY və üstünlük verdiyiniz bot kitabxanasını import etməklə başlayın:

from neonpay import NeonPay
from aiogram import Bot

# Botunuzu inisialisasiya edin
bot = Bot("YOUR_BOT_TOKEN")

# NEONPAY nümunəsi yaradın
neonpay = NeonPay.create_for_aiogram(bot)
                            

2

Ödəniş Mərhələsi Yaradın

İstifadəçilərin nə üçün ödəniş etdiklərini müəyyənləşdirin:

stage = neonpay.create_stage(
    title="Premium Giriş",
    description="Bütün premium xüsusiyyətləri açın",
    price=100,  # 100 Telegram Stars (XTR)
    logo_url="https://example.com/logo.png"
)
                            

Your First Payment

Now let's create a simple command that triggers a payment and handle the result:

from aiogram import Router
from aiogram.types import Message
from aiogram.filters import Command

router = Router()

# Command to trigger payment
@router.message(Command("buy"))
async def buy_premium(message: Message):
    # Send payment invoice
    await neonpay.send_payment(message.chat.id, stage)

# Handle successful payment
@neonpay.payment_handler(stage)
async def handle_premium_payment(payment_result):
    # User successfully paid - grant premium access
    user_id = payment_result.user_id
    await payment_result.message.answer(
        "🎉 Welcome to Premium! You now have access to all features."
    )
    
    # Your logic here: save to database, update user status, etc.
    # save_premium_user(user_id)
                        

Important: Don't forget to register your router with the dispatcher and include the payment handler in your bot's event loop.

Ваш первый платеж

Теперь давайте создадим простую команду, которая запускает платеж и обрабатывает результат:

from aiogram import Router
from aiogram.types import Message
from aiogram.filters import Command

router = Router()

# Команда для запуска платежа
@router.message(Command("buy"))
async def buy_premium(message: Message):
    # Отправить счет на оплату
    await neonpay.send_payment(message.chat.id, stage)

# Обработка успешного платежа
@neonpay.payment_handler(stage)
async def handle_premium_payment(payment_result):
    # Пользователь успешно заплатил - предоставить премиум доступ
    user_id = payment_result.user_id
    await payment_result.message.answer(
        "🎉 Премиум активирован! Теперь у вас есть доступ ко всем функциям."
    )
    
    # Ваша логика здесь: сохранить в базу данных, обновить статус пользователя и т.д.
    # save_premium_user(user_id)
                        

Важно: Не забудьте зарегистрировать ваш роутер с диспетчером и включить обработчик платежей в цикл событий вашего бота.

İlk Ödənişiniz

İndi gəlin ödəniş tetikleyen və nəticəni idarə edən sadə komanda yaradaq:

from aiogram import Router
from aiogram.types import Message
from aiogram.filters import Command

router = Router()

# Ödənişi tetikləmək üçün komanda
@router.message(Command("buy"))
async def buy_premium(message: Message):
    # Ödəniş fakturasını göndər
    await neonpay.send_payment(message.chat.id, stage)

# Uğurlu ödənişi idarə et
@neonpay.payment_handler(stage)
async def handle_premium_payment(payment_result):
    # İstifadəçi uğurla ödədi - premium giriş verin
    user_id = payment_result.user_id
    await payment_result.message.answer(
        "🎉 Premium-a xoş gəlmisiniz! İndi bütün xüsusiyyətlərə girişiniz var."
    )
    
    # Sizin məntiqiniz burada: verilənlər bazasına saxlayın, istifadəçi statusunu yeniləyin və s.
    # save_premium_user(user_id)
                        

Vacib: Router-i dispatcher ilə qeydiyyatdan keçirtməyi və ödəniş idarəçisini botunuzun hadisə döngəsinə daxil etməyi unutmayın.

Handling Payments

NEONPAY provides several ways to handle payment results:

Using Decorators (Recommended)

@neonpay.payment_handler(stage)
async def handle_payment(payment_result):
    # Automatic handling for specific stage
    print(f"Payment received: {payment_result.amount} XTR")
    print(f"From user: {payment_result.user_id}")
                        

Using Callbacks

async def payment_callback(payment_result):
    # Custom callback function
    await send_premium_content(payment_result.user_id)

stage = neonpay.create_stage(
    title="Premium Content",
    price=50,
    callback=payment_callback
)
                        

Manual Handling

# Listen to all payments
@neonpay.on_payment
async def handle_any_payment(payment_result):
    stage_title = payment_result.stage.title
    if stage_title == "Premium Access":
        # Handle premium access
        await grant_premium_access(payment_result.user_id)
    elif stage_title == "Digital Product":
        # Handle digital product
        await send_digital_product(payment_result.user_id)
                        

Обработка платежей

NEONPAY предоставляет несколько способов обработки результатов платежей:

Использование декораторов (Рекомендуется)

@neonpay.payment_handler(stage)
async def handle_payment(payment_result):
    # Автоматическая обработка для конкретного этапа
    print(f"Платеж получен: {payment_result.amount} XTR")
    print(f"От пользователя: {payment_result.user_id}")
                        

Использование колбэков

async def payment_callback(payment_result):
    # Пользовательская функция колбэка
    await send_premium_content(payment_result.user_id)

stage = neonpay.create_stage(
    title="Премиум контент",
    price=50,
    callback=payment_callback
)
                        

Ручная обработка

# Слушать все платежи
@neonpay.on_payment
async def handle_any_payment(payment_result):
    stage_title = payment_result.stage.title
    if stage_title == "Премиум доступ":
        # Обработать премиум доступ
        await grant_premium_access(payment_result.user_id)
    elif stage_title == "Цифровой продукт":
        # Обработать цифровой продукт
        await send_digital_product(payment_result.user_id)
                        

Ödənişlərin İdarə Edilməsi

NEONPAY ödəniş nəticələrini idarə etmək üçün bir neçə yol təqdim edir:

Dekoratorlardan İstifadə (Tövsiyə olunur)

@neonpay.payment_handler(stage)
async def handle_payment(payment_result):
    # Xüsusi mərhələ üçün avtomatik idarəetmə
    print(f"Ödəniş alındı: {payment_result.amount} XTR")
    print(f"İstifadəçidən: {payment_result.user_id}")
                        

Callback-lardan İstifadə

async def payment_callback(payment_result):
    # Fərdi callback funksiyası
    await send_premium_content(payment_result.user_id)

stage = neonpay.create_stage(
    title="Premium Məzmun",
    price=50,
    callback=payment_callback
)
                        

Əl ilə İdarəetmə

# Bütün ödənişləri dinlə
@neonpay.on_payment
async def handle_any_payment(payment_result):
    stage_title = payment_result.stage.title
    if stage_title == "Premium Giriş":
        # Premium girişi idarə et
        await grant_premium_access(payment_result.user_id)
    elif stage_title == "Rəqəmsal Məhsul":
        # Rəqəmsal məhsulu idarə et
        await send_digital_product(payment_result.user_id)
                        

Next Steps

Congratulations! You now have basic payments working in your bot. Here's what to explore next:

📚 API Documentation

Explore the full API reference for advanced features and customization options.

View API Docs →

💡 Examples

Check out real-world examples and use cases for different types of bots.

View Examples →

🔧 Library Support

Learn how to use NEONPAY with other Python Telegram bot libraries.

View Libraries →

Pro Tip: Always test your payments in Telegram's test environment before deploying to production. You can use test bots and test Telegram Stars for this purpose.

Следующие шаги

Поздравляем! Теперь у вас работают базовые платежи в боте. Вот что стоит изучить дальше:

📚 Документация API

Изучите полный справочник API для продвинутых функций и настроек.

Посмотреть API документацию →

💡 Примеры

Посмотрите примеры из реального мира и случаи использования для разных типов ботов.

Посмотреть примеры →

🔧 Поддержка библиотек

Узнайте, как использовать NEONPAY с другими Python библиотеками для Telegram ботов.

Посмотреть библиотеки →

Совет профессионала: Всегда тестируйте ваши платежи в тестовой среде Telegram перед развертыванием в продакшен. Для этого вы можете использовать тестовых ботов и тестовые Telegram Stars.

Növbəti Addımlar

Təbriklər! İndi botunuzda əsas ödənişlər işləyir. İrəli nə öyrənməli olduğunuz:

📚 API Sənədləşməsi

Təkmil xüsusiyyətlər və fərdiləşdirmə seçimləri üçün tam API arayışını araşdırın.

API Sənədlərini görün →

💡 Nümunələr

Müxtəlif bot növləri üçün real dünya nümunələri və istifadə hallarına baxın.

Nümunələri görün →

🔧 Kitabxana Dəstəyi

NEONPAY-i digər Python Telegram bot kitabxanaları ilə necə istifadə etməyi öyrənin.

Kitabxanaları görün →

Pro Məsləhət: Prodaksiyaya yerləşdirməzdən əvvəl həmişə ödənişlərinizi Telegram-ın test mühitində sınaqdan keçirin. Bunun üçün test botları və test Telegram Stars istifadə edə bilərsiniz.

Руководство по быстрому старту

Sürətli Başlanğıc Bələdçisi

Installation

Установка

Quraşdırma

Basic Setup

Import and Initialize

Create Payment Stage

Базовая настройка

Импорт и инициализация

Создание этапа платежа

Əsas quraşdırma

İmport və İnisialisasiya

Ödəniş Mərhələsi Yaradın

Your First Payment

Ваш первый платеж

İlk Ödənişiniz

Handling Payments

Using Decorators (Recommended)

Using Callbacks

Manual Handling

Обработка платежей

Использование декораторов (Рекомендуется)

Использование колбэков

Ручная обработка

Ödənişlərin İdarə Edilməsi

Dekoratorlardan İstifadə (Tövsiyə olunur)

Callback-lardan İstifadə

Əl ilə İdarəetmə

Next Steps

📚 API Documentation

💡 Examples

🔧 Library Support

Следующие шаги

📚 Документация API

💡 Примеры

🔧 Поддержка библиотек

Növbəti Addımlar

📚 API Sənədləşməsi

💡 Nümunələr

🔧 Kitabxana Dəstəyi