Autenticação: token JWT obrigatório. Superusuários ignoram a verificação de acesso. Usuários comuns precisam de um registro de acesso à conta de vendedor (ou a uma conta relacionada por pai, sub-conta ou split).
person, company, bank_account, split) são atualizados no local — enviar um objeto parcial altera apenas os campos informados. Se bank_account ou split ainda não existirem, são criados na primeira atualização.
PUT também é aceito para substituição total, mas o PATCH é o método recomendado.
Observação: alterações em zoop_id, zoop_acquirer_status ou zoop_last_updated por este endpoint são rejeitadas — esses campos são mantidos pela rotina de sincronização com a infraestrutura de processamento. Consulte Webhooks e jobs.
Parâmetros de caminho
string (uuid)
required
Identificador da conta unificada.
Corpo (todos os campos são opcionais em PATCH)
string
Um dos valores
SELLER_PF, SELLER_PJ, SUB_SELLER_PF, SUB_SELLER_PJ. Alterar este campo após o cadastro inicial é raro.string
E-mail de contato da conta.
integer
Faturamento mensal declarado, em centavos de BRL.
string
Código da categoria de negócio.
string
Merchant Category Code de quatro dígitos.
string
Descritor que aparece nas faturas do portador do cartão.
string
Estado interno de sincronização do recurso. Editável.
object
Dados de pessoa física aninhados. Campos editáveis:
birthdate, taxpayer_id, mother_name, first_name, last_name, phone, email, e um objeto aninhado address (neighborhood, city, state, postal_code, country_code, street, number, complement). O id é somente leitura.object
Dados de pessoa jurídica aninhados. Campos editáveis:
name, phone, email, tax_id, e um objeto aninhado address.object
Conta bancária de liquidação. Campos editáveis:
number, agency, code, type. Criada na primeira atualização caso ainda não exista.object
Configuração de split. Campos editáveis:
agent, n1_distributor, n2_distributor, developer, redirect_sales_to (cada um aceita o UUID de outra conta ou null), plan (UUID de um plano de split ou null), is_system_managed (booleano). Criada na primeira atualização caso ainda não exista.