Метод sendInvoice

Описание

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$apiUrl = "https://api.telegram.org/bot{$botToken}/sendInvoice";

$chatId = 123456789; // или '@channelusername'
$payload = uniqid('invoice_', true); // уникальный payload для идентификации платежа
$providerToken = 'YOUR_PROVIDER_TOKEN'; // токен от @BotFather, для Stars оставить пустую строку

$data = [
    'chat_id' => $chatId,
    'title' => 'Premium Subscription',
    'description' => 'Access to all premium features for 1 month',
    'payload' => $payload,
    'provider_token' => $providerToken,
    'currency' => 'USD',
    'prices' => json_encode([
        ['label' => 'Subscription', 'amount' => 999] // $9.99 в центах
    ]),
    'max_tip_amount' => 500, // $5.00 максимальные чаевые
    'suggested_tip_amounts' => json_encode([100, 200, 300, 500]), // $1, $2, $3, $5
    'start_parameter' => 'premium_sub',
    'photo_url' => 'https://example.com/product.jpg',
    'photo_size' => 20000,
    'photo_width' => 400,
    'photo_height' => 300,
    'need_name' => true,
    'need_email' => true,
    'need_shipping_address' => false,
    'is_flexible' => false,
    'disable_notification' => false,
    'protect_content' => false,
    'reply_markup' => json_encode([
        'inline_keyboard' => [
            [
                ['text' => 'Pay Now', 'pay' => true],
                ['text' => 'Cancel', 'callback_data' => 'cancel_invoice']
            ]
        ]
    ])
];

// Отправка запроса через cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // только для тестов, в продакшене убрать

$response = curl_exec($ch);
curl_close($ch);

// Обработка ответа
$result = json_decode($response, true);
if ($result['ok']) {
    echo "Invoice sent successfully. Message ID: " . $result['result']['message_id'];
} else {
    echo "Error: " . $result['description'];
}

// Альтернативный вариант с использованием библиотеки (например, TelegramBotPHP)
class TelegramBot {
    private $token;
    
    public function __construct($token) {
        $this->token = $token;
    }
    
    public function sendInvoice($params) {
        $url = "https://api.telegram.org/bot{$this->token}/sendInvoice";
        
        // Подготовка prices
        if (isset($params['prices']) && is_array($params['prices'])) {
            $params['prices'] = json_encode($params['prices']);
        }
        
        // Подготовка reply_markup
        if (isset($params['reply_markup']) && is_array($params['reply_markup'])) {
            $params['reply_markup'] = json_encode($params['reply_markup']);
        }
        
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $url,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => $params,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => ['Content-Type: multipart/form-data']
        ]);
        
        $response = curl_exec($ch);
        curl_close($ch);
        
        return json_decode($response, true);
    }
}

// Пример использования класса
$bot = new TelegramBot($botToken);

$invoiceParams = [
    'chat_id' => $chatId,
    'title' => 'Digital Product',
    'description' => 'Instant download of digital content',
    'payload' => 'order_12345',
    'provider_token' => $providerToken,
    'currency' => 'EUR',
    'prices' => [
        ['label' => 'Product', 'amount' => 2990],
        ['label' => 'VAT 20%', 'amount' => 598]
    ],
    'need_email' => true,
    'photo_url' => 'https://example.com/digital.jpg'
];

$result = $bot->sendInvoice($invoiceParams);

if ($result['ok']) {
    // Инвойс успешно отправлен
    $message = $result['result'];
    file_put_contents('invoice_log.txt', 
        date('Y-m-d H:i:s') . " - Invoice sent to {$chatId}\n", 
        FILE_APPEND
    );
}

