Atualizar taxas da subconta
PUT
/api/subaccounts/{{subaccount_id}}/fees
Operação delegada (white-label)
subaccounts:writeBody — envie ao menos um componente
pixIn, withdrawal) tem o mesmo formato:| Campo | Tipo | Descrição |
|---|---|---|
type | enum | PERCENT | FIXED | PERCENT_PLUS_FIXED. |
value | number|null | Parcela percentual em % (0–100). Em FIXED, este campo é a parcela fixa em REAIS (0–1000). |
fixed | number|null | Parcela fixa em REAIS (0–1000). Usado em PERCENT_PLUS_FIXED. |
type (espelha o normalizador do servidor):PERCENT → usa apenas value (%); fixed ignorado.FIXED → usa apenas value (reais); fixed ignorado.PERCENT_PLUS_FIXED → value (%) + fixed (reais).Regra de negócio (crítica) — FEE_BELOW_BASE
422 com code: "FEE_BELOW_BASE" e a base do master no corpo, por componente (PIX-in e saque são validados independentemente).Resposta 200 OK
{ success: true, fees: { pixIn?, withdrawal? } } — ecoa os componentes aplicados (valores como enviados: % e reais).Códigos de erro
| HTTP | code | Quando |
|---|---|---|
400 | — | Body inválido (Zod): nenhum componente, type fora do enum, fora dos ranges. |
401 | — | API Key ausente/inválida. |
404 | — | Master sem white-label, ou subconta inexistente/não-sua. |
422 | FEE_BELOW_BASE | Taxa abaixo da base do master (PIX-in ou saque). |
Exemplo cURL
Requisição
Parâmetros Header
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff --request PUT '/api/subaccounts/{{subaccount_id}}/fees' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"pixIn": {
"type": "PERCENT_PLUS_FIXED",
"value": 2.5,
"fixed": 0.50
},
"withdrawal": {
"type": "FIXED",
"value": 5.00,
"fixed": null
}
}'Response Response Example
200 - Sucesso (200) — taxas aplicadas
{
"success": true,
"fees": {
"pixIn": { "type": "PERCENT_PLUS_FIXED", "value": 2.5, "fixed": 0.5 },
"withdrawal": { "type": "FIXED", "value": 5, "fixed": null }
}
}Modificado em 2026-07-02 06:57:27