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 setelah mengonfirmasi pembayaran.

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 webhook bertanda tangan setelah pembayaran jika URL webhook sudah diatur.
• 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 — danai link klaim dari saldo aplikasimu untuk siapa pun atau penerima yang ditentukan, sesuai pengaturan pembayaranmu.
• 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

1. Aplikasi milikmu punya saldo sendiri, terpisah dari dompet pribadimu.
2. Faktur yang dibayar pengguna masuk ke saldo aplikasi itu.
3. Transfer dan cek kripto mengambil dana dari saldo itu.
4. Event pembayaran yang didukung bisa dikirim ke servermu sebagai webhook bertanda tangan setelah URL dan jenis event diatur.

Pembayaran diselesaikan di dalam aplikasi, bukan di blockchain: tanpa biaya jaringan, tanpa menunggu konfirmasi, dan dananya langsung bisa dipakai begitu masuk. Pembayar bisa mendanai faktur dari dompet luar jika pilihan itu tersedia. Deposit masuk ke dompetnya sendiri; pembayaran otomatis juga membutuhkan saldo yang cukup, tidak adanya pembatasan keluar, dan tenggat pembayaran yang masih berlaku. Pastikan status faktur paid sebelum memenuhi pesanan.

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. Untuk menyesuaikan integrasi yang sudah ada, ganti base URL dan token, lalu uji metode yang kamu gunakan dengan mengacu pada referensi kami. Seperti Crypto Bot, kami juga punya testnet dengan bot dan base URL terpisah.

Header token yang resmi adalah TgPayCrypto-API-Token; TgCryptoPay-API-Token, nama lama sebelum 2026-09-07, masih jalan, dan Crypto-Pay-API-Token diterima sebagai alias, jadi library klien yang sudah ada tetap jalan tanpa perlu diubah.

⚠️ Token API-mu adalah kunci untuk mengeluarkan dana

Token utama mengizinkan pembayaran dalam batas dan mode pembayaran aplikasi. 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

• Mulai sebagai developer
• Menerima pembayaran lewat faktur
• Referensi Merchant API