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 https://core.telegram.org/bots/payments#supported-currencies)

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

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)!

Ödeme hakkında geri bildirim alındıktan sonra, ödeme answerPreCheckoutQuery ile otomatik olarak onaylanacaktır https://core.telegram.org/bots/api#answerprecheckoutquery .

Ö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"}]]}')