Merchant API (Developer)
API merchant: aplikasi, faktur, transfer, dan webhook.
Apa itu Merchant API?
Merchant API adalah API pembayaran aplikasi ini untuk bisnis dan bot. Buat aplikasi, ambil token API, lalu pakai token itu untuk meminta pembayaran dari pengguna Telegram, mengirim dana ke mereka, dan memeriksa saldo — semuanya dari kodemu sendiri.
Mulai sebagai developer
Buat aplikasi di Mini App, salin token API-nya sekali, lalu mulai memanggil API. Semua pengaturannya ada di Lainnya → Merchant API.
Hubungkan agen AI
Hubungkan agen coding AI yang mendukung server MCP jarak jauh ke https://app.tgpaycrypto.com/mcp. Agen bisa membaca dokumentasi API, mengajukan pembuatan aplikasi merchant, mengatur webhook, dan membantu menulis integrasi. Kamu menyetujui pembuatan aplikasi di bot; agen menerima token terbatas tanpa perlu kamu salin manual. Tinjau dan uji integrasi sebelum menerima pembayaran sungguhan.
Menerima pembayaran lewat faktur
Faktur adalah cara kamu meminta pembayaran dari pengguna Telegram. Buat satu lewat API, kirim linknya ke pembayar, dan pembayaran yang berhasil menambah saldo aplikasimu setelah dipotong biaya merchant.
Biaya dan batas Merchant API
Faktur dikenai biaya platform yang dipotong dari yang kamu terima; transfer dan cek kripto punya batas jumlah. Angka di bawah ini adalah pengaturan yang berlaku sekarang, bukan syarat kontrak — kalau berbeda dengan yang kamu lihat, ikuti yang ada di aplikasi, dan sumber paling tepercaya selalu faktur yang sudah dibayar di akunmu sendiri.
Referensi Merchant API
Konvensi yang dipakai semua metode, plus metode katalog yang hanya membaca. Halaman per metode: faktur dan pengembalian dana, transfer dan cek kripto, langganan, webhook.
Referensi API: faktur dan pengembalian dana
Metode faktur: createInvoice, getInvoices, deleteInvoice, refundInvoice. Konvensi umum (autentikasi, envelope, jumlah, spend_id) ada di halaman Referensi Merchant API; panduan langkah demi langkahnya ada di Menerima pembayaran lewat faktur.
Referensi API: transfer dan cek kripto
Metode untuk mengirim dana keluar. Transfer mengirim dana dari saldo aplikasimu ke dompet pengguna Telegram atau menahannya sampai penerima baru membuka bot; cek kripto adalah link klaim yang dananya kamu sediakan di muka. Konvensi umum (autentikasi, envelope, jumlah, spend_id) ada di halaman Referensi Merchant API.
Referensi API: langganan
Penagihan berulang — ekstensi di luar Crypto Bot. Kamu membuat paket (jumlah + periode), mengirim link persetujuannya ke pengguna, lalu platform menagih mereka dari saldo dompetnya tiap periode dan menambahkan hasilnya ke saldo aplikasimu setelah dipotong biaya. Konvensi umumnya ada di halaman Referensi Merchant API.
Referensi API: webhook
Webhook mengirim event ke servermu setelah event terjadi. Isi Webhook URL (opsional) aplikasimu di Lainnya → Merchant API; setelah itu platform mem-POST body JSON bertanda tangan untuk tiap event yang kamu ikuti.
Ketentuan Merchant API
Ketentuan ini mengatur Merchant API — aplikasi, token API, faktur, langganan, transfer, cek kripto, webhook, dan konektor agen AI. Ketentuan ini berlaku sebagai tambahan atas ketentuan penggunaan umum aplikasi dan kebijakan AML-nya. Dengan membuat aplikasi, kamu menerima ketentuan ini; dengan terus memakai aplikasi yang dibuat sebelum 7 September 2026, kamu juga menerimanya.