Cara Menerima Pembayaran Kripto di Bot Telegram (USDT Langkah demi Langkah)
Bot Telegram dan komunitas berbayar bergantung pada pengiriman instan. Begini cara menghubungkan payment gateway kripto ke bot Anda agar pengguna membayar dengan USDT dan langsung mendapat akses.
Untuk menerima pembayaran kripto di bot Telegram, buat backend bot Anda membuat invoice lewat API payment gateway kripto ketika pengguna menekan "Beli", kirim tautan checkout yang dikembalikan sebagai tombol inline, lalu dengarkan webhook bertanda tangan dari gateway. Setelah pembayaran terkonfirmasi, bot otomatis mengirim produk, kunci, atau undangan channel.
Bot Telegram dan komunitas berbayar adalah salah satu kecocokan paling alami untuk checkout kripto: penggunanya internasional, banyak yang sudah memegang USDT, dan mereka mengharapkan pengiriman dalam hitungan detik. Panduan ini menjelaskan arsitektur, alur pesan, dan detail yang membuatnya andal.
Mengapa kripto sangat cocok untuk bot Telegram
- Audiens global: pengguna bot datang dari mana saja; satu harga dalam USDT berlaku untuk semuanya.
- Pembayaran mobile-first: checkout hosted terbuka di browser Telegram, dan aplikasi dompet bisa memindai kode QR atau menyalin alamat.
- Otomatisasi instan: webhook bertanda tangan membuat bot bisa mengirim pesanan tanpa ada yang mengecek block explorer.
- Jaringan cepat: di TRON dan BNB Smart Chain, pembayaran biasanya terkonfirmasi dalam sekitar satu menit.
Bot Telegram dan komunitas berbayar adalah salah satu kasus penggunaan inti yang menjadi tujuan dibangunnya mistKET, selain SaaS, hosting, dan produk digital.
Arsitektur: tiga komponen
| Komponen | Peran |
|---|---|
| Bot Telegram (via Bot API) | Berinteraksi dengan pengguna: menu, tombol, pesan pengiriman |
| Backend Anda | Menyimpan pesanan, memanggil API gateway, menerima webhook, menyimpan secret |
| Gateway mistKET | Checkout hosted, pemantauan blockchain, konfirmasi, settlement |
Framework apa pun yang Anda gunakan, pola untuk menerima pembayaran kripto di bot Telegram tetap sama. Bot dan backend biasanya adalah satu layanan kecil yang sama. Yang penting, secret API dan webhook disimpan di server — jangan pernah di dalam pesan atau kode sisi klien. Dokumentasi resmi Telegram untuk bot ada di core.telegram.org.
Langkah demi langkah: menerima pembayaran kripto di bot Telegram
- Pengguna memilih produk — misalnya "Akses 1 bulan" lewat inline keyboard. Backend Anda membuat pesanan dengan ID pengguna Telegram.
- Backend membuat invoice — satu
POST /api/v1/invoicesbertanda tangan berisi nominal, mata uang, ID pesanan Anda, dan URL callback. - Bot mengirim tombol bayar — tombol URL inline yang mengarah ke
checkout_urlyang dikembalikan, ditambah catatan singkat: "Kirim nominal yang tepat di jaringan yang Anda pilih." - Pengguna membayar — di halaman hosted ia memilih USDT di TRON, BSC, Ethereum, atau Arbitrum (atau TRX, BNB, ETH) dan membayar dari dompet atau exchange-nya.
- Webhook masuk — setelah konfirmasi, callback Anda menerima event
invoice.confirmedbertanda tangan yang berisi ID pesanan Anda. - Bot mengirim pesanan — verifikasi tanda tangan, tandai pesanan lunas, lalu kirim kunci lisensi, file, atau tautan undangan channel sekali pakai ke chat pengguna.
Model data minimal
Anda tidak memerlukan database rumit untuk menjalankan bot berbayar. Tiga tabel sudah mencakup sebagian besar kasus:
| Tabel | Field utama | Fungsi |
|---|---|---|
| users | telegram_id, username, access_until | Siapa yang punya akses dan sampai kapan |
| orders | order_id, telegram_id, product, amount, status | Satu baris per percobaan pembelian |
| invoices | order_id, invoice_uuid, checkout_url, network, paid_amount | Penghubung antara pesanan Anda dan invoice gateway |
Saat webhook masuk, cari pesanan berdasarkan order_id, pastikan belum pernah dikirim, perbarui status, lalu kirim pesan ke pengguna berdasarkan telegram_id. Itulah seluruh siklus pengirimannya.
Contoh teks pesan
Kata-kata yang jelas di dalam chat mengurangi pertanyaan ke tim dukungan. Urutan yang terbukti efektif:
- Pesan invoice: "Pesanan Anda: akses 1 bulan, 15 USD. Tekan Bayar untuk membuka halaman pembayaran yang aman. Kirim nominal yang tepat di jaringan yang Anda pilih."
- Dibayar: "Pembayaran terdeteksi. Menunggu konfirmasi jaringan — biasanya satu atau dua menit."
- Terkonfirmasi: "Pembayaran terkonfirmasi. Ini tautan undangan Anda — hanya bisa dipakai sekali."
- Kurang bayar: "Kami menerima kurang dari nominal invoice. Buka halaman pembayaran yang sama untuk mengirim sisanya."
- Kedaluwarsa: "Invoice ini sudah kedaluwarsa. Tekan di bawah untuk membuat yang baru."
Dukungan tanpa tangkapan layar
Saat pengguna bertanya soal pembayaran, cukup minta nomor pesanannya. Dengan membuka invoice di dashboard merchant, Anda melihat nominal diharapkan, nominal diterima, jaringan, dan hash transaksi, sehingga tidak perlu tangkapan layar atau alamat dompet dari pengguna. Tombol "Bantuan" di bot bisa meneruskan nomor pesanan secara otomatis, sehingga sebagian besar pertanyaan pembayaran selesai dalam sepuluh detik, bukan percakapan panjang.
Pola UX yang baik di dalam chat
- Kirim pembaruan status. Pada
invoice.paid, balas "Pembayaran terlihat, menunggu konfirmasi"; padainvoice.confirmed, kirim pesanan. - Tampilkan harga dalam dolar dan biarkan gateway yang mengonversi. Kurs dikunci selama masa berlaku invoice.
- Jelaskan hitung mundur sekali saja, agar pengguna tidak panik saat melihat timer.
- Sediakan tombol "Cek status" yang menanyakan status invoice lewat API — berguna jika pengguna kembali belakangan.
- Tangani pembayaran kurang dengan sopan. Pada
invoice.underpaid, beri tahu berapa kekurangannya; pembayaran parsial dijumlahkan sampai total. - Tangani kedaluwarsa. Pada
invoice.expired, tawarkan invoice baru dengan satu ketukan.
Langganan dan komunitas berbayar
Untuk akses bulanan, buat invoice baru setiap akhir periode dan kirim sebagai pesan perpanjangan beberapa hari sebelumnya. Saat invoice.confirmed masuk, perpanjang tanggal akses pengguna di database Anda. Jika tidak ada pembayaran sebelum periode berakhir, cabut aksesnya. Transfer kripto dikirim oleh pembayar, jadi setiap perpanjangan selalu berupa invoice yang dibayar pengguna — tidak ada pendebetan otomatis seperti kartu.
Checklist keandalan
- Idempotensi: webhook dikirim ulang dengan jeda bertahap selama berjam-jam, jadi event yang sama bisa datang dua kali. Periksa apakah pesanan sudah dikirim sebelum mengirim apa pun.
- Pemeriksaan tanda tangan: verifikasi
X-Mistket-Signature(HMAC-SHA256 dari timestamp dan raw body dengan secret webhook Anda) sebelum memercayai event apa pun. - Pesan chat bukan bukti. Pengguna yang bilang "sudah bayar" atau mengirim tangkapan layar tidak pernah bisa menggantikan webhook.
- Allow-list IP: batasi akses API hanya untuk server bot Anda di panel merchant.
- Log: dashboard menampilkan log pengiriman webhook, nominal diharapkan vs. diterima, dan hash transaksi untuk kasus dukungan.
Untuk contoh kode lengkap penandatanganan dan verifikasi, lihat integrasi API pembayaran kripto.
Belum punya developer? Mulai dengan link pembayaran
Jika Anda mengelola grup berbayar kecil secara manual, Anda bisa membuat invoice di panel merchant dan mengirim tautannya lewat pesan pribadi. Setelah pembayaran terkonfirmasi di dashboard, tambahkan anggota secara manual. Cara ini tidak bisa diskalakan, tetapi memungkinkan Anda menguji harga sebelum membangun bot. Lihat link pembayaran dan invoice kripto.
Mulai sekarang
Siap menerima pembayaran kripto di bot Telegram Anda sendiri? Ajukan akun merchant melalui Telegram @mistnetwork dengan menyertakan tautan bot atau komunitas dan perkiraan volume. Setelah disetujui, Anda menerima kunci API di hari yang sama. Lihat contoh request dan webhook di bagian developer dan kelola kunci Anda dari login merchant.
