Cara menyambungkan sistem pembayaran
Sistem pembayaran terbina dalam Telegram.
Untuk membuat pembayaran dalam messenger, anda perlu:
-
sambungkan sistem pembayaran ke bot dalam botfather bot
-
pergi ke tetapan bot yang dikehendaki dan dalam menu pilih Pembayaran
-
ikut arahan untuk menyambungkan sistem pembayaran yang boleh diakses dan salin token yang dikeluarkan
<br>
Cara Menghantar Invois kepada Pelanggan
Untuk menghantar invois ke telegram, gunakan kaedah
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) - parameter yang diperlukan diserlahkan dalam huruf tebal
provider_token - token yang diterima dalam Botfather, selepas menyambungkan sistem pembayaran
platform_id - penerima - pengecam pengguna, kumpulan atau saluran
title - tajuk item, 1-32 aksara
description - penerangan barang, 1-255 aksara
currency - mata wang pembayaran (RUB, USD, UAH dan sebagainya https://core.telegram.org/bots/payments#supported-currencies)
payload - bahagian pertama duit syiling tentang pembayaran, secara lalai tg_payment
prices - pecahan harga (penerangan di bawah)
photo_url - pautan ke gambar produk
disable_notification - 1 - hantar dengan pemberitahuan, 0 - tanpa pemberitahuan
protect_content - 1 perlindungan salinan dan tangkapan skrin, 0 - tidak dilindungi
need_name - 1 jika anda memerlukan nama pengguna penuh untuk melengkapkan pesanan, 0 - tanpa meminta nama
need_phone_number - 1 jika anda memerlukan nombor telefon pengguna untuk melengkapkan pesanan, 0 - tanpa nombor permintaan
need_email - 1 jika anda memerlukan alamat e-mel pengguna untuk melengkapkan pesanan, 0 - tanpa permintaan mel
reply_to_message_id - id mesej yang kami balas, '' bukan jawapan
reply_markup - papan kekunci, butang pertama mestilah butang dengan jenis bayar
Jika salah satu parameter need_name, need_phone_number atau need_email ditentukan, pengguna akan meminta data sebelum membayar dan menyimpannya ke pembolehubah pelanggan jika pembayaran berjaya. Dalam tangkapan skrin di bawah permintaan untuk semua input data:
prices - tatasusunan tatasusunan dengan data tentang kos barang dan perkhidmatan tambahan (penghantaran, pembungkusan, dll.). Dipaparkan pada halaman pembayaran. Jumlah hendaklah ditunjukkan sama ada dengan integer 125 atau dengan pecahan melalui titik 120.25 Contohnya: [["barang", 2000], ["VAT", 20.75], ["pembungkusan", 100]
Panggil balik pada pembayaran
Selepas pembayaran berjaya dalam sembang dengan pengguna, akan datang kolbeck seperti berikut:
phone_best 4737685 2120.75 UAH 1955518436
di mana phone_best - payload - daripada permintaan untuk penciptaan invois 473737685 - id sembang, yang pada asalnya dihantar invois 2120.75 - jumlah penuh pembayaran UAH - mata wang 1955518436 - id pembayaran dalam sistem pedagang
Juga, jika anda meminta nama, telefon dan/atau e-mel, pelanggan akan menulis pembolehubah:
tg_payment_name, tg_payment_phone dan tg_payment_email
Sekiranya berjaya, kolbek akan dihantar ke mesej peribadi pengguna. Untuk melakukan ini, pelanggan dan bot mesti bekerjasama sebelum pembayaran (pelanggan mesti melanggan bot)!
Selepas menerima cangkuk tentang pembayaran, pembayaran akan disahkan secara automatik, oleh answerPreCheckoutQuery https://core.telegram.org/bots/api#answerprecheckoutquery.
Contoh
prices = [["produk", 2000], ["NDS", 20.75], ["pakej", 100]]
result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'phoneW-200', 'Model Terbaik di Pasaran', 'UAH', prices, 'https://images11.popmeh.ru/cropped.jpg', 'phone_best', 0, 0, 1, 0, 1)
Contoh dengan set parameter minimum
prices = [["produk yang menakjubkan", 20000]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Bot terbaik yang pernah ada!',`` 'Kursus yang menakjubkan! Jadilah yang terbaik!', 'UAH', prices)
Contoh dengan Papan Kekunci
prices = [["produk", 2000], ["NDS", 20.75], ["pakej", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Telefon W-200', 'Model Terbaik di Pasaran', 'UAH', prices, 'https://helpix.ru/news/200405/181746/gf200_2.jpg', 'phone_best', 0, 0, 1, 1, 1, '', '{"inline_keyboard": [[{"text":"Bayar", "pay":"True"}], [{"text":"Satu lagi butang", "callback_data": "Satu lagi butang"}]]}')