createInvoiceLink

Kategori: Pembayaran · Bot API 10.3 · Dokumentasi resmi

Membuat tautan pembayaran.

Nilai kembalian: Jika berhasil, mengembalikan String.

Parameter

Parameter	Tipe	Wajib	Deskripsi
`business_connection_id`	`String`	Opsional	ID koneksi bisnis
`title`	`String`	Ya	Nama produk
`description`	`String`	Ya	Deskripsi produk
`payload`	`String`	Ya	Payload
`provider_token`	`String`	Opsional	Token penyedia pembayaran
`currency`	`String`	Ya	Mata uang
`prices`	`Array of LabeledPrice`	Ya	Array JSON LabeledPrice
`subscription_period`	`Integer`	Opsional	Periode langganan dalam detik
`max_tip_amount`	`Integer`	Opsional	Jumlah tip maksimum
`suggested_tip_amounts`	`Array of Integer`	Opsional	Array JSON jumlah tip yang disarankan
`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
`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 fleksibel

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

Contoh permintaan

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

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

sendInvoiceMengirim tagihan untuk 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.