Meu Dinheiro · API
Formas de pagamento

Altera uma forma de pagamento (só os campos enviados)

PATCH
/formas-pagamento/{id}

Altera nome e/ou status; o tipo não muda e os campos ausentes ficam como estão. Exige o papel Editor ou um papel com permissão de editar Formas de pagamento.

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Parâmetros de caminho

id*integer

Corpo da requisição

application/json
  1. body
nome?string
Tamanholength <= 50
status?StatusCadastro

inactive: desativado no app, segue nos lançamentos antigos.

Valores"active""inactive"

Corpo da resposta

A forma alterada.

application/json
  1. response
id*integer
nome*string
tipo*TipoFormaPagamento

cartao_credito: o lançamento entra na fatura do cartão.

Valores"normal""cartao_credito"
status*StatusCadastro

inactive: desativado no app, segue nos lançamentos antigos.

Valores"active""inactive"
curl -X PATCH "https://example.com/formas-pagamento/0" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": 77,  "nome": "Boleto",  "tipo": "normal",  "status": "active"}

Uma forma de pagamento GET

Forma de outro workspace, ou inexistente, responde 404.

Exclui uma forma de pagamento DELETE

Exclui a forma e a tira dos lançamentos, das agendas e das regras que a usavam. A de cartão de crédito não pode ser excluída. Exige o papel **Editor** ou um papel com permissão de excluir Formas de pagamento. A exclusão é definitiva.