BETAHubCard beta — feedback bem-vindo.
HubCardhubcard
Começar
solução · api de emissão

API de cartões pré-pago. POST emite. DELETE cancela.

API REST para emitir cartões corporativos pré-pagos virtuais com limite, MCC, currency e validade — em uma chamada. Idempotência obrigatória, webhooks tipados, MCP server para agentes de IA, SDKs em quatro linguagens.

Ler a docComeçar grátis

4 endpoints, nada mais

POST, GET, PATCH, DELETE. Verbos HTTP fazem o trabalho. Sem RPC, sem SOAP, sem fax.

Idempotency-Key obrigatória

Retry à vontade. A mesma chave nunca emite dois cartões — mesmo um ano depois.

Webhooks tipados

Schema versionado, assinatura HMAC, idempotency derivada do event_id. Documentado em OpenAPI.

MCP server nativo

Agentes Claude/GPT consomem a API como ferramenta. Cartão por job, cancelamento ao final.

SDKs oficiais

TypeScript, Python, Go e Ruby. Geração automática a partir do OpenAPI. Tipos garantidos.

Rate limit + teto global

Proteção contra agente em loop. Cap configurável por API key e por organização.

Emissão em uma chamada

curl -X POST https://api.hubcard.one/v2/cards \
  -H "Authorization: Bearer sk_live_••••" \
  -H "Idempotency-Key: emit_ai_tools_2026_05" \
  -d '{
    "supplier": "openai-prod",
    "limit_cents": 800_00,
    "currency": "USD",
    "mcc_allow": [5734, 5818],
    "active_until": "2026-06-01T00:00:00Z"
  }'

# response (~140ms)
{
  "id": "card_01HX7P3M9",
  "status": "active",
  "pan": "5288 •••• •••• 7102",
  "exp_month": 6,
  "exp_year": 27,
  "limit_cents": 80000,
  "supplier": "openai-prod"
}

Cancelamento como POST

Quando você cancela um fornecedor, cancela o objeto. Sem call center, sem aprovação por SMS no telefone do CFO de férias. Um DELETE resolve. Os outros cartões da organização seguem ativos. Mais sobre essa decisão de design em por que cancelar um cartão deveria ser um POST.

Para agentes de IA

Agentes provisionam infraestrutura. Agora podem pagar por ela com cartão pré-pago escopado por job. Limite igual ao orçamento, MCC restrito, validade limitada à execução. Cancelamento automático ao final. Mais sobre o padrão em API de cartões pré-pago para agentes de IA.

Webhooks que você pode confiar

Cada evento (card.created, tx.captured, tx.declined, card.cancelled, etc.) tem schema versionado e idempotency derivada do event_id. Assinatura HMAC + timestamp evita replay. Retries com backoff exponencial até 17h. Detalhes em webhooks tipados na API de cartões.

SDKs oficiais

  • TypeScript: npm install @hubcard/sdk
  • Python: pip install hubcard
  • Go: go get github.com/hubcard/hubcard-go
  • Ruby: gem install hubcard
  • MCP server para Claude, GPT e agentes compatíveis (npx @hubcard/mcp).
faq

Perguntas frequentes

O que é uma API de cartões pré-pago?+

É uma API REST que permite emitir, listar, atualizar e cancelar cartões pré-pagos via chamadas HTTP. No HubCard: POST /v2/cards para emitir, PATCH para atualizar, DELETE para cancelar, webhooks tipados para cada transação. Inclui idempotência nativa, paginação por cursor e SDKs em TypeScript, Python, Go e Ruby.

Quais endpoints a API de emissão de cartões oferece?+

Quatro verbos principais: POST /v2/cards (emitir), GET /v2/cards/:id (ler), PATCH /v2/cards/:id (atualizar, inclui pausar/retomar), DELETE /v2/cards/:id (cancelar). Mais GET /v2/transactions com filtros por card_id, supplier, MCC, period.

Agentes de IA podem usar a API de cartões pré-pago?+

Sim — é um dos casos de uso primários. O HubCard expõe a API via MCP server para Claude, GPT e outros agentes. Cada agente pode emitir cartão escopado para uma job, executar, e cancelar — tudo com Idempotency-Key obrigatória e rate limit por API key.

Como a API trata idempotência?+

Header Idempotency-Key obrigatório em POST /v2/cards. A chave vive 24h em Redis. Mesma chave + mesmo body retorna response cached. Mesma chave + body diferente retorna 422. Resolve retries agressivos sem cartões duplicados.

Quanto custa usar a API de cartões pré-pago?+

Plano Free permite uso da API com 3 cartões ativos e 100 transações/mês. Plano Developer (US$ 20/mês) sobe para 25 cartões, 1.000 transações e MCP server. Para volume maior, planos Startup e Enterprise. Sem taxa por chamada de API.

Pronto para emitir cartões corporativos via API?

Comece grátis com 3 cartões ativos e veja a gestão de despesas em tempo real funcionando hoje.

Começar grátisVer planos
API de cartões pré-pago para empresas e agentes de IA — HubCard · HubCard