Cria um cartão
Cria um cartão de crédito com os plásticos (um titular e os adicionais) e a fatura do mês
anterior ao vencimento, já fechada com o valor_fatura_anterior. Exige o papel Editor ou
um papel com permissão de editar Contas (o mesmo do app). A conta de pagamento precisa estar na
moeda do cartão e ser conta corrente, dinheiro, poupança ou conta do balanço.
A resposta é o cartão criado, no formato do GET /cartoes/{id}. O cartão também aparece em
/contas, com tipo cartao_credito, mas só se escreve aqui.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
application/json- body
nome*stringlength <= 200moeda?stringCódigo ISO 4217; sem ele, a moeda padrão do workspace.
banco?stringCódigo da instituição no catálogo (o banco.codigo das contas).
length <= 20proximo_vencimento*stringO vencimento da fatura aberta, AAAA-MM-DD.
datedias_fechamento*integerQuantos dias antes do vencimento a fatura fecha.
1 <= value <= 31tipo_limite?stringtotal (padrão na criação): o limite é do cartão; mensal: vale por fatura; indefinido: sem limite.
"total""mensal""indefinido"limite?numberObrigatório na criação, menos no limite indefinido, em que é ignorado.
0 <= valueconta_pagamento_id*integerA conta de onde a fatura é paga, na moeda do cartão.
plasticos*array<>Um titular e os adicionais.
1 <= itemsvalor_fatura_anterior?numberO valor da fatura do mês anterior ao vencimento, negativo quando devedor. Na criação (padrão 0) vira a primeira fatura, já fechada; na alteração, ajusta essa fatura enquanto não há outra fechada.
O cartão criado.
application/json- response
id*integernome*stringstatus*StatusContaactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"moeda*stringCódigo ISO 4217; as faturas são nesta moeda.
banco*|nulltipo_limite*stringtotal o limite é do cartão; mensal vale por fatura; indefinido sem limite.
"total""mensal""indefinido"limite*|Nulo no limite indefinido.
limite_disponivel*|O que sobra do limite com a fatura aberta e, no limite total, com as compras das faturas futuras que não são fixas. Nulo no limite indefinido.
dia_vencimento*integerdias_fechamento*integerQuantos dias antes do vencimento a fatura fecha.
proximo_vencimento*stringO vencimento da fatura aberta.
dateproximo_fechamento*stringdateconta_pagamento*|A conta de onde a fatura é paga; nula quando oculta para a credencial.
plasticos*array<>Titular primeiro.
curl -X POST "https://example.com/cartoes" \ -H "Content-Type: application/json" \ -d '{ "nome": "Nubank", "proximo_vencimento": "2026-10-20", "dias_fechamento": 7, "conta_pagamento_id": 0, "plasticos": [ { "nome": "string", "tipo": "titular" } ] }'{ "id": 2052, "nome": "Visa Platinum", "status": "active", "moeda": "BRL", "banco": { "codigo": "string", "nome": "string" }, "tipo_limite": "total", "limite": 5000, "limite_disponivel": 3120.5, "dia_vencimento": 5, "dias_fechamento": 7, "proximo_vencimento": "2019-08-24", "proximo_fechamento": "2019-08-24", "conta_pagamento": { "id": 0, "nome": "string" }, "plasticos": [ { "id": 0, "nome": "Ana", "tipo": "titular", "status": "active" } ]}Lista os cartões de crédito GET
Os cartões do workspace com limite, vencimento, fechamento, a conta que paga a fatura e os plásticos. Inclui os inativos e os encerrados; filtre com `status=active` para só os que estão em uso. Cartão **oculto** para a credencial não aparece.
A fatura de todos os cartões num mês GET
O resumo da fatura de cada cartão em uso que vence no mês, numa chamada só: "quanto vou pagar de cartão este mês". Sem `mes`, a fatura aberta de cada cartão. Os números são os de `GET /cartoes/{id}/faturas/{mes}`, sem os lançamentos; cartão cuja fatura do mês passa do horizonte de faturas futuras fica de fora.