Pular para o conteúdo principal
PATCH
Atualizar subconta

Autorizações

Authorization
string
header
obrigatório

Chave de API MingoPay com prefixo mp_test_ ou mp_live_.

Parâmetros de caminho

id
string<uuid>
obrigatório

Corpo

application/json
name
string

Nome visível. Não aceita HTML nem caracteres de controle.

Required string length: 2 - 100
email
string<email> | null

E-mail permanente. Domínios descartáveis, typos de provedores conhecidos e domínios sem entrega são recusados.

Maximum string length: 254
active
boolean
feeMode
enum<string>
Opções disponíveis:
global,
custom
customFees
object
pixKey
string | null
write-only

Chave Pix criptografada. null remove; omitir preserva. Consultas não retornam texto aberto.

Required string length: 3 - 200
holderTaxId
string | null
write-only

CPF/CNPJ com dígitos verificadores válidos, criptografado. Não comprova identidade; null remove.

blockMode
enum<string>
Opções disponíveis:
none,
payouts,
all
payoutLimits
object

Débito total, incluindo tarifa e comissão. Zero = sem limite adicional. Dias e meses em America/Sao_Paulo.

Resposta

Operação concluída.

id
string<uuid>
obrigatório
name
string
obrigatório
email
string | null
obrigatório
externalReference
string
obrigatório
environment
enum<string>
obrigatório
Opções disponíveis:
sandbox,
production
active
boolean
obrigatório
linked
boolean
obrigatório
availableCents
integer
obrigatório
reservedCents
integer
obrigatório
providerAvailableCents
integer | null
obrigatório
providerBlockedCents
integer | null
obrigatório
syncErrorCode
string | null
obrigatório
provider
string
obrigatório
providerBalanceCents
integer | null
obrigatório
syncedAt
string<date-time> | null
obrigatório
createdAt
string<date-time>
obrigatório
updatedAt
string<date-time>
obrigatório
feeMode
enum<string>
obrigatório
Opções disponíveis:
global,
custom
customFees
object
obrigatório
blockMode
enum<string>
obrigatório
Opções disponíveis:
none,
payouts,
all
payoutLimits
object
obrigatório

Débito total, incluindo tarifa e comissão. Zero = sem limite adicional. Dias e meses em America/Sao_Paulo.

effectiveFees
object
obrigatório
pixKeyMasked
string | null
obrigatório
holderTaxIdMasked
string | null
obrigatório