Atualizar uma taxa

PUT

/api/v1/fees/{id}

Endpoint para usuário administrador atualizar parâmetros de taxa existente (usuário vigente autenticado).

Somente usuários com permissão/role de ADMINISTRADOR (admin) conseguem usar este endpoint.

💾 Estrutura de Dados

Headers

Content-type: application/json

Authorization: Bearer <JWT_TOKEN>

Route Params

Propriedade	Tipo	Obrigatório	Descrição	Valor (exemplo)
`:id`	UUID	Sim	Identificador da taxa que deve ser atualizada	123e4567-e89b-12d3-a456-426655440000

Body (JSON)

Envie apenas os campos que deseja atualizar. Os campos são idênticos aos de criação.

Propriedade	Tipo	Obrigatório	Descrição	Valor (exemplo)
feeType	Enum	Sim	Tipo de taxa com 2 opções pré-definidas	`PERCENTAGE` `FIXED`
feeValue	Number	Sim	Valor da taxa	3.0
description	String	Não	Descrição breve sobre a taxa	-

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200

application/json

Body

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://xpend-backend.onrender.com/api/v1/fees/70c24c31-1b4c-440a-878f-6071d81be209' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "id": "3789c44c-a258-4444-98c4-4746e4a4d669",
    "sellerId": "e9832f40-2680-4753-9f61-a8b0323c12bf",
    "feeType": "FIXED",
    "feeValue": "20000",
    "description": "PagLemon Fixed Fee",
    "isActive": true,
    "createdAt": "2025-11-13T14:23:25.034Z",
    "updatedAt": "2025-11-13T14:23:25.034Z"
}

Modified at 2025-12-27 01:31:55

Criar uma taxa

Criar saque 🚧

Atualizar uma taxa

💾 Estrutura de Dados#

Headers#