[Admin] Acesso e taxas por usuário
PATCH
/api/admin/nominais/access
Autenticação
Authorization: Bearer {{admin_api_key}}.[Admin] Habilitar/desabilitar nominal + override de taxa por usuário
Body
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
userId | string | sim | Id do usuário-alvo. |
nominalId | string | sim | Id da nominal. |
access | enum | não | ENABLED (libera) | DISABLED (bloqueia). Default no upsert de criação: ENABLED. |
feePixIn, feePixInType, feePixInFixed | number/enum | não | Override da taxa de entrada para este usuário. |
feeWithdrawal, feeWithdrawalType, feeWithdrawalFixed | number/enum | não | Override da taxa de saque para este usuário. |
type: PERCENT | FIXED | PERCENT_PLUS_FIXED.Resposta
200 OK com { userNominal: { ... } }.Erros
| HTTP | Quando |
|---|---|
| 400 | Body inválido (Zod). |
| 401 / 403 | Sem credencial ADMIN. |
| 404 | Usuário ou nominal não encontrado. |
Exemplo cURL
Requisição
Parâmetros Header
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/api/admin/nominais/access' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"userId": "{{user_id}}",
"nominalId": "{{nominal_id}}",
"access": "ENABLED",
"feePixIn": 1.99,
"feeWithdrawal": 0.99
}'Response Response Example
200 - Sucesso (200)
{
"userNominal": {
"id": "un_123",
"userId": "{{user_id}}",
"nominalId": "{{nominal_id}}",
"access": "ENABLED",
"feePixIn": 1.99,
"feeWithdrawal": 0.99
}
}Modificado em 2026-07-14 04:02:21