Criar uma taxa

POST

/api/v1/fees

Endpoint para usuário administrador criar uma taxa (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>

Body (JSON)

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: ********************

Body Params application/json

Examples

Responses

🟢201

application/json

Body

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://xpend-backend.onrender.com/api/v1/fees' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "feeType": "PERCENTAGE",
    "feeValue": 2.6
}'

Response Example

201 - Success

{
    "id": "7b44647b-f3ef-4d7a-a4a3-d8f6ab919d81",
    "sellerId": null,
    "feeType": "PERCENTAGE",
    "feeValue": "2.5",
    "description": null,
    "isActive": true,
    "createdAt": "2025-11-13T15:28:16.614Z",
    "updatedAt": "2025-11-13T15:28:16.614Z"
}

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

Atualizar configurações

Atualizar uma taxa

Criar uma taxa

💾 Estrutura de Dados#

Headers#

Body (JSON)#

Request

Responses

💾 Estrutura de Dados

Headers

Body (JSON)