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 — agen mendapat 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. Apa pun tokennya, lewat server MCP agen hanya bisa menerima pembayaran (lihat di bawah).

Untuk memberikan token ini ke server MCP, tambahkan server di pengaturan koneksi klien dengan header TgPayCrypto-API-Token: <token> atau Authorization: Bearer <token>. Dengan cara ini, tahap persetujuan tidak diperlukan. Tidak semua klien punya kolom untuk header kustom (konektor claude.ai dan ChatGPT tidak punya, dan server tidak menyediakan login OAuth); di klien seperti itu, pakai persetujuan yang dijelaskan di bawah. Agen juga bisa memberikan token lewat argumen api_token pada satu pemanggilan alat, kalau kliennya mengizinkan argumen yang tidak dideklarasikan oleh alat itu.

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.

Aplikasi dan token agen dibuat saat agen memeriksa permintaan itu lagi setelah kamu tap — biasanya dalam beberapa detik. Permintaan berlaku 10 menit sejak agen membuatnya: kalau agen tidak memeriksanya tepat waktu, tidak ada yang dibuat, meskipun bot sudah mengonfirmasi tap-mu, dan agen harus mulai lagi. Akun harus memenuhi syarat untuk membuat aplikasi; kalau perlu verifikasi, agen menerima error saat pemeriksaan itu — selesaikan verifikasi lalu minta agen memeriksa lagi dalam 10 menit yang sama, atau mulai dari awal.

Dengan menyetujui permintaan, kamu menerima ketentuan Merchant API untuk aplikasi yang dibuatnya, sama seperti saat membuat aplikasi sendiri di Mini App.

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. Selama kamu belum tap tombol apa pun, membuka link lagi menampilkan permintaan yang sama; setelah kamu tap ✅ Buat aplikasi dan terbitkan token atau ❌ Tolak, atau setelah 10 menit, link tidak berfungsi lagi. 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.

Tidak ada token yang bisa mengirim transfer, membuat cek, atau mengembalikan dana pembayaran lewat server MCP, termasuk token dari alur persetujuan ini (lihat di bawah). Aplikasi yang tidak pernah kamu minta 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 dan menghapus faktur, membuat dan mengarsipkan paket langganan, membatalkan langganan pelanggan, membaca saldo, kurs, dan statistikmu, serta mengubah webhook URL dan nama aplikasi.
Yang tidak bisa — mengirim transfer, menerbitkan cek, atau mengembalikan dana pembayaran: token ini tidak memiliki scope payouts, checks, atau refunds.

Server MCP juga membatasi akses: alat untuk mengirim dana dari saldo aplikasi — transfer, transferBatch, createCheck, dan refundInvoice — saat ini dinonaktifkan. Agen tidak bisa melihatnya, dan setiap pemanggilan ditolak, bahkan dengan token utama yang memiliki akses penuh. Jadi, token agen yang bocor maupun instruksi berbahaya yang disisipkan dalam teks yang dibaca agen, misalnya komentar pembayar, tidak bisa dipakai untuk mengirim dana dari aplikasimu lewat MCP.

Transfer, cek, dan pengembalian dana tetap bisa diakses langsung lewat API: panggil /pay/api dari kode di servermu dengan token yang memiliki scope payouts, checks, atau refunds sesuai tindakannya. Untuk mengirim pembayaran lewat aplikasi, buka Lainnya → Merchant API, pilih aplikasimu, lalu buka Pembayaran.

Jaga kerahasiaan token ini: hak aksesnya tetap memungkinkan perubahan pada faktur, paket langganan, langganan, webhook URL, dan nama aplikasi. 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. Konfirmasi penggantian dengan PIN atau Face ID. Aplikasi yang dibuat lewat agen bisa dimiliki akun tanpa PIN, tetapi penggantian token memerlukan PIN aktif. Buat PIN dulu di Keamanan dan tunggu sampai aktif.

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.