sendInvoice
Надсилає рахунок на оплату.
Повертає: У разі успіху повертає Message.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
chat_id | Integer or String | Так | ID чату або @username |
message_thread_id | Integer | Ні | ID теми форуму |
direct_messages_topic_id | Integer | Ні | ID теми особистих повідомлень (Bot API 10.0) |
title | String | Так | Назва товару (1-32) |
description | String | Так | Опис товару (1-255) |
payload | String | Так | Payload |
provider_token | String | Ні | Токен платіжного провайдера |
currency | String | Так | Валюта (XTR для Stars) |
prices | Array of LabeledPrice | Так | JSON-масив LabeledPrice |
max_tip_amount | Integer | Ні | Максимальна сума чайових |
suggested_tip_amounts | Array of Integer | Ні | JSON-масив запропонованих сум чайових |
start_parameter | String | Ні | Діплінк для оплати |
provider_data | String | Ні | JSON-дані для провайдера |
photo_url | String | Ні | URL фото товару |
photo_size | Integer | Ні | Розмір фото |
photo_width | Integer | Ні | Ширина фото |
photo_height | Integer | Ні | Висота фото |
need_name | Boolean | Ні | Запитати ім’я користувача |
need_phone_number | Boolean | Ні | Запитати номер телефону |
need_email | Boolean | Ні | Запитати email |
need_shipping_address | Boolean | Ні | Запитати адресу доставки |
send_phone_number_to_provider | Boolean | Ні | Передати телефон провайдеру |
send_email_to_provider | Boolean | Ні | Передати email провайдеру |
is_flexible | Boolean | Ні | Гнучка вартість доставки |
disable_notification | Boolean | Ні | Надіслати без звуку |
protect_content | Boolean | Ні | Захистити вміст |
allow_paid_broadcast | Boolean | Ні | Дозволити платну розсилку |
message_effect_id | String | Ні | ID ефекту повідомлення |
suggested_post_parameters | SuggestedPostParameters | Ні | JSON-об’єкт SuggestedPostParameters (для каналів) |
reply_parameters | ReplyParameters | Ні | JSON-об’єкт ReplyParameters |
reply_markup | InlineKeyboardMarkup | Ні | JSON: InlineKeyboardMarkup |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendInvoice" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"title": "Example",
"description": "Example item",
"payload": "order-1",
"currency": "XTR",
"prices": [
{
"label": "Item",
"amount": 100
}
]
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendInvoice",
json={
"chat_id": 123456789,
"title": "Example",
"description": "Example item",
"payload": "order-1",
"currency": "XTR",
"prices": [
{
"label": "Item",
"amount": 100
}
]
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendInvoice`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"title": "Example",
"description": "Example item",
"payload": "order-1",
"currency": "XTR",
"prices": [
{
"label": "Item",
"amount": 100
}
]
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
createInvoiceLinkСтворює посилання на оплату.refundStarPaymentПовертає платіж у Telegram Stars.sendGiftНадсилає подарунок користувачеві або в чат.getMyStarBalanceПовертає баланс Telegram Stars бота.getStarTransactionsПовертає транзакції Telegram Stars бота.editUserStarSubscriptionСкасовує або поновлює підписку в Telegram Stars.giftPremiumSubscriptionДарує підписку Telegram Premium.answerShippingQueryВідповідає на запит щодо доставки.answerPreCheckoutQueryВідповідає на запит перед оплатою (pre-checkout).getAvailableGiftsПовертає подарунки, які бот може надіслати.getUserGiftsПовертає подарунки користувача.getChatGiftsПовертає подарунки чату.