Endpoint: PATCH /unified/accounts/sellers/{sellers_pk}/
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).
Atualiza uma conta. Objetos aninhados (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

​
sellers_pk
string (uuid)
required
Identificador da conta unificada.

​
Corpo (todos os campos são opcionais em PATCH)

​
type
string
Um dos valores SELLER_PF, SELLER_PJ, SUB_SELLER_PF, SUB_SELLER_PJ. Alterar este campo após o cadastro inicial é raro.
​
email
string
E-mail de contato da conta.
​
revenue
integer
Faturamento mensal declarado, em centavos de BRL.
​
category
string
Código da categoria de negócio.
​
mcc
string
Merchant Category Code de quatro dígitos.
​
statement_descriptor
string
Descritor que aparece nas faturas do portador do cartão.
​
zoop_internal_status
string
Estado interno de sincronização do recurso. Editável.
​
person
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.
​
company
object
Dados de pessoa jurídica aninhados. Campos editáveis: name, phone, email, tax_id, e um objeto aninhado address.
​
bank_account
object
Conta bancária de liquidação. Campos editáveis: number, agency, code, type. Criada na primeira atualização caso ainda não exista.
​
split
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.

​
Resposta

Retorna a conta atualizada no mesmo formato de Buscar conta de vendedor. 
{
  "id": "9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711",
  "display_name": "ACME Comércio LTDA",
  "type": "SELLER_PJ",
  "email": "owner@acme.com.br",
  "statement_descriptor": "ACME SP",
  "updated_at": "2025-05-14T11:22:33.000000Z"
}

​
Erros

StatusQuando
400Falha de validação em algum campo do corpo (ex.: mcc inválido, objeto aninhado malformado).
401Token de portador ausente ou inválido.
403O chamador não possui acesso a esta conta.
404Conta não encontrada (ou oculta pelo filtro de acesso).

​
Exemplos

curl -X PATCH https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "statement_descriptor": "ACME SP",
    "bank_account": {"number": "00012345-7", "agency": "0001", "code": "001", "type": "checking"}
  }'