Merchant API

Pembayaran kripto di bot Telegram: faktur, webhook, pembayaran keluar

Merchant API adalah API pembayaran TgPay Crypto untuk bot dan layanan. Buat aplikasi di bot, dapatkan token, buat faktur dari kode, lalu terima webhook bertanda tangan saat dibayar. Bisa juga serahkan URL server MCP ke agen AI untuk menyiapkan integrasi. Pembayaran diproses di dompet, tanpa biaya jaringan atau menunggu konfirmasi blockchain.

Dapatkan token Dokumentasi API Lewat agen AI
Alamat API — app.tgpaycrypto.com/pay/api · testnet — testnet.tgpaycrypto.com
Layar Merchant API: aplikasi, token, dan peristiwa webhook
Webhook terkirim
Testnet
Cara kerja

Dari token ke pembayaran pertama dalam empat langkah

Buat faktur, tampilkan link, lalu tunggu peristiwa pembayaran, seperti API pembayaran pada umumnya.

Langkah 1

Buat aplikasi

Di bot, buka Lainnya → Merchant API, lalu masukkan nama dan URL webhook. Token hanya ditampilkan sekali. Simpan di servermu.

Langkah 2

Buat faktur

Satu permintaan POST createInvoice: jumlah dalam kripto atau fiat, deskripsi, dan tenggat. Respons berisi link pembayaran.

Langkah 3

Tampilkan link kepada pengguna

Pasang tombol atau link di botmu. Pengguna membayar dari saldo dompet dengan satu tap.

Langkah 4

Tangani webhook

Servermu menerima invoice_paid bertanda tangan HMAC-SHA256. Verifikasi tanda tangan, cegah pemrosesan ganda lewat update_id, lalu kirim barang.

Agen AI

Serahkan integrasi ke agen AI

Merchant API menyediakan server MCP. Berikan satu URL ke agen untuk membaca dokumentasi, membuat aplikasi, mengatur webhook, dan menulis kode. Tidak perlu terminal atau menyalin token sendiri.

  1. Langkah 1

    Kirim prompt ke agenmu

    Gunakan chat agen seperti Claude Code, claude.ai, Claude Desktop, ChatGPT, atau klien MCP lain. Prompt yang sama ada di aplikasi: Lainnya → Merchant API → Hubungkan agen AI.

  2. 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.

  3. Langkah 3

    Agen menyelesaikan pengaturan

    Agen mendapat token terbatas untuk menyiapkan integrasi faktur, paket langganan, dan webhook. Kunci tanda tangan webhook tetap kamu pegang di aplikasi.

Token agen bisa menerima pembayaran dan mengatur webhook, tetapi tidak bisa mentransfer, membuat cek, atau mengembalikan dana. Pengeluaran dana tetap kamu kendalikan lewat token penuh di aplikasi.

Pelajari cara menghubungkan agen di dokumentasi
Prompt untuk agen apa pun
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
Claude Code
claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai, Claude Desktop, ChatGPT

Settings → Connectors → Add custom connector → masukkan app.tgpaycrypto.com/mcp

Testnet
https://testnet.tgpaycrypto.com/mcp
Ketentuan

Biaya dan batas

Nilai diambil dari katalog batas publik aplikasi saat halaman ini dibuat. Nilai terbaru selalu ada di aplikasi.

Biaya fakturDibayar merchant: dana masuk ke saldo aplikasi setelah dikurangi biaya. Persentase biaya ditetapkan saat pembayaran dan tidak berubah untuk faktur yang sudah dibayar.
3%
Diskon volume transaksiBiaya turun otomatis sesuai volume transaksi 30 hari terakhir: mulai $10.000 — 2,9%, $25.000 — 2,8%, $50.000 — 2,7%, $75.000 — 2,6%, dan $100.000 — 2,5%.
hingga 2,5%
Biaya jaringanFaktur, transfer, dan cek diproses di dalam dompet. Tidak perlu menunggu konfirmasi blockchain, dana langsung bisa dipakai.
0
Pembayaran ke penggunaMetode transfer mengirim kripto dari saldo aplikasi ke pengguna Telegram lewat ID. transferBatch membayar hingga 100 penerima dalam satu panggilan. Mengulang permintaan dengan spend_id yang sama tidak memotong saldo dua kali.
hingga $25.000
Batas permintaancreateInvoice dan createCheck: 60 per menit. transfer dan refundInvoice: 30. transferBatch: 10. Metode baca tidak dibatasi.
60 per menit
Pengiriman webhookRespons 2xx dalam 10 detik dianggap berhasil. Jika tidak, pengiriman dicoba ulang dengan jeda yang makin panjang selama sekitar tiga hari. update_id tetap sama pada setiap percobaan.
hingga 17 percobaan
Fitur

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

Berikan alamat app.tgpaycrypto.com/mcp ke agenmu. Agen membuat aplikasi, mengatur webhook, dan menulis integrasi. Kamu menyetujui pembuatan aplikasi lewat satu tombol di bot.

Kompatibel dengan Crypto Bot API

Nama metode, format {ok, result}, dan skema tanda tangan webhook sama. Ganti alamat dasar API dan token untuk memakai kode yang sama.

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.

Tanya jawab

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.

Bisa. Merchant API mengikuti metode, format {ok, result}, jumlah berupa string desimal, dan skema tanda tangan Crypto Bot API. Ganti alamat dasar API dan token. Header Crypto-Pay-API-Token tetap diterima sebagai alias.

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 membuat faktur dan paket langganan, membaca saldo serta statistik, dan mengatur URL webhook. Transfer, cek, dan pengembalian dana memerlukan token penuh yang tetap kamu pegang.

Semua metode di dokumentasiPertanyaan? Hubungi @tgpayhelpbot
Dokumentasi

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