Hubungkan agen AI · TgPay Crypto API

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.

URL itu adalah server MCP (Model Context Protocol — cara standar menyambungkan layanan ke agen AI). Buka di browser, dan halamannya berisi petunjuk penyiapan.

Cara menyambungkannya

Pakai baris yang cocok dengan alat yang kamu pakai:

Agen yang mendukung MCP jarak jauh — tempel prompt ini:
```
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.
```
Versi siap salinnya ada di aplikasi, di Lainnya → Merchant API → Hubungkan agen AI.
Claude Code — claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai dan Claude Desktop — tambahkan URL sebagai konektor khusus dengan mengikuti petunjuk penyiapan Claude.
ChatGPT dan klien MCP lain — tambahkan URL sebagai server MCP khusus jika akun dan ruang kerjamu mengizinkannya. Untuk ChatGPT, ikuti petunjuk penyiapan terkini.

Untuk mulai di testnet, gunakan https://testnet.tgpaycrypto.com/mcp. Link persetujuan membuka @tgpaycrypto_testnet_bot, dan dokumentasi API memakai base URL testnet.

Kamu tidak perlu punya token API lebih dulu — agennya dapat token sendiri di langkah berikutnya. Kalau aplikasinya sudah kamu buat manual, buat token terbatas dengan hak akses yang dibutuhkan agen saja, lalu pakai untuk integrasi. Simpan token utama di servermu. Hak akses token yang kamu berikan secara manual menentukan apa saja yang bisa dilakukan agen.

Setujui aplikasinya

Minta agenmu menyiapkan pembayaran. Dia membaca dokumentasinya, lalu meminta persetujuan.
Agenmu memberi link t.me. Buka linknya — bot menampilkan apa yang sedang diminta — lalu tap ✅ Buat aplikasi dan terbitkan token.
Kembali ke agen agar ia mengambil token dan melanjutkan integrasi. Akun harus memenuhi syarat untuk membuat aplikasi; selesaikan verifikasi jika diminta.

Linknya selalu datang dari agenmu — bot tidak pernah mengirimnya tiba-tiba: sebelum kamu membukanya, bot bahkan tidak tahu akun siapa yang sedang ditanyakan agen itu. Tiap link berlaku sekali. Kalau linknya mati sebelum sempat kamu tap, minta agennya mulai lagi dari awal — tidak ada apa pun yang dibuat sampai kamu menyetujuinya.

Kalau kamu tap ❌ Tolak, tidak ada juga yang dibuat, dan permintaan itu selesai — kalau berubah pikiran, agennya harus mengirim permintaan baru.

⚠️ Setujui hanya permintaan yang kamu mulai sendiri

Permintaan koneksi adalah permintaan membuat aplikasi di akun kamu. Setujui hanya kalau barusan kamu sendiri yang minta agenmu menyiapkan pembayaran. Kalau linknya datang lewat jalan lain — dari obrolan, pesan yang diteruskan, atau “dukungan” dari orang tak dikenal — tolak saja.

Token dari alur persetujuan ini tidak bisa mengirim transfer, membuat cek, atau mengembalikan pembayaran (lihat di bawah). Token yang diberikan secara manual bisa punya hak akses berbeda. Aplikasi yang tidak pernah kamu minta memang tidak seharusnya ada di akunmu.

Yang bisa dan tidak bisa dilakukan agen

Token yang diterima agen melalui alur persetujuan di atas adalah token terbatas:

Yang bisa dia lakukan — membuat faktur dan paket langganan, membaca saldo, kurs, dan statistikmu, serta mengatur webhook URL.
Yang tidak bisa — mengirim transfer, menerbitkan cek, atau mengembalikan dana pembayaran. Tindakan itu memerlukan scope payouts, checks, atau refunds sesuai jenisnya, atau token utama dengan akses penuh. Token yang diterbitkan lewat alur ini tidak memiliki ketiga scope tersebut.

Jaga kerahasiaan token ini: hak aksesnya tetap memungkinkan perubahan pada faktur, paket langganan, dan webhook URL. Bot mengirimimu pesan setiap kali ada token yang diberikan ke agen dan setiap kali webhook URL salah satu aplikasimu berubah.

Untuk memeriksa hak akses token agen atau mencabutnya, buka Lainnya → Merchant API, cari aplikasinya, buka Akses dan token, lalu lihat bagian Token terbatas — Cabut mematikannya seketika. Aplikasi, saldo, dan riwayat pembayarannya tetap ada. Nilai token tidak bisa dilihat lagi. Token dengan tanggal kedaluwarsa juga berhenti berfungsi saat kedaluwarsa.

Tanda tangan webhook butuh token utamamu

Agen bisa mengarahkan webhook URL ke servermu, tapi dia tidak bisa memeriksa apa yang sampai di sana: pengiriman ditandatangani dengan token utama aplikasimu, yang tidak pernah dilihat agen. Minta agen menulis kode verifikasi dan meninggalkan placeholder — semacam TGPAY_WEBHOOK_TOKEN — untuk kamu isi.

Cara mengisinya: buka Lainnya → Merchant API, cari aplikasi yang dibuat agen tadi, buka Akses dan token, tap Ganti token, lalu salin yang muncul — cuma ditampilkan sekali. Simpan di environment servermu, jangan di konfigurasi agen atau di repositorimu. Penggantian ini tidak menyentuh token terbatas milik agen, jadi integrasinya tetap jalan.

Tanda tangan langsung beralih ke token baru begitu kamu menggantinya, jadi ganti tokennya sebelum live, bukan setelah pembayaran sungguhan yang pertama.

Selanjutnya

Mulai sebagai developer — jalur manual, dan cara mengelola aplikasi setelah aplikasinya ada.
Referensi API: webhook — bentuk payload, pengulangan pengiriman, dan cara memeriksa tanda tangannya.
Referensi Merchant API — semua metode, termasuk yang tidak bisa dipanggil agen.