createInvoiceLink

Kategori: Ödemeler · Bot API 10.3 · Resmi dokümantasyon

Ödeme bağlantısı oluşturur.

Dönüş değeri: Başarılı olduğunda String döndürür.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
`business_connection_id`	`String`	İsteğe bağlı	İşletme bağlantısı ID'si
`title`	`String`	Evet	Ürün adı
`description`	`String`	Evet	Ürün açıklaması
`payload`	`String`	Evet	Payload
`provider_token`	`String`	İsteğe bağlı	Ödeme sağlayıcısı token'ı
`currency`	`String`	Evet	Para birimi
`prices`	`Array of LabeledPrice`	Evet	JSON LabeledPrice dizisi
`subscription_period`	`Integer`	İsteğe bağlı	Abonelik süresi (saniye)
`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
`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ı	Adı iste
`need_phone_number`	`Boolean`	İsteğe bağlı	Telefonu 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 fiyat

Parametre açıklamaları kısa özetlerdir; tam metin için resmi dokümantasyona bakın.

Örnek istek

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/createInvoiceLink" \
  -H "Content-Type: application/json" \
  -d '{
  "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}/createInvoiceLink",
    json={
        "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}/createInvoiceLink`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "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

sendInvoiceÖdeme için fatura gönderir.
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.