Pembayaran kripto di bot Telegram: faktur, webhook, pembayaran keluar
Merchant API adalah API pembayaran TgPay Crypto untuk bot dan layanan. Buat aplikasi, dapatkan token, buat faktur dari kode, lalu terima webhook pembayaran bertanda tangan. Agen MCP yang kompatibel bisa membantu integrasi. Pembayaran dari saldo dompet diproses di dalam layanan; pembayaran lewat blockchain mengikuti aturan konfirmasi jaringan yang dipilih.
Alamat API — app.tgpaycrypto.com/pay/api · testnet — testnet.tgpaycrypto.com
Dari token ke pembayaran pertama dalam empat langkah
Buat faktur, tampilkan link, lalu tunggu peristiwa pembayaran, seperti API pembayaran pada umumnya.
Buat aplikasi
Di bot, buka Lainnya → Merchant API, lalu masukkan nama dan URL webhook. Token hanya ditampilkan sekali. Simpan di servermu.
Buat faktur
Satu permintaan POST createInvoice: jumlah dalam kripto atau fiat, deskripsi, dan tenggat. Respons berisi link pembayaran.
Tampilkan link kepada pengguna
Pasang tombol atau link di botmu. Pengguna membayar dari saldo dompet dengan satu tap.
Tangani webhook
Servermu menerima invoice_paid bertanda tangan HMAC-SHA256. Verifikasi tanda tangan, cegah pemrosesan ganda lewat update_id, lalu kirim barang.
Serahkan integrasi ke agen AI
Merchant API menyediakan server MCP. Hubungkan di klien agen yang kompatibel: agen dapat membaca dokumentasi, meminta pembuatan aplikasi, mengatur webhook, dan membantu menulis integrasi. Kamu menyetujui aplikasi di Telegram, lalu memeriksa dan menguji hasilnya.
- Langkah 1
Kirim prompt ke agenmu
Gunakan klien agen yang menyediakan dukungan MCP jarak jauh untuk akun atau ruang kerjamu. Prompt juga tersedia di aplikasi: Lainnya → Merchant API → Hubungkan agen AI.
- Langkah 2
Setujui aplikasi di Telegram
Agen memberikan link t.me. Bot menampilkan permintaannya, lalu kamu menyetujui lewat satu tombol. Link hanya berlaku sekali. Aplikasi belum dibuat sebelum kamu setuju.
- Langkah 3
Selesaikan dan uji integrasi
Agen mendapat token terbatas dan membantu mengatur faktur, paket langganan, serta webhook. Untuk mendapatkan kunci tanda tangan webhook, buat ulang token utama di aplikasi dan simpan dengan aman di servermu.
Token agen dapat menerima pembayaran dan mengatur webhook. Token ini tidak dapat mentransfer, membuat cek, atau mengembalikan dana; tindakan tersebut memerlukan token dengan izin yang sesuai.
Pelajari cara menghubungkan agen di dokumentasiConnect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.
claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
Tambahkan app.tgpaycrypto.com/mcp sebagai server MCP jarak jauh di pengaturan klien. Ketersediaan fitur dan nama menu bergantung pada klien dan akunmu.
https://testnet.tgpaycrypto.com/mcp
Biaya dan batas
Nilai diambil dari katalog batas publik aplikasi saat halaman ini dibuat. Nilai terbaru selalu ada di aplikasi.
Fitur Merchant API
Aplikasi punya saldo sendiri yang terpisah dari dompetmu. Pembayaran faktur masuk ke saldo ini, sedangkan pembayaran keluar dan cek memakai dana dari saldo ini.
Faktur dan pengembalian dana
Jumlah tetap dalam kripto, harga dalam fiat, atau jumlah yang diisi pembayar. Dana bisa dikembalikan seluruhnya atau sebagian, termasuk untuk pembayar anonim.
Langganan
Pengguna menyetujui paket sekali, lalu saldo dipotong otomatis tiap periode. Setiap pemotongan disertai peristiwa.
Transfer dan cek kripto
Kirim pembayaran dari saldo aplikasi ke pengguna Telegram atau buat cek berupa link yang bisa diklaim penerima.
Webhook
invoice_paid selalu dikirim. Peristiwa kedaluwarsa faktur, klaim cek, pengembalian dana, dan langganan bisa diaktifkan per aplikasi.
Testnet
API dan Mini App yang sama tersedia di @tgpaycrypto_testnet_bot. Ambil koin uji coba lewat tombol di layar utama, sekali setiap jam.
Agen AI dan MCP
Hubungkan app.tgpaycrypto.com/mcp di klien agen yang mendukung server MCP jarak jauh. Setelah kamu menyetujuinya di Telegram, agen dapat membuat aplikasi dan membantu integrasi. Periksa dan uji hasilnya sebelum digunakan.
Kompatibel dengan Crypto Bot API
Nama metode yang familier, format {ok, result}, dan tanda tangan webhook HMAC. Perbarui URL API dan token, lalu uji metode yang dipakai integrasimu.
Kendalikan akses token
Token dengan izin terbatas, rotasi instan, mode pembayaran “Hanya pengguna dalam daftar” atau “Nonaktif”, serta batas pembayaran harian untuk mengurangi risiko kebocoran token.
Pertanyaan tentang API
Tentang token, tanda tangan webhook, pengujian, dan pindah dari API lain.
Pembuatan aplikasi bisa memerlukan verifikasi identitas lengkap, sesuai kebijakan yang berlaku. Jika muncul kesalahan verifikasi, selesaikan verifikasi di aplikasi lalu coba lagi.
Header TgPayCrypto-API-Signature berisi HMAC-SHA256 dari body permintaan, dengan SHA-256 token utama sebagai kuncinya. Verifikasi berdasarkan byte asli body. Jangan kirim barang atau tandai faktur dibayar sebelum verifikasi berhasil.
Merchant API memakai nama metode yang familier, format {ok, result}, jumlah berupa string desimal, dan tanda tangan HMAC. Perbarui URL API dan token. Header Crypto-Pay-API-Token diterima sebagai alias. Sebelum beralih, periksa dokumentasi dan uji metode serta aset yang dipakai integrasimu.
Testnet menyediakan API dan Mini App yang sama. Botnya @tgpaycrypto_testnet_bot, alamat API-nya testnet.tgpaycrypto.com/pay/api. Tombol “Dapatkan koin uji coba” di layar utama memberikan 1.000 USDT, 1.000 GRAM, dan 0,01 BTC sekali setiap jam. Token mainnet dan testnet tidak bisa saling dipakai.
Agen mendapat token terbatas untuk faktur, paket langganan, saldo, statistik, dan pengaturan webhook. Token ini tidak dapat mentransfer, membuat cek, atau mengembalikan dana. Tindakan tersebut memerlukan token dengan izin yang sesuai.
Dokumentasi publik Merchant API
Referensi metode, deskripsi OpenAPI, dan panduan langkah demi langkah di docs.tgpaycrypto.com.
Siapkan pembayaran dalam satu malam
Buat aplikasi di @tgpaycryptobot, atau berikan link server MCP ke agen AI dan setujui pembuatan aplikasi lewat satu tombol.
Buka bot