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
Beri agen coding AI-mu satu URL — https://app.tgpaycrypto.com/mcp — dan dia yang membangun integrasi pembayarannya: membaca dokumentasi API, membuat aplikasi merchant-mu, menyiapkan webhook, lalu menulis kodenya. Kamu tinggal menyetujui aplikasi barunya sekali, lewat satu tombol di bot. Tidak perlu terminal, dan tidak ada token API yang harus disalin manual.
Menerima pembayaran lewat faktur
Faktur adalah cara kamu meminta pembayaran dari pengguna Telegram. Buat satu lewat API, kirim linknya ke pembayar, dan saldo aplikasimu bertambah begitu dia mengonfirmasi.
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 langsung ke dompet pengguna Telegram; cek kripto adalah link yang bisa diklaim dan kamu danai 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 begitu event itu terjadi. Isi Webhook URL aplikasimu di Lainnya → Merchant API; setelah itu platform mem-POST body JSON bertanda tangan untuk tiap event yang kamu ikuti.