Endpoint: GET /unified/accounts/sellers/{sellers_pk}/sub/
Autenticação: token JWT obrigatório. Superusuários ignoram a verificação de acesso. Usuários comuns precisam de um registro de acesso à conta pai (ou a uma conta relacionada).
Uma subconta é uma conta cujo parent é o vendedor da URL. Subcontas compartilham o cadastro do pai na infraestrutura de processamento e são tipicamente usadas para segmentar contas virtuais, sub-comerciantes sob um marketplace ou unidades de franquia. Subcontas são distintas das contas relacionadas — consulte Listar contas relacionadas para contas vinculadas por split.

Parâmetros de caminho

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

Resposta

Retorna um array de contas cujo parent é igual a sellers_pk. Cada item utiliza o formato completo de detalhes da conta (igual a Buscar conta de vendedor), incluindo os objetos aninhados person, company, bank_account, split e documents.
[
  {
    "id": "0c8a2b81-9d31-4b30-9d1f-8a8f43f1f1a1",
    "display_name": "ACME Filial Centro",
    "type": "SUB_SELLER_PJ",
    "email": "centro@acme.com.br",
    "statement_descriptor": "ACME CENTRO",
    "mcc": "5311",
    "category": "retail",
    "company": { "name": "ACME Comércio LTDA - Filial Centro", "tax_id": "12345678000280" },
    "zoop_id": "b2c3d4e5f6071829",
    "created_at": "2025-03-04T08:11:00.000000Z"
  }
]

Erros

StatusQuando
401Token de portador ausente ou inválido.
403O chamador não possui acesso à conta pai.
404Conta pai inexistente.

Exemplos

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