API Pembayaran Bot

Menghubungkan Pembayaran

Untuk mulai menerima pembayaran, Anda memerlukan bot Telegram. Gunakan BotFather untuk membuat bot jika Anda belum memilikinya. Sekarang Anda memiliki bot pedagang yang dapat menawarkan barang atau jasa kepada pengguna Telegram. Sebut saja @merchantbot dalam dokumen ini.

Mendapatkan Token

• Gunakan perintah /mybots di obrolan dengan BotFather dan pilih @merchantbot yang akan menawarkan barang atau jasa.
• Masuk ke Pengaturan Bot > Pembayaran.
• Pilih penyedia, dan Anda akan diarahkan ke bot yang relevan.
• Masukkan detail yang diperlukan agar penyedia pembayaran terhubung dengan sukses, kembali ke obrolan dengan BotFather.
• Pesan sekarang akan menampilkan penyedia yang tersedia. Masing-masing akan memiliki nama, token, dan tanggal penyedia terhubung.
• Anda akan menggunakan token saat bekerja dengan API Bot.

Menerapkan Pembayaran

Anda akan menemukan metode yang diperlukan untuk membangun implementasi pembayaran Anda di Bagian Pembayaran dari Manual API Bot.

Menguji Pembayaran: Penyedia 'Stripe TEST MODE'

Saat Anda masih mengembangkan dan menguji pembayaran untuk bot, gunakan penyedia “Stripe TEST MODE”. Dalam mode ini, Anda dapat melakukan pembayaran tanpa benar-benar menagih akun mana pun. Kartu asli tidak dapat digunakan dalam mode uji, tetapi Anda dapat menggunakan kartu uji seperti 4242 4242 4242 4242 (daftar lengkap di sini). Anda dapat beralih antara mode uji dan mode langsung sebanyak yang Anda mau, tetapi lihat daftar periksa langsung sebelum Anda langsung.

1. Buat Faktur

Pengguna menghubungi @merchantbot dan meminta untuk membeli sesuatu. Bot membentuk pesan faktur dengan deskripsi barang atau jasa, jumlah yang harus dibayar, dan info pengiriman yang diminta. Ada dua cara untuk membuat faktur:

2. Pilih Perilaku Penerusan

Ada dua cara untuk menangani salinan yang diteruskan dari faktur Anda, dikendalikan oleh parameter start_parameter dalam metode sendInvoice.

• A. Faktur multi-obrolan. Salinan yang diteruskan menunjukkan tombol Bayar, yang dapat ditekan oleh beberapa pengguna dan mencoba membayar barang atau jasa. Faktur Inline selalu merupakan faktur multi-obrolan.
• B. Faktur obrolan tunggal. Faktur hanya dapat dibayar dari obrolan yang dikirim, salinan yang diteruskan menunjukkan tombol URL dengan tautan dalam ke bot. Tautan dalam dapat digunakan untuk menghasilkan faktur serupa di obrolan dengan bot, untuk menampilkan pesan kesalahan, atau untuk tujuan lain. Info lebih lanjut tentang Tautan Dalam.

Jika faktur obrolan tunggal dikirim ke obrolan dengan @merchantbot, faktur hanya dapat dibayar sekali. Jika faktur obrolan tunggal dikirim ke obrolan lain, faktur dapat dibayar berkali-kali oleh banyak pengguna.

Terlepas dari apakah tombol Bayar tersedia dalam faktur, bot pedagang selalu memiliki kekuasaan untuk memutuskan apakah akan menerima pembayaran baru untuk faktur tertentu.

3. Tip (langkah opsional)

Jika parameter max_tip_amount ditetapkan di atas 0, pengguna dapat menambahkan tip ke pembayaran mereka. Anda dapat menggunakan parameter suggested_tip_amounts untuk menyarankan jumlah tertentu yang Anda rasa relevan untuk faktur.

4. Info Pengiriman dan Detail Lainnya (langkah opsional)

Pengguna menentukan informasi pengiriman atau info lain yang diminta oleh bot. Ini bisa berupa nama lengkap pengguna, alamat email, nomor telepon dalam format internasional, atau alamat pos lengkap untuk pengiriman.

5. Tawarkan Opsi Pengiriman Berdasarkan Alamat Pengiriman (langkah opsional)

