Si estás construyendo un agente o backend que necesita gastar dinero, necesitas tarjetas que puedas crear y controlar en código. Esta guía recorre la API de tarjetas de Cryptocardium de extremo a extremo — la misma superficie está disponible como REST para servicios convencionales y como servidor MCP para agentes LLM.
Autenticación y alcances
Cada llamada se autentica con una clave API de tipo Bearer generada en tu panel de control. Las claves llevan alcances para que puedas dar a un agente exactamente el poder que necesita y nada más.
cards:issue— crear nuevas tarjetas.cards:fund— mover saldo a una tarjeta.cards:read— leer detalles de tarjetas y transacciones.cards:control— establecer límites, congelar, cerrar.
Emitir una tarjeta
Crea una tarjeta virtual con una sola solicitud. Elige un BIN optimizado para el caso de uso — anuncios, SaaS, carteras o gasto premium — y asígnale una etiqueta para encontrarla más adelante.
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
}Cargarla con criptomonedas
Una tarjeta nueva comienza con saldo cero. Cárgala desde el saldo de criptomonedas de tu cuenta — la tarjeta queda disponible para gastar inmediatamente hasta ese importe.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Establecer controles de gasto
Acota cada tarjeta antes de entregársela a un agente. Los límites y las reglas de comercio se aplican en el momento de la autorización, del lado del servidor.
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"] }'Conciliar con webhooks
Suscríbete a los eventos de autorización y verifica la firma en cada entrega. Esto mantiene tu libro contable y tu agente sincronizados sin necesidad de polling.
// POST a tu URL de webhook
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…El mismo flujo a través de MCP
Cuando un agente LLM debe gestionar las tarjetas por sí mismo, apunta un cliente MCP al servidor en lugar de escribir un cliente REST. El agente ve issue_card, fund_card y set_card_limits como herramientas nativas — consulta la guía del servidor MCP para la configuración.
Poniéndolo todo junto
Autentícate con una clave con alcance limitado, emite una tarjeta, cárgala con criptomonedas, acótala y concilia a través de webhooks. Ese es el ciclo completo que un agente necesita para gastar dinero de forma segura. Abre una cuenta y genera tu primera clave para probarlo.