// Пример для Telegram Stars (без provider_token)
$starsInvoice = [
    'chat_id' => $chatId,
    'title' => '100 Telegram Stars',
    'description' => 'Purchase Stars for premium content',
    'payload' => 'stars_purchase_001',
    'provider_token' => '', // Пустая строка для Stars
    'currency' => 'XTR', // Валюта для Stars
    'prices' => [
        ['label' => 'Stars', 'amount' => 100] // ровно один элемент для Stars
    ],
    'photo_url' => 'https://example.com/stars.jpg'
];

?>

python

import asyncio
from telegram import Bot, LabeledPrice
from telegram.constants import ParseMode

async def send_invoice_example():
    # Инициализация бота с токеном
    bot = Bot(token="YOUR_BOT_TOKEN")
    
    # Параметры для отправки инвойса
    chat_id = 123456789  # ID чата пользователя
    title = "Premium Subscription"
    description = "Access to premium features for 1 month"
    payload = "subscription_001"  # Внутренний идентификатор
    provider_token = "YOUR_PROVIDER_TOKEN"  # Токен платежного провайдера
    currency = "USD"
    
    # Цены (в минимальных единицах валюты, например центы для USD)
    prices = [
        LabeledPrice(label="Monthly Subscription", amount=999),  # $9.99
    ]
    
    # Дополнительные параметры (опционально)
    suggested_tip_amounts = [100, 200, 300, 500]  # $1, $2, $3, $5
    max_tip_amount = 1000  # $10
    photo_url = "https://example.com/product.jpg"
    
    try:
        # Отправка инвойса
        message = await bot.send_invoice(
            chat_id=chat_id,
            title=title,
            description=description,
            payload=payload,
            provider_token=provider_token,
            currency=currency,
            prices=prices,
            max_tip_amount=max_tip_amount,
            suggested_tip_amounts=suggested_tip_amounts,
            photo_url=photo_url,
            need_email=True,  # Запрашиваем email
            need_shipping_address=False,
            is_flexible=False,
            disable_notification=False,
            protect_content=False
        )
        
        print(f"Invoice sent successfully! Message ID: {message.message_id}")
        
    except Exception as e:
        print(f"Error sending invoice: {e}")

# Запуск асинхронной функции
if __name__ == "__main__":
    asyncio.run(send_invoice_example())

История изменений

• API 3.0. Добавлен метод sendInvoice
• API 3.5. Обновлен метод sendInvoice: Добавлены поля provider_data, send_phone_number_to_provider, send_email_to_provider
• API 5.0. Обновлен метод sendInvoice: Добавлено поле allow_sending_without_reply
• API 5.2. Обновлен метод sendInvoice: Добавлены поля max_tip_amount и suggested_tip_amounts для добавления чаевых, параметр start_parameter стал опциональным
• API 5.6. Обновлен метод sendInvoice: Добавлено поле protect_content
• API 6.3. Обновлен метод sendInvoice: Добавлен параметр message_thread_id
• API 7.0. Обновлен метод sendInvoice: Заменены параметры reply_to_message_id и allow_sending_without_reply на reply_parameters
• API 7.4. Обновлен метод sendInvoice: Добавлен параметр message_effect_id
• API 7.11. Обновлен метод sendInvoice: Добавлен параметр allow_paid_broadcast
• API 9.2. Обновлен метод sendInvoice: Добавлен параметр direct_messages_topic_id
• API 9.3. Обновлен метод sendInvoice: Поддержан параметр message_thread_id в личных чатах с темами для отправки сообщения в конкретную тему.

Дополнительно

• Message - Это основной объект, представляющий сообщение в Telegram, который содержит информацию об отправителе, чате, контенте (текст, медиа, служебные данные) и различные метаданные.
• LabeledPrice - Объект, представляющий отдельную позицию в структуре цены товаров или услуг с указанием названия и стоимости в минимальных единицах валюты.
• SuggestedPostParameters - Объект содержит параметры публикации, предлагаемой ботом, включая цену и дату отправки.
• ReplyParameters - Объект, описывающий параметры для ответа на сообщение, включая идентификатор сообщения, чат, цитирование и дополнительные настройки.
• InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.