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.
Ini sisi developer dari produk yang dipakai pengguna: faktur yang kamu buat lewat API adalah faktur yang mereka bayar dari saldo cukup dengan sekali tap.
Yang bisa kamu lakukan
- Faktur — buat permintaan pembayaran (jumlah kripto yang tetap, harga dalam mata uang fiat, atau jumlah bebas yang ditentukan pembayar), kirim linknya ke pembayar, lalu terima callback bertanda tangan begitu dibayar.
- Pengembalian dana — kembalikan jumlah faktur yang sudah dibayar, seluruhnya atau sebagian, ke siapa pun yang membayarnya — termasuk pembayar anonim.
- Transfer — kirim kripto dari saldo aplikasimu ke pengguna Telegram, satu per satu atau sampai 100 sekaligus.
- Cek kripto — terbitkan link yang bisa diklaim siapa saja, langsung dari saldo aplikasimu.
- Langganan — pembayaran berulang: pengguna menyetujui satu paket sekali, lalu saldonya dipotong otomatis tiap periode.
- Saldo, mata uang, kurs, dan statistik — endpoint read-only untuk pembukuanmu sendiri.
Cara semuanya terhubung
- Aplikasi milikmu punya saldo sendiri, terpisah dari dompet pribadimu.
- Faktur yang dibayar pengguna masuk ke saldo aplikasi itu.
- Transfer dan cek kripto mengambil dana dari saldo itu.
- Tiap event penting bisa dikirim ke servermu sebagai webhook bertanda tangan.
Pembayaran diselesaikan di dalam aplikasi, bukan di blockchain: tanpa biaya jaringan, tanpa menunggu konfirmasi, dan dananya langsung bisa dipakai begitu masuk. Pembayar tetap bisa membayar faktur pakai dana dari dompet luar — depositnya masuk ke dompetnya sendiri, lalu fakturnya otomatis dibayar dari situ; di sisimu tampilannya persis sama seperti faktur lain yang sudah dibayar.
Kompatibel dengan Crypto Bot
API ini sengaja dibuat mengikuti Crypto Bot: nama metode sama, envelope
{ok, result} sama, jumlah dalam bentuk string desimal sama, skema tanda
tangan webhook sama. Integrasi Crypto Bot yang sudah jalan bisa diarahkan ke
kami cukup dengan mengganti base URL dan tokennya — bentuk request dan
response-nya tidak berubah.
Header token yang resmi adalah TgPayCrypto-API-Token, dan
Crypto-Pay-API-Token juga diterima sebagai alias, jadi library klien yang
sudah ada tetap jalan tanpa perlu diubah.
⚠️ Token API-mu adalah kunci untuk mengeluarkan dana
Siapa pun yang memegangnya bisa memindahkan saldo aplikasimu keluar. Simpan di sisi server, jangan sampai ikut ke aplikasi klien atau ke repositori, dan ganti begitu kamu curiga token itu bocor. Untuk server yang tidak butuh akses penuh, buat token terbatas dengan hak akses seperlunya saja — lihat referensi API.
Selanjutnya
Artikel ini membantu?
Terima kasih atas masukannya.