cards · v2 · POST

Emitir cartão

Cria um cartão de crédito dedicado a um fornecedor. Cartões nascem ativos e prontos para autorizar cobranças até o teto mensal definido. Cada cartão emite seus próprios webhooks.

POST/v2/cards

Parâmetros do corpo

ParâmetroTipoDescrição

supplierREQ

string

Identificador legível do fornecedor. Aparece no painel e nas faturas. Ex. google_ads, openai.

limit_centsREQ

integer

Teto mensal em centavos, na moeda da cobrança. Reinicia todo dia 1º (horário de Brasília).

currencyOPT

string

Moeda da cobrança. Padrão BRL.

BRLUSDEURGBP

cost_centerOPT

string

Centro de custo / squad. Usado para agregação financeira no painel.

metadataOPT

object

Até 50 pares chave-valor (string → string) anexados ao cartão. Devolvidos em todos os eventos.

Eventos disparados

card.createdImediatamente após o sucesso.
card.activatedAssim que a rede confirma o BIN — normalmente em < 2s.

Erros comuns

402 insufficient_fundsSaldo da conta-mãe abaixo do teto solicitado.
409 supplier_conflictJá existe um cartão ativo para esse supplier + cost_center. Use force: true para sobrescrever.
422 limit_too_lowTeto abaixo do mínimo regulatório (R$ 10,00).

"color:#7a7a6f;font-style:italic"># Emitir um cartão para Google Ads curl -X POST https:"color:#7a7a6f;font-style:italic">//api.hubcard.com.br/v2/cards \ -H "Authorization: Bearer sk_live_••••" \ -H "Idempotency-Key: card_gads_2026_05" \ -H "Content-Type: application/json" \ -d '{ "supplier": "google_ads", "limit_cents": 2500000, "currency": "BRL", "cost_center": "marketing-br", "metadata": { "owner": "marina@pluria.com.br" } }'

{ "id": "card_01HX7P3M9G2N84ZV", "object": "card", "supplier": "google_ads", "status": "active", "last4": "4821", "number": "4111 0193 6624 4821", "exp_month": 12, "exp_year": 2030, "cvv": "742", "limit_cents": 2500000, "spent_cents": 0, "currency": "BRL", "cost_center": "marketing-br", "created_at": "2026-05-14T14:02:17Z" }