Hubungkan agen AI · TG Crypto Pay API

Beri agen coding AI-mu satu URL — https://crypto.tgpaybot.com/mcp — dan dia yang membangun integrasi pembayarannya: membaca dokumentasi API, membuat aplikasi merchant-mu, menyiapkan webhook, lalu menulis kodenya. Kamu tinggal menyetujui aplikasi barunya sekali, lewat satu tombol di bot. Tidak perlu terminal, dan tidak ada token API yang harus disalin manual.

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

Cara menyambungkannya

Pakai baris yang cocok dengan alat yang kamu pakai:

Chat agen mana pun — tempel prompt ini:
```
Connect the tgpay MCP server (https://crypto.tgpaybot.com/mcp) and integrate payments via the TgPay Merchant API.
```
Versi siap salinnya ada di aplikasi, di Lainnya → Merchant API → Hubungkan agen AI.
Claude Code — claude mcp add --transport http tgpay https://crypto.tgpaybot.com/mcp
claude.ai dan Claude Desktop — Settings → Connectors → Add custom connector → tempel URL-nya.
ChatGPT dan klien MCP lain — tambahkan custom connector dengan URL yang sama.

Kamu tidak perlu punya token API lebih dulu — agennya dapat token sendiri di langkah berikutnya. Kalau aplikasinya sudah kamu buat manual, kasih tokennya ke agen dan langsung lompat ke bagian integrasi.

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 agennya. Dalam beberapa detik dia menerima tokennya dan menyelesaikan sendiri integrasinya.

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.

Kerugiannya memang dibatasi sejak awal: token agen bisa menerima dana, tidak bisa mengeluarkannya (lihat di bawah). Tapi aplikasi yang tidak pernah kamu minta memang tidak seharusnya ada di akunmu.

Yang bisa dan tidak bisa dilakukan agen

Token yang diterima agen 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. Apa pun yang mengeluarkan dana dari saldo aplikasimu butuh token akses penuh, dan token itu tetap tinggal di aplikasi.

Pembagian ini disengaja: token agen tersimpan di file konfigurasi dan di konteks model, yang lebih mudah ditembus daripada servermu. Kalau bocor, paling jauh kamu kena webhook URL yang salah, bukan kehilangan saldo. Bot mengirimimu pesan setiap kali ada token yang diberikan ke agen, dan setiap kali webhook URL salah satu aplikasimu berubah.

Untuk melihat token agen atau mencabutnya, buka Lainnya → Merchant API, cari aplikasinya, lalu lihat bagian Token terbatas — Cabut mematikannya seketika. Aplikasinya sendiri, saldonya, dan riwayat pembayarannya tetap ada.

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. Agen yang benar akan menulis kode verifikasinya dan meninggalkan placeholder — semacam TGPAY_WEBHOOK_TOKEN — untuk kamu isi.

Cara mengisinya: buka Lainnya → Merchant API, cari aplikasi yang dibuat agen tadi, 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.