Altera um cartão (todos os campos)
Troca todos os campos do cartão (menos valor_fatura_anterior, opcional); para alterar só
alguns, use PATCH. Exige o papel Editor ou um papel com permissão de editar Contas.
Plásticos: com id, o existente (nome e status; o titular não se inativa); sem id, um novo.
Plástico fora da lista fica como está, e adicional inativado sem lançamentos é excluído, como
no app. Trocar o proximo_vencimento desloca as faturas abertas: no máximo um mês adiante, e
para trás só se aquele mês não tem fatura fechada; adiante, com fatura fechada antiga, a fatura
aberta é fechada.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
id*integerO id do cartão (o mesmo da conta em /contas).
application/json- body
nome*stringlength <= 200moeda*stringCódigo ISO 4217; sem ele, a moeda padrão do workspace.
banco*|Có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<>Com id, o plástico existente (só nome e status; o titular não se inativa); sem id, um novo (nome e tipo). Plástico fora da lista fica como está.
valor_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.
status*StatusContaactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"O cartão alterado, no formato do GET /cartoes/{id}.
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 PUT "https://example.com/cartoes/0" \ -H "Content-Type: application/json" \ -d '{ "nome": "Nubank", "moeda": "BRL", "banco": "nubank", "proximo_vencimento": "2026-10-20", "dias_fechamento": 7, "tipo_limite": "total", "limite": 5000, "conta_pagamento_id": 0, "plasticos": [ {} ], "status": "active" }'{ "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" } ]}Exclui um cartão DELETE
Exclui o cartão, os plásticos e as faturas. Exige o papel **Editor** ou um papel com permissão de excluir Contas. A exclusão é definitiva. Cartão com lançamentos não é excluído (422): a saída que guarda o histórico é encerrá-lo (`PATCH` com `status: closed`).
As faturas do cartão, mês a mês GET
Um resumo por fatura, de `inicio` a `fim`: vencimento, situação, valor e pagamentos. Os meses antes da fatura aberta só aparecem quando a fatura existe; da aberta em diante, todos — a futura traz o que já foi lançado nela, inclusive parcelas e recorrências.