✏️ Atualizar Transação

Permite a edição manual de campos administrativos e financeiros de uma transação para fins de conciliação administrativa e correções de ledger no Backoffice.

Endpoint: PUT/PATCH /backoffice/transactions/\{id\}

---

📥 Parâmetros de Entrada (Body JSON)

Campo	Tipo	Descrição	Obrigatório/Opcional
value	numeric	Novo valor monetário da transação.	Opcional
status	integer	Código de status da transação (0 = Pendente, 1 = Confirmada, 2 = Cancelada, -1 = Erro, 4 = Concluída).	Opcional
name	string	Nome do pagador (alias para payer_name).	Opcional
document	string	CPF ou CNPJ do pagador (alias para payer_document).	Opcional
payer_name	string	Nome do pagador.	Opcional
payer_document	string	CPF ou CNPJ do pagador (validado por CPF/CNPJ).	Opcional
receiver_name	string	Nome do recebedor.	Opcional
receiver_document	string	CPF ou CNPJ do recebedor.	Opcional
accountId	integer	ID da conta vinculada (alias para account_id).	Opcional
account_id	integer	ID da conta vinculada (deve existir na base).	Opcional
type	integer	ID da categoria/tipo de transação (alias para type_id).	Opcional
type_id	integer	ID da categoria/tipo de transação.	Opcional
description	string	Descrição textual da transação.	Opcional
currency	string	Código da moeda (ex: BRL).	Opcional
origin	string	Origem da transação (ex: PIX).	Opcional
payer_bank_name	string	Nome do banco pagador.	Opcional
payer_agency	string	Agência bancária do pagador.	Opcional
payer_account	string	Conta bancária do pagador.	Opcional
receiver_bank_name	string	Nome do banco recebedor.	Opcional
receiver_agency	string	Agência bancária do recebedor.	Opcional
receiver_account	string	Conta bancária do recebedor.	Opcional
metadata	object	Metadados adicionais da transação em JSON.	Opcional
details	object	Detalhes complementares da operação.	Opcional

Payload de Exemplo (JSON)

{
  "value": 1750.50,
  "status": 1,
  "name": "Cliente VIP Ltda",
  "document": "83884813000109",
  "accountId": 2,
  "type": 1,
  "description": "Ajuste manual de transação pix",
  "metadata": {
    "adjusted_by": "admin",
    "reason": "Erro de conciliação automática"
  }
}

---

📤 Retorno de Sucesso (200 OK)

{
    "code": 200,
    "success": true,
    "transaction": {
        "id": 1,
        "txid": "E123456789...",
        "endtoendid": "E123456789...",
        "value": 1750.50,
        "status": 1,
        "description": "Ajuste manual de transação pix",
        "datetime": "2024-04-20 12:00:00",
        "balance": 5000.00,
        "bank_details": {
            "bank": "001",
            "agency": "1234",
            "account": "567890"
        },
        "account": { "id": 2, "name": "Conta Exemplo" },
        "type": { "id": 1, "name": "PIX_IN", "description": "Entrada de Pix" },
        "payer": {
            "name": "Cliente VIP Ltda",
            "document": "83884813000109",
            "bank": "Banco Teste",
            "agency": "0001",
            "account": "112233"
        },
        "receiver": {
            "name": "Usuario B",
            "document": "11111111111",
            "bank": "FastGiveMoney",
            "agency": "0001",
            "account": "445566"
        },
        "created_by": { "id": 5, "name": "Admin" },
        "created_at": "2024-04-20 12:00:00",
        "updated_at": "2026-05-21 09:10:00",
        "currency": "BRL",
        "metadata": {
            "adjusted_by": "admin",
            "reason": "Erro de conciliação automática"
        }
    },
    "message": "Transaction updated successfully"
}

---

❌ Erros Comuns

Código	Descrição
401	Não Autorizado: Token ausente ou inválido.
422	Erro de Validação: Dados enviados estão fora do formato esperado (ex: type_id inexistente).
404	Não Encontrado: Transação inexistente.