Se você está construindo um agente ou backend que precisa gastar dinheiro, você precisa de cartões que possa criar e controlar em código. Este guia percorre a API de cartão da Cryptocardium do início ao fim — a mesma superfície está disponível como REST para serviços convencionais e como servidor MCP para agentes LLM.
Autenticação e escopos
Cada chamada é autenticada com uma chave de API Bearer criada no seu painel. As chaves carregam escopos para que você possa dar a um agente exatamente o poder que ele precisa e nada mais.
cards:issue— criar novos cartões.cards:fund— mover saldo para um cartão.cards:read— ler detalhes e transações do cartão.cards:control— definir limites, congelar, encerrar.
Emitir um cartão
Crie um cartão virtual com uma única requisição. Escolha um BIN ajustado para o caso de uso — anúncios, SaaS, carteiras ou gastos premium — e atribua um rótulo para encontrá-lo facilmente depois.
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
}Financiar com cripto
Um novo cartão começa com saldo zero. Financie-o a partir do saldo em cripto da sua conta — o cartão fica imediatamente disponível para gastos até esse valor.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Definir controles de gasto
Limite cada cartão antes de entregá-lo a um agente. Limites e regras de estabelecimento são aplicados no momento da autorização, no lado do 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"] }'Reconciliar com webhooks
Assine os eventos de autorização e verifique a assinatura em cada entrega. Isso mantém seu razão e seu agente sincronizados sem precisar consultar o endpoint.
// POST para a URL do seu webhook
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…O mesmo fluxo via MCP
Quando um agente LLM deve operar os cartões diretamente, aponte um cliente MCP para o servidor em vez de escrever um cliente REST. O agente enxerga issue_card, fund_card e set_card_limits como ferramentas nativas — consulte o guia do servidor MCP para a configuração.
Juntando tudo
Autentique com uma chave com escopo, emita um cartão, financie-o com cripto, defina limites e reconcilie por webhooks. Esse é o ciclo completo que um agente precisa para gastar dinheiro com segurança. Abra uma conta e crie sua primeira chave para experimentar.
