Produk · AI agent

Payment gateway untuk AI agent: MCP server Kasera Pay yang membuat dan membaca pembayaran QRIS dan Virtual Account, mulai dari Sandbox

MCP (Model Context Protocol) adalah standar terbuka yang membuat AI agent seperti Claude bisa memanggil tool di luar dirinya. kasera-pay-mcp adalah MCP server resmi Kasera Pay. Setelah dipasang di samping agent, agent bisa membuat permintaan pembayaran, mengecek statusnya, membaca tarif akun, dan menjalankan pembayaran test, semuanya lewat API publik /v1 yang sama dengan integrasi biasa.

Satu batas perlu jelas sejak awal: agent menyiapkan tagihan, pembeli yang membayar. Agent tidak memegang uang dan tidak bisa menyetujui pembayaran atas nama siapa pun. Yang dikembalikan agent adalah checkout_url, dan pembeli menyelesaikannya lewat QRIS atau Virtual Account di halaman checkout.

Untuk siapa

Developer yang membangun dengan Claude Code atau Cursor. Membuat tagihan test, mengecek status, dan membaca kontrak API tanpa meninggalkan editor. Server juga menyediakan dokumen OpenAPI live sebagai resource kasera-pay://openapi, jadi agent bisa membaca seluruh kontraknya sendiri.
Tim yang membangun agent atau otomasi. Agent yang menerima pesanan lewat percakapan bisa menerbitkan tagihan dan mengirim tautannya, lalu memeriksa apakah sudah dibayar.
Penjual yang sudah memakai Claude Desktop. Meminta tagihan dalam bahasa biasa, misalnya “buatkan tagihan Rp 150.000 untuk workshop Sabtu”, dan menerima tautannya untuk dikirim ke pembeli.

Lima tool, masing-masing satu endpoint /v1

Tool	Fungsinya
`create_payment_request`	Membuat permintaan pembayaran dan mengembalikan checkout_url-nya.
`get_payment`	Mengambil satu permintaan pembayaran berdasarkan id payreq_*.
`list_payments`	Satu halaman permintaan pembayaran, terbaru lebih dulu.
`get_pricing`	Metode yang aktif di akun, biaya per metode, dan batas nominalnya.
`simulate_payment`	Mengubah pembayaran test yang pending menjadi succeeded atau expired. Selalu ditolak untuk key live.

Tidak ada tool pencairan, karena pencairan bukan bagian dari API publik /v1. Setiap tool memakai metode yang aktif di akun, yaitu QRIS dan Virtual Account; daftar lengkapnya dibaca dari metode pembayaran yang aktif.

Model keamanan: Sandbox lebih dulu

Mulai dengan test key. Key kp_test_ bisa memakai semua tool, dan tidak ada yang dibuatnya yang memindahkan uang sungguhan. Ini mode test yang sama dengan integrasi biasa.
Key live hanya bisa membaca, kecuali diizinkan. Dengan key kp_live_, create_payment_request ditolak sampai KASERA_ALLOW_LIVE=true diatur di environment server. Langkah itu dilakukan pemilik server dan tidak bisa dilewati agent. simulate_payment selalu ditolak untuk key live.
API key tidak pernah lewat percakapan. Key disimpan di environment server sebagai KASERA_API_KEY, bukan dikirim sebagai argumen tool.
Setiap create membawa Idempotency-Key. Pengulangan jaringan dari satu panggilan tidak menagih dua kali. Dua panggilan terpisah tetap menjadi dua pembayaran.

Mencoba di Sandbox dalam tiga langkah

Di Claude Code, pasang server dengan key test:

claude mcp add kasera-pay -e KASERA_API_KEY=kp_test_... -- npx kasera-pay-mcp

Buat. Minta agent membuat pembayaran test Rp 150.000. Agent memanggil create_payment_request dan mengembalikan id payreq_*, checkout_url, serta biaya dan nominal bersih menurut tarif akun.
Tandai lunas. Pembayaran test tidak pernah terkonfirmasi sendiri. simulate_payment mengubahnya menjadi succeeded dan memicu webhook payment.paid bertanda tangan ke endpoint test, sama seperti pembayaran sungguhan.
Cek. get_payment mengembalikan status: succeeded, livemode: false, dan paid_at yang sudah terisi.

Claude Desktop dan Cursor memakai file konfigurasi JSON yang sama. Isinya, daftar variabel environment, dan detail setiap tool ada di dokumentasi MCP server (juga tersedia dalam bahasa Inggris). Key test dan key live dibuat di menu Developer, seperti dijelaskan di dokumentasi autentikasi.

MCP server atau integrasi API biasa

MCP server cocok untuk pekerjaan yang dimulai dari percakapan: mencoba API, membuat tagihan satu per satu, atau agent yang melayani pesanan. Untuk checkout toko online yang berjalan sendiri tanpa agent, integrasi langsung ke API tetap jalur utamanya, dengan webhook sebagai penanda lunas. Contohnya per framework ada di halaman API QRIS untuk developer, dan jalur tanpa coding sama sekali ada di payment link.

Biaya

MCP server tidak dikenai biaya tersendiri. Pembayaran yang dibuat lewat agent dikenai tarif yang sama dengan pembayaran lain: tarif default QRIS 0,7% + Rp 250, Virtual Account Rp 5.000 per transaksi berhasil, Rp 3.000 per pencairan, tanpa biaya bulanan. Untuk pembayaran di atas Rp 1.000.000, QRIS dan Virtual Account sama-sama 1% dari seluruh nominal. Tarif yang berlaku untuk sebuah akun tampil di dashboard dan di halaman biaya.

Daftar gratis dan ambil key test

Pertanyaan yang sering muncul

Apakah AI agent bisa membayar atau menarik uang sendiri?

Tidak. Agent membuat permintaan pembayaran dan membaca statusnya. Pembayarannya tetap dilakukan pembeli lewat QRIS atau Virtual Account di halaman checkout. Tidak ada tool pencairan, karena pencairan bukan bagian dari API publik /v1.

Bagaimana kalau key live dipasang di MCP server?

Dengan key kp_live_, tool yang tersedia hanya untuk membaca data. create_payment_request ditolak sampai KASERA_ALLOW_LIVE=true diatur di environment server, langkah yang harus dilakukan pemilik server dan tidak bisa dilewati agent. simulate_payment selalu ditolak untuk key live.

Klien AI apa saja yang didukung?

Dokumentasi MCP server Kasera Pay menjelaskan pemasangan di Claude Code lewat satu perintah, serta di Claude Desktop dan Cursor lewat file konfigurasi JSON yang sama. Server dijalankan dengan npx kasera-pay-mcp, tanpa instalasi terpisah.

Apakah agent yang mengulang permintaan bisa membuat tagihan ganda?

Pengulangan jaringan dari satu panggilan tidak membuat tagihan ganda, karena server memasang Idempotency-Key baru untuk setiap panggilan create. Dua panggilan terpisah tetap menjadi dua pembayaran: meminta agent membuat pembayaran yang sama dua kali akan membuatnya dua kali.

Berapa biayanya?

MCP server tidak dikenai biaya tersendiri. Pembayaran yang dibuat lewat agent dikenai tarif yang sama dengan pembayaran lain: tarif default QRIS 0,7% + Rp 250, Virtual Account Rp 5.000 per transaksi berhasil, serta Rp 3.000 per pencairan. Untuk pembayaran di atas Rp 1.000.000, QRIS dan Virtual Account sama-sama 1% dari seluruh nominal. Tarif yang berlaku untuk sebuah akun tampil di dashboard, dan get_pricing membacanya langsung.