[Admin] Editar nominal

PATCH

/api/admin/nominais/{{nominal_id}}

Autenticação

Requer papel ADMIN. Authorization: Bearer {{admin_api_key}}.

[Admin] Editar nominal

Atualiza campos de uma nominal existente. Todos os campos do body são opcionais — só os enviados são alterados.

Campos editáveis

slug, displayName, backingAcquirer (interno), taxas (feePixIn/feePixInType/feePixInFixed, feeWithdrawal/feeWithdrawalType/feeWithdrawalFixed), isPremium, isActive, sortOrder. Enviar isDefault: true torna esta a nominal padrão (desmarca as demais).

Path

Param	Descrição
`{{nominal_id}}`	Id da nominal a editar.

Resposta

200 OK com { nominal: { ... } }.

Erros

HTTP	Quando
400	Body inválido (Zod).
401 / 403	Sem credencial ADMIN.
404	Nominal não encontrada.

Exemplo cURL

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200

application/json

Bodyapplication/json

🟠404

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request PATCH '/api/admin/nominais/{{nominal_id}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "displayName": "Hub",
  "feePixIn": 2.39,
  "isPremium": false,
  "sortOrder": 2
}'

Response Example

200 - Sucesso (200)

{
  "nominal": {
    "id": "{{nominal_id}}",
    "slug": "hub",
    "displayName": "Hub",
    "feePixIn": 2.39,
    "isPremium": false,
    "isActive": true,
    "sortOrder": 2
  }
}