Endpoint: GET /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).
Retorna a projeção completa da conta: o cabeçalho da conta e seus objetos aninhados person, company, bank_account, split e a lista de documents enviados. É a contrapartida de leitura de Atualizar conta de vendedor. Consulte também o fluxo de Onboarding de vendedor.

​
Parâmetros de caminho

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

​
Resposta

​
id
string (uuid)
​
display_name
string
Calculado a partir de person ou company, com fallback para statement_descriptor ou email.
​
type
string
SELLER_PF, SELLER_PJ, SUB_SELLER_PF ou SUB_SELLER_PJ.
​
email
string
​
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.
​
person
object | null
Dados de pessoa física. Presente para tipos *_PF. Campos: id, birthdate, taxpayer_id (CPF, somente dígitos), mother_name, first_name, last_name, phone, email, mais um objeto aninhado address (neighborhood, city, state, postal_code, country_code, street, number, complement).
​
company
object | null
Dados de pessoa jurídica. Presente para tipos *_PJ. Campos: id, name, phone, email, tax_id (CNPJ, somente dígitos), mais um objeto aninhado address com o mesmo formato de person.address.
​
bank_account
object | null
Conta bancária de liquidação. Campos: id, number, agency, code (código ISPB ou de 3 dígitos do banco), type (ex.: checking, savings).
​
split
object | null
Configuração de split. Campos: id, agent, n1_distributor, n2_distributor, developer, redirect_sales_to (cada um é uma projeção {id, display_name, type} de outra conta), plan (o plano de split associado) e is_system_managed.
​
documents
array
Documentos de KYC enviados. Cada item contém id, name, status, extension, mime_type, category, document_type, download_link, zoop_id, zoop_acquirer_status, zoop_last_updated, created_at, updated_at.
​
zoop_id
string | null
Identificador histórico do recurso na infraestrutura de processamento. Somente leitura.
​
zoop_acquirer_status
string
Estado reportado pela infraestrutura de processamento. Somente leitura.
​
zoop_internal_status
string
Estado interno de sincronização do recurso.
​
zoop_last_updated
string
Data da última sincronização com a infraestrutura de processamento. Somente leitura.
​
created_at
string
​
updated_at
string
{
  "id": "9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711",
  "display_name": "ACME Comércio LTDA",
  "type": "SELLER_PJ",
  "email": "owner@acme.com.br",
  "revenue": 5000000,
  "category": "retail",
  "mcc": "5311",
  "statement_descriptor": "ACME",
  "person": {
    "id": "0e9b6f1a-1f37-4a14-9bd9-7d0bc7a1cb91",
    "birthdate": "1985-04-12",
    "taxpayer_id": "12345678901",
    "mother_name": "Maria da Silva",
    "first_name": "João",
    "last_name": "Silva",
    "phone": "+5511999990000",
    "email": "joao@acme.com.br",
    "address": {
      "id": "f1d8ad6f-12d7-4f44-93a3-2b7421f8f6f0",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "postal_code": "01001000",
      "country_code": "BR",
      "street": "Rua Direita",
      "number": "100",
      "complement": "Sala 5"
    }
  },
  "company": {
    "id": "78a0b65e-71f2-4c50-a118-2c2f4d3b1a9c",
    "name": "ACME Comércio LTDA",
    "phone": "+551133334444",
    "email": "contato@acme.com.br",
    "tax_id": "12345678000199",
    "address": {
      "id": "27d8a6f4-12d7-4f44-93a3-2b7421f8f6f0",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "postal_code": "01001000",
      "country_code": "BR",
      "street": "Rua Direita",
      "number": "100",
      "complement": "Sala 5"
    }
  },
  "bank_account": {
    "id": "5b6d6df5-1d4b-4d35-a25e-65a7c7a0b3a1",
    "number": "00012345-6",
    "agency": "0001",
    "code": "001",
    "type": "checking"
  },
  "split": {
    "id": "11111111-2222-3333-4444-555555555555",
    "agent": { "id": "...", "display_name": "Agente A", "type": "SELLER_PJ" },
    "n1_distributor": null,
    "n2_distributor": null,
    "developer": null,
    "redirect_sales_to": null,
    "plan": { "id": "...", "name": "Plano Padrão" },
    "is_system_managed": true
  },
  "documents": [],
  "zoop_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "zoop_acquirer_status": "ENABLED",
  "zoop_internal_status": "ENABLED",
  "zoop_last_updated": "2025-04-30T09:51:02.000000Z",
  "created_at": "2025-02-10T14:03:21.000000Z",
  "updated_at": "2025-04-30T09:51:02.000000Z"
}

​
Erros

StatusQuando
401Token de portador ausente ou inválido.
403O chamador não possui acesso a esta conta nem a qualquer conta relacionada.
404Conta inexistente ou oculta pelo filtro de acesso.

​
Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"