Se stai costruendo un agente o un backend che deve spendere denaro, hai bisogno di carte che puoi creare e controllare nel codice. Questa guida percorre l'API carte di Cryptocardium dall'inizio alla fine — la stessa superficie è disponibile come REST per i servizi convenzionali e come server MCP per gli agenti LLM.
Autenticazione e scope
Ogni chiamata è autenticata con una chiave API Bearer generata nella tua dashboard. Le chiavi portano scope così puoi dare a un agente esattamente il potere di cui ha bisogno e niente di più.
cards:issue— crea nuove carte.cards:fund— sposta il saldo su una carta.cards:read— legge i dettagli della carta e le transazioni.cards:control— imposta limiti, congela, chiude.
Emetti una carta
Crea una carta virtuale con una singola richiesta. Scegli un BIN ottimizzato per il caso d'uso — pubblicità, SaaS, wallet o spese premium — e assegnale un'etichetta così potrai trovarla in seguito.
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
}Finanziala in crypto
Una nuova carta inizia con saldo zero. Finanziala dal saldo crypto del tuo conto — la carta è immediatamente spendibile fino a quell'importo.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Imposta i controlli di spesa
Limita ogni carta prima di consegnarla a un agente. Limiti e regole per esercente vengono applicati al momento dell'autorizzazione, lato 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"] }'Riconcilia con i webhook
Iscriviti agli eventi di autorizzazione e verifica la firma su ogni consegna. Questo mantiene il tuo registro contabile e il tuo agente sincronizzati senza polling.
// POST al tuo URL webhook
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…Lo stesso flusso tramite MCP
Quando un agente LLM deve gestire le carte direttamente, punta un client MCP sul server invece di scrivere un client REST. L'agente vede issue_card, fund_card e set_card_limits come strumenti nativi — consulta la guida al server MCP per la configurazione.
Tutto insieme
Autenticati con una chiave con scope, emetti una carta, finanziala in crypto, limitala e riconcilia tramite webhook. Questo è l'intero ciclo di cui un agente ha bisogno per spendere denaro in sicurezza. Apri un conto e genera la tua prima chiave per provarlo.
