Pembayaran di Telegram memungkinkan pembeli membayar ke bot atau Mini App tanpa keluar dari chat. Bot mengirim tagihan, Telegram membuka lembar pembayarannya sendiri, dan uangnya sampai ke penjual lewat penyedia pembayaran (untuk barang fisik) atau dalam bentuk Telegram Stars (untuk barang digital). Panduan ini menjelaskan cara kerja pembayaran di Telegram, opsi mana yang cocok dengan apa yang Anda jual, berapa biaya masing-masing, dan cara mulai menerima pembayaran langkah demi langkah, dengan atau tanpa coding.
Mencari daftar lengkap metode yang bisa dihubungkan ke toko, termasuk TON dan dompet digital Asia Tenggara? Semuanya ada di metode pembayaran Telegram. Halaman ini membahas cara kerja pembayaran di Telegram dan cara mengaktifkannya.
Cara kerja pembayaran di Telegram#
Bot Payments API milik Telegram adalah platform terbuka dan gratis. Ada dua jalur:
- Barang fisik dan jasa dibayar lewat penyedia pihak ketiga. Telegram bekerja sama dengan lebih dari 20 penyedia, dan pembeli bisa membayar dari lebih dari 200 negara. Telegram tidak memungut komisi atas pembayaran ini dan tidak menyimpan data kartu; kartu ditangani oleh penyedia. Lembar pembayaran Telegram mendukung Apple Pay dan Google Pay.
- Barang dan jasa digital wajib dibayar dengan Telegram Stars, kode mata uang
XTR. Telegram menyatakan bahwa bot atau Mini App Anda bisa tidak ditampilkan ke pengguna seluler jika Anda menjual barang digital dengan mata uang lain atau lewat penyedia pihak ketiga.
Setiap pembayaran selalu melewati alur yang sama:
- Tagihan. Bot mengirim tagihan berisi item dan totalnya (
sendInvoice), atau Mini App membukanya dari sebuah tautan. - Pengiriman (opsional). Jika ongkos kirim bergantung pada alamat, Telegram lebih dulu meminta opsi pengiriman dari bot.
- Pemeriksaan sebelum checkout. Sebelum menagih, Telegram meminta bot mengonfirmasi pesanan. Bot punya waktu 10 detik untuk menjawab, jika tidak pembayaran dibatalkan.
- Pembayaran. Pembeli mengonfirmasi di lembar pembayaran: kartu, Apple Pay, Google Pay, atau Stars.
- Konfirmasi. Bot menerima pesan
successful_paymentlalu memproses pesanan.
Opsi mana yang cocok dengan produk Anda#
| Opsi | Pembeli membayar dengan | Untuk | Potongan Telegram | Pengaturan |
|---|---|---|---|---|
| Telegram Stars | Saldo Stars | Barang digital: file, akses, keanggotaan | Penjual menerima sekitar $0,013 per Star | Tidak perlu menghubungkan apa pun |
| Penyedia kartu via @BotFather (Stripe, Freedom Pay, dan lainnya) | Kartu, Apple Pay, Google Pay di lembar pembayaran Telegram | Barang fisik dan jasa offline | Tidak ada; penyedia memungut biayanya sendiri | Token penyedia |
| Stripe Connect (Tiny Shops) | Kartu di halaman checkout aman Stripe | Barang fisik di negara yang didukung Stripe | Tidak ada; berlaku biaya Stripe | Onboarding Stripe dari dashboard |
| TON | Dompet TON apa pun | Pembeli yang paham kripto, lintas negara | Tidak ada | Alamat dompet |
| Pesanan manual | Sesuai kesepakatan: tunai, transfer | Pengiriman lokal, bayar di tempat (COD) | Tidak ada | Tidak perlu apa-apa |
Biaya penyedia berbeda-beda tergantung negara dan kontrak. Stripe mencantumkan tarifnya di stripe.com/pricing; penyedia seperti Freedom Pay menetapkannya dalam perjanjian Anda. Cek angka yang berlaku untuk Anda langsung ke penyedia, bukan dari tabel di blog.
Sekilas tentang Telegram Stars#
Pembeli mendapatkan Stars lewat pembelian dalam aplikasi Apple atau Google atau lewat @PremiumBot, lalu membelanjakannya di bot dan Mini App. Bagi penjual, nilainya diatur oleh ketentuan developer bot Telegram:
- Sekitar $0,013 per Star sebagai imbalan, diproses melalui Fragment.
- $0,02 per Star jika saldonya Anda pakai untuk Telegram Ads.
- Hingga 21 hari sebelum Stars yang diterima bisa dipakai untuk imbalan atau iklan.
Stars hanya berupa bilangan bulat, fitur tip tidak tersedia, dan Telegram tidak meneruskan nama, nomor telepon, atau alamat pembeli bersama pembayaran Stars. Pengembalian dana dilakukan lewat Bot API (refundStarPayment), dan bot yang berjualan dengan Stars wajib menjawab perintah /paysupport. Perbandingan lengkap dengan kartu, termasuk tabel konversi Stars ke USD, ada di Telegram Stars vs Stripe.
Cara menerima pembayaran di Telegram (cara umum)#
Jika Anda membuat bot sendiri, berikut langkah-langkahnya menurut dokumentasi Telegram:
- Buat bot dengan @BotFather. Panduan bot kami menjelaskannya langkah demi langkah.
- Dapatkan token penyedia. Di @BotFather:
/mybots→ bot Anda → Bot Settings → Payments. Pilih penyedia, selesaikan pendaftarannya, lalu salin tokennya. Mulailah dengan token uji coba. Untuk Stars, lewati langkah ini: tokennya berupa string kosong. - Kirim tagihan dari kode Anda dengan
sendInvoiceataucreateInvoiceLink, dalam mata uang yang didukung penyedia Anda. - Jawab pre-checkout query dalam 10 detik, juga shipping query jika Anda memakai ongkir fleksibel.
- Tangani
successful_payment: tandai pesanan sebagai lunas dan kirim barangnya. - Ikuti daftar periksa live dari Telegram: verifikasi dua langkah di akun pemilik bot, perintah
/termsyang disetujui pembeli, perintah/support, dan kesiapan menangani sengketa serta chargeback sendiri. Setelah itu ganti token uji coba dengan token live (ada:LIVE:di bagian tengahnya).
Pembuat toko (store builder) mengerjakan langkah 3 sampai 5 untuk Anda, sekaligus katalog, keranjang, dan notifikasi pesanan.
Cara menerima pembayaran Telegram di Tiny Shops#
Tiny Shops adalah pembuat toko Mini App Telegram tanpa coding. Toko Anda terbuka di dalam bot Anda sendiri, dan checkout berakhir di lembar pembayaran Telegram.
Kartu melalui penyedia Telegram#
- Dapatkan token uji coba di @BotFather →
/mybots→ bot toko Anda → Bot Settings → Payments. Panduan langkah demi langkah untuk dua penyedia: Stripe dan Freedom Pay. - Buka Storefront Settings → Orders & Payments. Di bagian Checkout Mode, pilih Telegram Payments.
- Klik Add Provider. Isi Provider Name (label apa saja, misalnya "Stripe"), tempel token di Provider Token, biarkan Test Mode dan Active tetap aktif, lalu klik Save Provider.
- Periksa mata uang toko di Store Currency. Mata uangnya harus didukung oleh penyedia Anda. Jika pembayaran gagal dengan
PAYMENT_PROVIDER_INVALID, biasanya penyebabnya mata uang. - Buka Checkout → Payment methods dan pastikan Telegram Invoice ada di daftar. Jika belum, klik Add method dan tambahkan. Statusnya menjadi Connected setelah ada penyedia yang aktif.
- Pilih kolom tagihan. Di Invoice Field Configuration, aktifkan Request Name, Request Phone Number, Request Email, atau Request Shipping Address sesuai kebutuhan. Flexible Shipping Pricing membuat ongkos kirim bisa bergantung pada alamat. Enable Tips menambahkan hingga 4 pilihan nominal tip dan Maximum Tip Amount.
- Buat pesanan uji coba dari ponsel Anda. Dengan token uji Stripe, gunakan kartu uji Telegram
4242 4242 4242 4242, tanggal kedaluwarsa kapan saja di masa depan, dan CVC apa saja. - Mulai live. Ambil token live dari @BotFather, klik Edit Provider, tempel tokennya, matikan Test Mode, lalu simpan.
Telegram Stars#
- Di Storefront Settings → Orders & Payments, pilih Telegram Payments, lalu atur Store Currency ke Telegram Stars (XTR). Halaman akan menampilkan Telegram Stars Enabled: tidak perlu token maupun pengaturan lain.
- Di Checkout → Payment methods, tambahkan Telegram Stars.
- Beri harga produk dalam Stars bulat.
Satu toko punya satu mata uang, jadi sebuah toko menerima Stars atau penyedia kartu, bukan keduanya. Jika Anda menjual barang kiriman sekaligus barang digital, jalankan sebagai dua toko dalam satu akun.
Opsi lainnya#
Stripe Connect (kartu di halaman checkout Stripe, pencairan ke akun Stripe Anda sendiri), TON, Xendit untuk Indonesia, Filipina, dan Malaysia, serta Manual order semuanya diatur dari Checkout → Payment methods. Langkah untuk masing-masing ada di metode pembayaran Telegram.
Apple Pay dan Google Pay di Telegram#
Anda tidak perlu mengaktifkan dompet digital secara terpisah. Lembar pembayaran Telegram mendukung Apple Pay dan Google Pay, dan keduanya muncul jika penyedia Anda serta perangkat pembeli mendukungnya. Jika pembeli tidak melihat Apple Pay, cek apakah penyedia Anda menawarkannya di negara Anda. Pembayaran Stars sama sekali tidak memakai dompet digital: pembeli membayar dari saldo Stars mereka.
Berapa biayanya#
Telegram tidak memotong apa pun dari pembayaran lewat penyedia; penyedia Anda memungut biayanya sendiri. Tiny Shops gratis ($0) di paket Free, $9,99 di Starter, $29 di Pro, dan $79 di Scale per bulan, dan setiap pesanan dikenai persentase paket dari totalnya: 5%, 3%, 1,5%, atau 0,7%. Setiap akun mendapat 50 pesanan pertama gratis, satu kali saja, bukan setiap bulan. Penjualan Stars dikenai persentase sejak penjualan pertama. Pro membayar maksimal $149 per bulan untuk persentase, Scale maksimal $79. Detailnya di halaman harga.
Mengatasi masalah#
| Gejala | Kemungkinan penyebab | Solusi |
|---|---|---|
Pembayaran gagal dengan PAYMENT_PROVIDER_INVALID | Penyedia tidak mendukung mata uang toko Anda | Ubah Store Currency atau tanyakan ke penyedia mata uang apa saja yang diterima |
| Telegram Invoice menampilkan Not connected | Belum ada penyedia yang aktif | Tambahkan di Orders & Payments dan biarkan Active menyala |
| Stars tidak muncul saat checkout | Mata uang toko bukan XTR | Atur Store Currency ke Telegram Stars (XTR) |
| Pembayaran uji coba berhasil, pembayaran sungguhan gagal | Masih memakai token uji coba | Tempel token live dan matikan Test Mode |
| Tidak ada notifikasi pesanan | Tujuan notifikasi belum diatur | Atur di Order Notifications lalu tekan Send test order alert |
FAQ#
Bagaimana cara kerja pembayaran di Telegram? Bot mengirim tagihan, Telegram menampilkan lembar pembayaran bawaan, pembeli membayar dengan kartu, dompet digital, atau Stars, lalu bot menerima konfirmasi dan memproses pesanan. Kartu diproses lewat penyedia pihak ketiga; Stars tetap berada di dalam Telegram.
Apakah Telegram memungut biaya untuk pembayaran? Tidak untuk pembayaran lewat penyedia pihak ketiga; penyedia memungut biayanya sendiri. Dengan Stars, penjual menerima sekitar $0,013 per Star sebagai imbalan, sesuai ketentuan developer Telegram.
Bisakah saya menerima Apple Pay di Telegram? Bisa, jika penyedia Anda mendukungnya. Apple Pay dan Google Pay muncul di lembar pembayaran Telegram tanpa pengaturan tambahan di toko.
Bisakah saya menjual produk digital dengan pembayaran kartu di Telegram? Tidak di dalam bot atau Mini App. Telegram mewajibkan Stars untuk barang dan jasa digital, dan bisa menyembunyikan bot dari pengguna seluler jika bot itu menjualnya dengan mata uang lain.
Apakah saya butuh developer? Tidak jika memakai pembuat toko. Di Tiny Shops, pengaturannya cukup token dari @BotFather dan beberapa setelan di dashboard.
Buka toko Anda dan terima pembayaran Telegram pertama di tiny-shops.com →
