# Часто задаваемые вопросы NEONPAY

## Общие вопросы

### Что такое NEONPAY?

NEONPAY — это современная, универсальная библиотека обработки платежей для Telegram ботов. Она делает интеграцию платежей Telegram Stars невероятно простой.

### Какие библиотеки ботов поддерживает?

NEONPAY поддерживает следующие библиотеки ботов:
- Pyrogram
- Aiogram
- python-telegram-bot
- pyTelegramBotAPI
- Raw Bot API

### Что такое Telegram Stars?

Telegram Stars — это официальная виртуальная валюта Telegram. Пользователи могут использовать Stars для различных сервисов и продуктов в Telegram.

## Установка и конфигурация

### Как установить NEONPAY?

```bash
pip install neonpay
```

### Какие минимальные требования?

- Python 3.9+
- Одна из поддерживаемых библиотек ботов
- Telegram bot token

### Какие дополнительные пакеты нужны?

NEONPAY имеет минимальные зависимости. Нужно установить только выбранную библиотеку ботов.

## Использование

### Как базовое использование?

```python
from neonpay import create_neonpay, PaymentStage

neonpay = create_neonpay(your_bot_instance)
stage = PaymentStage("Premium", "Премиум функции", 100)
neonpay.create_payment_stage("premium", stage)
await neonpay.send_payment(user_id, "premium")
```

### Как обрабатывать платежи?

```python
@neonpay.on_payment
async def handle_payment(result):
    if result.status == PaymentStatus.COMPLETED:
        print(f"Платеж получен: {result.amount} stars")
```

### Можно ли создать несколько этапов платежей?

Да, вы можете создать столько этапов платежей, сколько нужно:

```python
neonpay.create_payment_stage("basic", basic_stage)
neonpay.create_payment_stage("premium", premium_stage)
neonpay.create_payment_stage("enterprise", enterprise_stage)
```

## Ошибки и проблемы

### Получаю ошибку "PaymentError"

Эта ошибка обычно связана с отсутствием этапа платежа или неправильной конфигурацией. Убедитесь, что этап платежа создан правильно.

### Бот не принимает платежи

Проверьте следующее:
1. Bot token правильный
2. Этап платежа создан
3. Бот активен в Telegram
4. У пользователя есть Telegram Stars

### Проблема с async/sync

NEONPAY поддерживает как async, так и sync использование. Проверьте поддержку async в вашей библиотеке ботов.

## Производительность и оптимизация

### Какая производительность у NEONPAY?

NEONPAY оптимизирована для высокой производительности. Обеспечивает минимальное использование памяти и быструю обработку.

### Поддержка множественных пользователей

Да, NEONPAY предназначена для работы с множественными пользователями. Благодаря async архитектуре может обрабатывать высокие нагрузки.

### Использование памяти

NEONPAY использует минимальную память. Этапы платежей и метаданные хранятся в памяти.

## Безопасность

### Безопасен ли NEONPAY?

Да, NEONPAY реализует различные меры безопасности:
- Валидация входных данных
- Проверка подписи webhook
- Обработка ошибок
- Безопасная интеграция API

### Безопасность webhook

NEONPAY обеспечивает проверку подписи webhook. Это подтверждает, что webhook действительно приходят от Telegram.

## Поддержка и разработка

### Где получить поддержку?

- GitHub Issues: https://github.com/Abbasxan/neonpay/issues
- Telegram: @neonsahib
- Email: sultanov.abas@outlook.com

### Является ли NEONPAY открытым исходным кодом?

Да, NEONPAY является открытым исходным кодом под лицензией MIT.

### Могу ли я внести вклад?

Да, вклад приветствуется! Отправьте Pull Request на GitHub.

## Планы на будущее

### Какие функции планируются?

- Поддержка большего количества библиотек ботов
- Улучшенная аналитика
- Поддержка множественных валют
- Улучшенная функциональность webhook

### Как часто выходят обновления версий?

NEONPAY активно разрабатывается. Основные обновления выходят каждые 2-3 месяца, мелкие исправления чаще.

