Altera um cartão (só os campos enviados)
Altera só os campos enviados; as regras são as do PUT. Para tirar o cartão de uso sem perder
o histórico, mude o status para closed.
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
Os campos do CartaoAlteracao, todos opcionais.
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 PATCH "https://example.com/cartoes/0" \ -H "Content-Type: application/json" \ -d '{}'{ "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" } ]}Um cartão GET
Cartão de outro workspace, inexistente, oculto para a credencial ou conta que não é cartão responde 404.
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`).