sendInvoice

Kategori: Pembayaran · Bot API 10.3 · Dokumentasi resmi

Mengirim tagihan untuk pembayaran.

Nilai kembalian: Jika berhasil, mengembalikan Message.

Parameter

Parameter	Tipe	Wajib	Deskripsi
`chat_id`	`Integer or String`	Ya	ID chat atau @username
`message_thread_id`	`Integer`	Opsional	ID topik forum
`direct_messages_topic_id`	`Integer`	Opsional	ID topik pesan langsung (Bot API 10.0)
`title`	`String`	Ya	Nama produk (1-32)
`description`	`String`	Ya	Deskripsi produk (1-255)
`payload`	`String`	Ya	Payload
`provider_token`	`String`	Opsional	Token penyedia pembayaran
`currency`	`String`	Ya	Mata uang (XTR untuk Stars)
`prices`	`Array of LabeledPrice`	Ya	Array JSON LabeledPrice
`max_tip_amount`	`Integer`	Opsional	Jumlah tip maksimum
`suggested_tip_amounts`	`Array of Integer`	Opsional	Array JSON jumlah tip yang disarankan
`start_parameter`	`String`	Opsional	Deep link untuk pembayaran
`provider_data`	`String`	Opsional	Data JSON untuk penyedia
`photo_url`	`String`	Opsional	URL foto produk
`photo_size`	`Integer`	Opsional	Ukuran foto
`photo_width`	`Integer`	Opsional	Lebar foto
`photo_height`	`Integer`	Opsional	Tinggi foto
`need_name`	`Boolean`	Opsional	Minta nama pengguna
`need_phone_number`	`Boolean`	Opsional	Minta nomor telepon
`need_email`	`Boolean`	Opsional	Minta email
`need_shipping_address`	`Boolean`	Opsional	Minta alamat pengiriman
`send_phone_number_to_provider`	`Boolean`	Opsional	Kirim nomor telepon ke penyedia
`send_email_to_provider`	`Boolean`	Opsional	Kirim email ke penyedia
`is_flexible`	`Boolean`	Opsional	Harga pengiriman fleksibel
`disable_notification`	`Boolean`	Opsional	Kirim tanpa suara
`protect_content`	`Boolean`	Opsional	Lindungi konten
`allow_paid_broadcast`	`Boolean`	Opsional	Izinkan siaran berbayar
`message_effect_id`	`String`	Opsional	ID efek pesan
`suggested_post_parameters`	`SuggestedPostParameters`	Opsional	Objek JSON SuggestedPostParameters (untuk channel)
`reply_parameters`	`ReplyParameters`	Opsional	Objek JSON ReplyParameters
`reply_markup`	`InlineKeyboardMarkup`	Opsional	Objek JSON InlineKeyboardMarkup

Deskripsi parameter berupa ringkasan singkat; lihat dokumentasi resmi untuk teks lengkapnya.

Contoh permintaan

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());

Panduan langkah demi langkah: Cara Membuat Bot Telegram: dari BotFather sampai Pesan Pertama

createInvoiceLinkMembuat tautan pembayaran.
refundStarPaymentMengembalikan dana pembayaran Telegram Stars.
sendGiftMengirim hadiah ke pengguna atau chat.
getMyStarBalanceMengembalikan saldo Telegram Stars bot.
getStarTransactionsMengembalikan transaksi Telegram Stars bot.
editUserStarSubscriptionMembatalkan atau memperpanjang langganan Telegram Stars.
giftPremiumSubscriptionMenghadiahkan langganan Telegram Premium.
answerShippingQueryMenjawab shipping query.
answerPreCheckoutQueryMenjawab pre-checkout query.
getAvailableGiftsMengembalikan hadiah yang dapat dikirim bot.
getUserGiftsMengembalikan hadiah milik pengguna.
getChatGiftsMengembalikan hadiah milik chat.