Ödeme sistemine nasıl bağlanılır
Ödeme sistemi Telegram'a entegre edilmiştir.
Mesajlaşma uygulaması içinde ödeme almak için şunları yapmanız gerekir:
-
Botfather botu üzerinden ödeme sistemini botunuza bağlayın
-
İlgili bot ayarlarına gidin ve menüden Ödemeler seçeneğini seçin
-
Talimatları izleyerek erişilebilir bir ödeme sistemi bağlayın ve verilen token'ı kopyalayın
<br>
Müşteriye fatura nasıl kesilir
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 yazılmıştır
provider_token - Botfather'da ödeme sistemi bağlandıktan sonra alınan token
platform_id - alıcı - kullanıcı, grup veya kanalın tanımlayıcısı
title - ürün adı, 1-32 karakter
description - ürün açıklaması, 1-255 karakter
currency - ödeme para birimi (RUB, USD, UAH ve diğerleri https://core.telegram.org/bots/payments#supported-currencies)
payload - ödeme ile ilgili ilk kısım, varsayılan olarak tg_payment
prices - fiyat dökümü (açıklaması aşağıda)
photo_url - ürün resminin bağlantısı
disable_notification - 1 bildirimle gönder, 0 bildirimsiz gönder
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ı gerekiyorsa 1, isim sorulmazsa 0
need_phone_number - siparişi tamamlamak için kullanıcının telefon numarası gerekiyorsa 1, numara sorulmazsa 0
need_email - siparişi tamamlamak için kullanıcının e-posta adresi gerekiyorsa 1, e-posta sorulmazsa 0
reply_to_message_id - yanıt verilecek mesajın kimliği, '' yanıt değil
reply_markup - klavye, ilk düğme ödeme türünde bir düğme olmalıdır
Eğer need_name, need_phone_number veya need_email parametrelerinden biri belirtilirse, kullanıcı ödeme yapmadan önce verileri isteyecek ve ödeme başarılı olursa bu verileri müşteri değişkenlerine kaydedecektir. Aşağıdaki ekran görüntüsünde tüm veri girişi isteği görülmektedir:
prices - ürün ve ek hizmetlerin (teslimat, paketleme vb.) maliyetine ilişkin verileri içeren dizilerin bir dizisi. Ödeme sayfasında görüntülenir. Tutar, 125 gibi bir tam sayı veya 120.25 gibi nokta ile ayrılmış bir kesir olarak belirtilmelidir. Örneğin: [["ürün", 2000], ["KDV", 20.75], ["paketleme", 100]
Ödeme geri çağrısı
Başarılı ödemeden sonra kullanıcıyla yapılan sohbete şu şekilde bir geri çağrı gelecektir:
phone_best 4737685 2120.75 UAH 1955518436
burada phone_best - payload - fatura oluşturma isteğinden 473737685 - faturanın orijinal olarak gönderildiği sohbet kimliği 2120.75 - ödemenin tam tutarı UAH - para birimi 1955518436 - tüccar sistemindeki ödeme kimliği
Ayrıca, ad, telefon ve/veya e-posta istendiğinde, müşteri şu değişkenleri kaydedecektir:
tg_payment_name, tg_payment_phone ve tg_payment_email
Başarılı olması durumunda, geri çağrı kullanıcının kişisel mesajlarına gönderilecektir. Bunun için müşteri ve botun ödeme öncesinde işbirliği yapması gerekir (müşteri bota abone olmalıdır)!
Ödeme ile ilgili kanca alındıktan sonra, ödeme answerPreCheckoutQuery ile otomatik olarak onaylanacaktır https://core.telegram.org/bots/api#answerprecheckoutquery.
Örnekler
prices = [["ürün", 2000], ["KDV", 20.75], ["paket", 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 seti ile örnek
prices = [["harika bir ürün", 20000]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Şimdiye kadarki en iyi bot!',`` 'Harika bir kurs! En iyisi ol!', 'UAH', prices)
Klavye ile örnek
prices = [["ürün", 2000], ["KDV", 20.75], ["paket", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Telefon 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":"Öde", "pay":"True"}], [{"text":"Bir düğme daha", "callback_data": "Bir düğme daha"}]]}')