Endpoint: GET /unified/accounts/sellers/{sellers_pk}/related/
Autenticação: token JWT obrigatório. Superusuários ignoram a verificação de acesso. Usuários comuns precisam de um registro de acesso à conta sellers_pk.
Retorna o conjunto de contas unificadas “relacionadas” a sellers_pk. Contas relacionadas são aquelas em que sellers_pk aparece em qualquer uma destas posições:
  • como agent no split da conta
  • como n1_distributor no split da conta
  • como n2_distributor no split da conta
  • como developer no split da conta
  • como parent da conta
O próprio vendedor também é incluído. Esse é o mesmo escopo de acesso que controla a maioria dos endpoints de listagem unificada (receivables, transactions, deposits etc.) — use-o para enumerar quais vendedores um agente comissionado, distribuidor ou desenvolvedor está autorizado a visualizar. A resposta segue o mesmo formato de Listar contas de vendedor.

Parâmetros de caminho

sellers_pk
string (uuid)
required
A conta cujos relacionamentos você deseja enumerar.

Parâmetros de query

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 (mesmo formato de Listar contas de vendedor).
[
  {
    "id": "0c8a2b81-9d31-4b30-9d1f-8a8f43f1f1a1",
    "display_name": "ACME Filial Centro",
    "type": "SUB_SELLER_PJ",
    "email": "centro@acme.com.br",
    "mcc": "5311",
    "category": "retail",
    "statement_descriptor": "ACME CENTRO",
    "zoop_id": null,
    "zoop_internal_status": "PENDING",
    "created_at": "2025-03-04T08:11:00.000000Z",
    "updated_at": "2025-03-04T08:11:00.000000Z"
  }
]

Erros

StatusQuando
401Token de portador ausente ou inválido.
403O chamador não possui acesso a sellers_pk.
404sellers_pk inexistente.

Exemplos

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