Jika alamat pengiriman diminta dan Anda menyertakan parameter is_flexible, API Bot akan mengirimkan Pembaruan dengan bidang shipping_query ke bot. Bot harus merespons menggunakan answerShippingQuery baik dengan daftar opsi pengiriman yang mungkin dan harga pengiriman yang relevan, atau dengan kesalahan (misalnya, jika pengiriman ke alamat yang ditentukan tidak memungkinkan).

Tip: Disarankan agar bot pedagang mengonfirmasi ketersediaan barang/jasa pada langkah ini – untuk memberi tahu pengguna jika barang/jasa tidak lagi tersedia. Ini sangat penting jika Anda menggunakan faktur multi-obrolan, inline, atau obrolan tunggal multi-penggunaan.

6. Pilih Opsi Pengiriman (langkah opsional)

Pengguna memilih opsi pengiriman dari daftar (jumlah total yang harus dibayar dapat berubah pada titik ini) dan melanjutkan ke checkout.

7. Pra-Checkout

Pengguna memasukkan informasi pembayaran mereka dan menekan tombol bayar akhir. Pada saat ini API Bot mengirimkan Pembaruan dengan bidang pre_checkout_query ke bot yang berisi semua informasi yang tersedia tentang pesanan. Bot Anda harus menjawab menggunakan answerPrecheckoutQuery dalam waktu 10 detik setelah menerima pembaruan ini atau transaksi dibatalkan.

Bot dapat mengembalikan kesalahan jika tidak dapat memproses pesanan karena alasan apa pun. Kami sangat menyarankan untuk menentukan alasan kegagalan dalam bentuk yang dapat dibaca manusia (misalnya, “Maaf, kami kehabisan bebek karet! Apakah Anda tertarik dengan beruang besi cor sebagai gantinya?”). Telegram akan menampilkan alasan ini kepada pengguna.

Peringatan: Sangat penting untuk memastikan bot Anda hanya menerima beberapa pembayaran ketika pesanan dapat diproses dengan benar. Ini sangat penting jika Anda menggunakan faktur multi-obrolan, inline, atau obrolan tunggal multi-penggunaan.

8. Checkout

Jika bot mengonfirmasi pesanan, Telegram meminta penyedia pembayaran untuk menyelesaikan transaksi. Jika informasi pembayaran dimasukkan dengan benar dan pembayaran berhasil, API akan mengirimkan pesan tanda terima dari jenis successful_payment dari pengguna. Setelah bot Anda menerima pesan ini, bot harus melanjutkan dengan mengirimkan barang atau jasa yang dibeli oleh pengguna.

Jika pesan faktur dikirim dalam obrolan dengan @merchantbot, itu menjadi Tanda Terima di UI untuk pengguna – mereka dapat membuka tanda terima ini kapan saja dan melihat semua detail transaksi. Tanda Terima. Jika pesan dikirim ke obrolan lain, tombol Bayar tetap ada dan dapat digunakan lagi. Terserah bot pedagang apakah benar-benar menerima beberapa pembayaran.

Daftar Periksa Live

• Kami sangat menyarankan untuk mengaktifkan verifikasi 2 langkah untuk akun Telegram yang mengontrol bot Anda.
• Anda sebagai pemilik bot memiliki tanggung jawab penuh jika terjadi konflik atau sengketa. Anda harus siap untuk memproses sengketa dan pembatalan biaya dengan benar (dalam kasus Stripe, lihat di sini).
• Untuk mencegah kesalahpahaman dan kemungkinan masalah hukum, pastikan bot Anda dapat merespons perintah /terms (atau menawarkan cara yang sama mudahnya untuk mengakses Syarat dan Ketentuan Anda). Syarat dan Ketentuan Anda harus ditulis dengan cara yang jelas dan mudah dipahami oleh pengguna Anda. Pengguna harus mengonfirmasi bahwa mereka telah membaca dan menyetujui syarat Anda sebelum melakukan pembelian.
• Bot Anda harus memberikan dukungan untuk pelanggannya, baik dengan merespons perintah /support atau dengan cara lain yang dikomunikasikan dengan jelas. Pengguna harus memiliki cara yang jelas untuk menghubungi Anda tentang pembelian mereka dan Anda harus memproses permintaan dukungan mereka secara tepat waktu. Anda harus memberi tahu pengguna Anda bahwa dukungan Telegram atau dukungan bot tidak akan dapat membantu mereka dengan pembelian yang dilakukan melalui bot Anda.
• Pastikan perangkat keras dan perangkat lunak server Anda stabil. Gunakan cadangan untuk memastikan Anda tidak kehilangan data tentang pembayaran pengguna Anda.
• Pastikan Anda telah menyelesaikan daftar periksa langsung untuk penyedia pembayaran yang Anda pilih juga.

