# Telegram
## Ödeme sistemine nasıl bağlanılır
### Ödeme sistemi Telegram’a entegredir.
Messenger içinde ödeme yapabilmek için şunlar gerekir:
* botfather botunda ödeme sistemini bot’a bağlayın
* İstediğiniz bot ayarlarına gidin ve menüden Ödemeler’i seçin
* erişilebilir bir ödeme sistemini bağlamak için talimatları izleyin ve verilen token’ı kopyalayın
## Müşteriye Fatura Kesme
Telegram’a fatura göndermek için şu yöntemi kullanın
tg\_send\_invoice(provider\_token, platform\_id, title, description, currency, prices, photo\_url, payload, protect\_content, disable\_notification, need\_name, phone\_number, need\_email, reply\_to\_message\_id, reply\_markup, reply\_id) - gerekli parametreler kalın olarak vurgulanmıştır
**provider\_token** - ödeme sistemi bağlandıktan sonra Botfather’dan alınan token
**platform\_id** - alıcı - kullanıcı, grup veya kanal kimliği
**title** - ürün başlığı, 1-32 karakter
**description** - ürün açıklaması, 1-255 karakter
**currency** - ödeme para birimi (RUB, USD, UAH ve benzeri )
**payload** - ödeme hakkındaki verinin ilk kısmı, varsayılan olarak tg\_payment
**prices** - fiyat dökümü (aşağıda açıklanmıştır)
**photo\_url** - ürün resmine bağlantı
**disable\_notification** - 1 - bildirimle gönder, 0 - bildirim olmadan
**protect\_content** - 1 kopyalama ve ekran görüntüsü koruması, 0 - korumasız
**need\_name** - siparişi tamamlamak için tam kullanıcı adının gerekli olması durumunda 1, isim sormadan için 0
**need\_phone\_number** - siparişi tamamlamak için kullanıcının telefon numarasını istiyorsanız 1, numara istemeden için 0
**need\_email** - siparişi tamamlamak için kullanıcının e-posta adresini istiyorsanız 1, e-posta istemeden için 0
**reply\_to\_message\_id** - yanıt verdiğimiz mesajın kimliği, '' yanıt değildir
**reply\_markup** - klavye, ilk düğme ödeme türünde bir düğme olmalıdır
need\_name, need\_phone\_number veya need\_email parametrelerinden biri belirtilirse, kullanıcı ödeme yapmadan önce verileri ister ve ödeme başarılı olursa bunları istemci değişkenlerine kaydeder. Aşağıdaki ekran görüntüsünde tüm veri girişleri için istek:
**prices** - ürünlerin ve ek hizmetlerin (teslimat, paketleme vb.) maliyetine ilişkin verileri içeren dizilerden oluşan bir dizi. Ödeme sayfasında gösterilir. Tutar ya 125 gibi bir tam sayı ya da 120.25 gibi nokta ile kesirli olarak belirtilmelidir. Örneğin: \[\["goods", 2000], \["VAT", 20.75], \["packaging", 100]
## Ödeme geri bildirimi
Kullanıcıyla yapılan sohbette başarılı ödemenin ardından şu şekilde bir kolbek gelecektir:
**phone\_best 4737685 2120.75 UAH 1955518436**
burada phone\_best - payload - fatura oluşturma isteğinden 473737685 - faturanın başlangıçta gönderildiği sohbet kimliği 2120.75 - toplam ödeme tutarı UAH - para birimi 1955518436 - satıcı sistemindeki ödeme kimliği
Ayrıca, ad, telefon ve/veya e-posta istediyseniz, istemci değişkenleri kaydeder:
**tg\_payment\_name, tg\_payment\_phone** ve **tg\_payment\_email**
{% hint style="info" %}
Başarı durumunda kolbek kullanıcının özel mesajlarına gönderilecektir. Bunun için müşteri ve bot ödeme öncesinde etkileşimde bulunmuş olmalıdır (müşteri bot’a abone olmalıdır)!
{% endhint %}
{% hint style="info" %}
Ödeme hakkında geri bildirim alındıktan sonra, ödeme answerPreCheckoutQuery ile otomatik olarak onaylanacaktır .
{% endhint %}
## Örnekler
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]]` \
`result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'phoneW-200', 'Piyasadaki En İyi Model', 'UAH', prices, 'https://images11.popmeh.ru/cropped.jpg', 'phone_best', 0, 0, 1, 0, 1)`
### Minimum parametre setiyle örnek
`prices = [["inanılmaz bir ürün", 20000]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Tüm zamanların en iyi botu!',`` ``'İnanılmaz bir kurs! En iyisi olun!'``, 'UAH', prices)`
### Klavye ile örnek
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Phone W-200', 'Piyasadaki En İyi Model', 'UAH', prices, 'https://helpix.ru/news/200405/181746/gf200_2.jpg', 'phone_best', 0, 0, 1, 1, 1, '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}], [{"text":"One more button", "callback_data": "One more button"}]]}')`
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mavibot.ai/doc/tr/integrations/payment/telegram.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.