Jika Anda sedang membangun agen atau backend yang perlu membelanjakan uang, Anda memerlukan kartu yang dapat dibuat dan dikendalikan dalam kode. Panduan ini menjelaskan API kartu Cryptocardium dari awal hingga akhir — permukaan yang sama tersedia sebagai REST untuk layanan konvensional dan sebagai MCP server untuk agen LLM.
Autentikasi dan cakupan
Setiap panggilan diautentikasi dengan kunci API Bearer yang dibuat di dasbor Anda. Kunci membawa cakupan agar Anda dapat memberikan agen tepat kekuatan yang dibutuhkan dan tidak lebih.
cards:issue— buat kartu baru.cards:fund— pindahkan saldo ke kartu.cards:read— baca detail kartu dan transaksi.cards:control— tetapkan batas, bekukan, tutup.
Terbitkan kartu
Buat kartu virtual dengan satu permintaan. Pilih BIN yang disesuaikan dengan kasus penggunaan — iklan, SaaS, dompet, atau pengeluaran premium — dan berikan label agar mudah ditemukan nanti.
curl -X POST https://cryptocardium.com/api/v1/cards \
-H "Authorization: Bearer ck_live_…" \
-H "Content-Type: application/json" \
-d '{ "type": "virtual", "brand": "visa", "label": "ads-agent" }'{
"id": "card_9f2a1c",
"brand": "visa",
"last4": "4417",
"status": "active",
"balance_usd": 0.00
}Danai dari kripto
Kartu baru dimulai dengan saldo nol. Danai dari saldo kripto akun Anda — kartu langsung dapat digunakan hingga jumlah tersebut.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Tetapkan kontrol pengeluaran
Batasi setiap kartu sebelum Anda serahkan kepada agen. Batas dan aturan merchant diterapkan pada saat otorisasi, di sisi server.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/limits \
-H "Authorization: Bearer ck_live_…" \
-d '{ "monthly_usd": 200, "daily_usd": 50, "mcc_allow": ["5818"] }'Rekonsiliasi dengan webhook
Berlangganan acara otorisasi dan verifikasi tanda tangan pada setiap pengiriman. Ini menjaga buku besar Anda dan agen Anda tersinkronisasi tanpa perlu melakukan polling.
// POST ke URL webhook Anda
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…Alur yang sama melalui MCP
Ketika agen LLM harus mengelola kartu sendiri, arahkan klien MCP ke server alih-alih menulis klien REST. Agen melihat issue_card, fund_card, dan set_card_limits sebagai alat bawaan — lihat panduan MCP server untuk pengaturannya.
Menyatukan semuanya
Autentikasi dengan kunci terlingkup, terbitkan kartu, danai dari kripto, batasi, dan rekonsiliasi melalui webhook. Itulah seluruh siklus yang dibutuhkan agen untuk membelanjakan uang dengan aman. Buka akun dan buat kunci pertama Anda untuk mencobanya.