Bagaimana cara bergabung sebagai penyedia pembayaran?

Jika Anda bekerja untuk perusahaan yang menyediakan layanan serupa dengan akun mandiri di Stripe Connect, beri tahu kami melalui dukungan bot (sertakan tagar #paymentsprovider dalam pesan Anda).

Berapa biaya yang dikenakan?

Telegram tidak mengenakan komisi apa pun untuk menggunakan API Pembayaran. Namun perlu dicatat, sebagian besar penyedia pembayaran akan memiliki komisi mereka sendiri. Misalnya, Stripe di AS mengenakan biaya 2,9% + 30 sen per biaya kartu yang berhasil (lihat situs web Stripe untuk detail lebih lanjut tentang harga).

Apakah saya perlu bot untuk menerima pembayaran?

Ya. Jika Anda bukan seorang pengembang, Anda perlu menyewa seseorang untuk membuat bot untuk Anda (disarankan), atau menggunakan bot yang dibuat oleh perusahaan pihak ketiga. Kami menyarankan kehati-hatian ekstra saat menggunakan layanan bot yang memproses pembayaran untuk Anda – Telegram tidak memelihara bot semacam itu dan tidak mendukung bot pihak ketiga yang menawarkan layanan ini.

Apa yang bisa dijual oleh bot saya?

Telegram tidak memberlakukan batasan apa pun pada produk atau layanan yang dapat ditawarkan bot Anda. Namun perlu dicatat bahwa Anda harus mematuhi aturan penyedia pembayaran yang Anda pilih dalam sistem kami. Misalnya, Stripe memiliki halaman khusus untuk bisnis yang dilarang – Anda mungkin ingin berkonsultasi dengan itu sebelum Anda mulai menjual organ yang dipanen.

Catatan Khusus: Karena keterbatasan Apple, pengembang bot saat ini tidak diizinkan menerima pembayaran untuk barang digital dan layanan virtual dari pengguna iOS.

Pembaruan 2024: Berkat perubahan terbaru dalam Pedoman Ulasan Apple, pengguna akan segera dapat membayar barang dan jasa digital dengan Telegram Stars di semua platform.

Bagaimana cara menangani sengketa?

Telegram bertindak sebagai penghubung antara pengguna yang membayar, pengembang bot, dan sistem pembayaran yang mereka pilih. Pengguna mengirimkan detail kartu kredit mereka langsung ke sistem pembayaran. Kemudian respons sistem pembayaran dan detail pengiriman yang dimasukkan oleh pengguna diteruskan ke pengembang bot sehingga mereka dapat memproses pesanan.

Karena Telegram tidak memproses pembayaran, kami tidak menyimpan dan tidak dapat mengakses data sensitif apa pun. Karena struktur ini, tidak mungkin bagi Telegram untuk menangani keluhan atau pengembalian uang – setiap pembayaran yang disengketakan adalah tanggung jawab pengembang bot, penyedia pembayaran, dan bank yang berpartisipasi dalam pertukaran.

Lihat juga: Kebijakan Privasi Telegram

Bagaimana cara mendukung pembayaran di aplikasi pihak ketiga saya yang menggunakan API Telegram?

Anda dipersilakan untuk mempelajari dokumentasi pembayaran MTProto.

Mata Uang yang Didukung

Pembayaran Telegram saat ini mendukung mata uang yang tercantum di bawah ini (berikut adalah versi JSON jika Anda membutuhkannya). Jika Anda menggunakan Stripe sebagai penyedia pembayaran, mata uang yang didukung dapat bervariasi tergantung pada negara yang Anda tentukan di akun Stripe Anda (info lebih lanjut).

Jumlah minimum dan maksimum untuk setiap mata uang kira-kira sesuai dengan batas US$1-10000. Jumlah tersebut harus dinyatakan dalam 12 digit atau kurang, sehingga nilai maksimum akan lebih rendah untuk beberapa mata uang bernilai lebih rendah. Perhatikan bahwa untuk setiap mata uang kecuali USD, batas ini bergantung pada nilai tukar dan dapat berubah seiring waktu (rencanakan ini saat Anda menerapkan batas dalam kode Anda).