> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mingopay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar taxas globais

> Exige subaccounts:write. Afeta novas operações com feeMode=global. Comissão adicional à tarifa Mingo.



## OpenAPI

````yaml /openapi.json put /v1/subaccounts/fee-settings
openapi: 3.1.0
info:
  title: MingoPay API
  version: 1.0.0
  description: >-
    API pública para cobranças Pix, subcontas, devoluções e consulta de saldo.
    Valores monetários em centavos; ambientes e saldos são isolados.
servers:
  - url: https://api.mingopay.com.br
    description: API MingoPay
security:
  - bearerAuth: []
tags:
  - name: Cobranças
    description: Criação, consulta e reconciliação de cobranças Pix.
  - name: Devoluções
    description: Devoluções parciais ou totais de cobranças pagas.
  - name: Saldo
    description: Saldo disponível calculado pelo ledger da organização.
  - name: Sandbox
    description: Simulações disponíveis somente para chaves mp_test_.
  - name: Subcontas
    description: >-
      Subcontas administradas pela sua organização, com cobranças e saldos
      separados.
paths:
  /v1/subaccounts/fee-settings:
    put:
      tags:
        - Subcontas
      summary: Atualizar taxas globais
      description: >-
        Exige subaccounts:write. Afeta novas operações com feeMode=global.
        Comissão adicional à tarifa Mingo.
      operationId: updateSubaccountFeeSettings
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubaccountFees'
      responses:
        '200':
          description: Taxas globais por organização e ambiente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubaccountFees'
components:
  schemas:
    SubaccountFees:
      type: object
      additionalProperties: false
      required:
        - saleFeePercent
        - saleFeeFixedCents
        - payoutFeePercent
        - payoutFeeFixedCents
      properties:
        saleFeePercent:
          type: number
          minimum: 0
          maximum: 100
          multipleOf: 0.01
        saleFeeFixedCents:
          type: integer
          minimum: 0
          maximum: 100000000
        payoutFeePercent:
          type: number
          minimum: 0
          maximum: 100
          multipleOf: 0.01
        payoutFeeFixedCents:
          type: integer
          minimum: 0
          maximum: 100000000
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Chave de API MingoPay com prefixo mp_test_ ou mp_live_.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.