Skip to content

✏️ Atualizar Transação

Permite a edição manual de campos administrativos de uma transação. Campos financeiros críticos (valor, data, contas) não são editáveis por este endpoint para garantir a integridade do ledger.

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


📥 Parâmetros de Entrada (Body JSON)

CampoTipoDescrição
statusintegerNovo status da transação.
descriptionstringAlterar a descrição original.
type_idintegerCorrigir a categoria do tipo de transação.
metadataobjectDados técnicos adicionais em formato JSON.
detailsobjectDetalhes complementares da operação.

📤 Retorno de Sucesso (200 OK)

json
{
    "message": "Transaction updated successfully",
    "transaction": {
        "id": 1,
        "txid": "E123456789...",
        "endtoendid": "E123456789...",
        "value": 1500.00,
        "status": 1,
        "description": "Nova descrição atualizada",
        "datetime": "2024-04-20 12:00:00",
        "balance": 5000.00,
        "bank_details": {
            "bank": "001",
            "agency": "1234",
            "account": "567890"
        },
        "account": { "id": 10, "name": "Conta Exemplo" },
        "type": { "id": 1, "name": "PIX_IN", "description": "Entrada de Pix" },
        "payer": {
            "name": "Empresa A",
            "document": "00000000000191",
            "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": "2024-04-20 12:10:00",
        "currency": "BRL",
        "metadata": { "info": "updated" }
    }
}

❌ Erros Comuns

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

FastGivr API Documentation