Listar contas de vendedor

Endpoint: GET /unified/accounts/sellers/

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, alcançando também contas relacionadas por split (agente, distribuidor N1/N2, desenvolvedor) e por vínculos de pai/sub-conta.

A conta unificada é a entidade comerciante neutra em relação ao processador. Cada conta consolida os dados de processamento de pagamentos em uma única representação e é a âncora para transações, recebíveis, depósitos, terminais de ponto de venda, documentos, splits e métricas. Este endpoint retorna uma projeção compacta da conta, ideal para listagens. Para a representação completa com objetos aninhados (pessoa, empresa, conta bancária, split, documentos) consulte Buscar conta de vendedor.

Parâmetros de query

string

Busca textual sem distinção de maiúsculas/minúsculas nos campos email, statement_descriptor, person.first_name, person.last_name, person.taxpayer_id, company.name e company.tax_id.

Resposta

Retorna um array de contas resumidas, ordenadas por created_at decrescente.

string (uuid)

Identificador da conta unificada. É o sellers_pk usado nas URLs aninhadas.

string

Nome de exibição calculado: nome completo da pessoa para contas PF, razão social para contas PJ, com fallback para statement_descriptor ou email.

string

Um dos valores SELLER_PF, SELLER_PJ, SUB_SELLER_PF, SUB_SELLER_PJ.

string

E-mail de contato da conta.

string

Código da categoria de negócio (consulte GET /unified/accounts/sellers/categories/).

string

Merchant Category Code de quatro dígitos.

string

Descritor que aparece nas faturas do portador do cartão.

string | null

Identificador histórico do recurso na infraestrutura de processamento. Fica null enquanto a conta ainda não foi provisionada externamente.

string

Estado interno de sincronização do recurso, usado pelo suporte para acompanhar o estágio de onboarding.

string

Timestamp ISO-8601.

string

Timestamp ISO-8601.

[
  {
    "id": "9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711",
    "display_name": "ACME Comércio LTDA",
    "type": "SELLER_PJ",
    "email": "owner@acme.com.br",
    "category": "retail",
    "mcc": "5311",
    "statement_descriptor": "ACME",
    "zoop_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
    "zoop_internal_status": "ENABLED",
    "created_at": "2025-02-10T14:03:21.000000Z",
    "updated_at": "2025-04-30T09:51:02.000000Z"
  }
]

Erros

Status	Quando
`401`	Token de portador ausente ou inválido.
`403`	O chamador não possui acesso a nenhuma conta e não é superusuário.

Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

response = requests.get(
    "https://api.dlpay.cloud/unified/accounts/sellers/",
    headers={"Authorization": f"Bearer {access_token}"},
    params={"search": "acme"},
)
accounts = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/unified/accounts/sellers/?search=acme",
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const accounts = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Listar contas de vendedor

Parâmetros de query

Resposta

Erros

Exemplos

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Parâmetros de query

Resposta

Erros

Exemplos