sendInvoice
Ödeme için fatura gönderir.
Dönüş değeri: Başarılı olduğunda Message döndürür.
Parametreler
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
chat_id | Integer or String | Evet | Sohbet ID'si veya @username |
message_thread_id | Integer | İsteğe bağlı | Forum konusu ID'si |
direct_messages_topic_id | Integer | İsteğe bağlı | Doğrudan mesajlar konusu ID'si (Bot API 10.0) |
title | String | Evet | Ürün adı (1-32) |
description | String | Evet | Ürün açıklaması (1-255) |
payload | String | Evet | Payload |
provider_token | String | İsteğe bağlı | Ödeme sağlayıcısı token'ı |
currency | String | Evet | Para birimi (Stars için XTR) |
prices | Array of LabeledPrice | Evet | JSON LabeledPrice dizisi |
max_tip_amount | Integer | İsteğe bağlı | Maksimum bahşiş tutarı |
suggested_tip_amounts | Array of Integer | İsteğe bağlı | Önerilen bahşiş tutarlarının JSON dizisi |
start_parameter | String | İsteğe bağlı | Ödeme için deep link |
provider_data | String | İsteğe bağlı | Sağlayıcı için JSON verisi |
photo_url | String | İsteğe bağlı | Ürün fotoğrafı URL'si |
photo_size | Integer | İsteğe bağlı | Fotoğraf boyutu |
photo_width | Integer | İsteğe bağlı | Fotoğraf genişliği |
photo_height | Integer | İsteğe bağlı | Fotoğraf yüksekliği |
need_name | Boolean | İsteğe bağlı | Kullanıcının adını iste |
need_phone_number | Boolean | İsteğe bağlı | Telefon numarasını iste |
need_email | Boolean | İsteğe bağlı | E-posta adresini iste |
need_shipping_address | Boolean | İsteğe bağlı | Teslimat adresini iste |
send_phone_number_to_provider | Boolean | İsteğe bağlı | Telefon numarasını sağlayıcıya gönder |
send_email_to_provider | Boolean | İsteğe bağlı | E-posta adresini sağlayıcıya gönder |
is_flexible | Boolean | İsteğe bağlı | Esnek teslimat fiyatı |
disable_notification | Boolean | İsteğe bağlı | Sessiz gönder |
protect_content | Boolean | İsteğe bağlı | İçeriği koru |
allow_paid_broadcast | Boolean | İsteğe bağlı | Ücretli yayına izin ver |
message_effect_id | String | İsteğe bağlı | Mesaj efekti ID'si |
suggested_post_parameters | SuggestedPostParameters | İsteğe bağlı | JSON SuggestedPostParameters nesnesi (kanallar için) |
reply_parameters | ReplyParameters | İsteğe bağlı | JSON ReplyParameters nesnesi |
reply_markup | InlineKeyboardMarkup | İsteğe bağlı | JSON: InlineKeyboardMarkup |
Örnek istek
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());
Adım adım rehber: Telegram bot nasıl yapılır? BotFather ile adım adım bot oluşturma
İlgili metotlar
createInvoiceLinkÖdeme bağlantısı oluşturur.refundStarPaymentTelegram Stars ödemesini iade eder.sendGiftKullanıcıya veya sohbete hediye gönderir.getMyStarBalanceBotun Telegram Stars bakiyesini döndürür.getStarTransactionsBotun Telegram Stars işlemlerini döndürür.editUserStarSubscriptionTelegram Stars aboneliğini iptal eder veya yeniler.giftPremiumSubscriptionTelegram Premium aboneliği hediye eder.answerShippingQueryTeslimat sorgusunu yanıtlar.answerPreCheckoutQueryÖdeme öncesi sorguyu yanıtlar.getAvailableGiftsBotun gönderebileceği hediyeleri döndürür.getUserGiftsKullanıcının hediyelerini döndürür.getChatGiftsSohbetin hediyelerini döndürür.