Endpoint: POST /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.
Cria uma conta cujo parent é definido como sellers_pk. O type aceito é SUB_SELLER_PF (exige person) ou SUB_SELLER_PJ (exige person e company). Um registro de acesso é criado automaticamente vinculando o chamador à nova subconta. Subcontas herdam o cadastro de processamento do pai — elas não são cadastradas separadamente na infraestrutura de processamento e não possuem zoop_id próprio até que uma sincronização posterior ocorra. Consulte também: Onboarding de vendedor e o Fluxo de subscrição para casos de uso de subcontas.

​
Parâmetros de caminho

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

​
Corpo

​
type
string
required
Deve ser SUB_SELLER_PF ou SUB_SELLER_PJ. Outros valores são rejeitados.
​
email
string
required
E-mail de contato da subconta.
​
person
object
required
Obrigatório para subcontas PF e PJ. Campos: birthdate, taxpayer_id (CPF, somente dígitos), mother_name, first_name, last_name, phone, email, mais um objeto address com neighborhood, city, state, postal_code, country_code, street, number obrigatórios (e complement opcional).
​
company
object
Obrigatório quando type é SUB_SELLER_PJ. Campos: name, phone, email, tax_id (CNPJ, somente dígitos), mais um objeto address obrigatório.

​
Resposta

201 Created. Retorna a nova subconta no formato completo de detalhes (consulte Buscar conta de vendedor). 
{
  "id": "0c8a2b81-9d31-4b30-9d1f-8a8f43f1f1a1",
  "display_name": "ACME Filial Centro",
  "type": "SUB_SELLER_PJ",
  "email": "centro@acme.com.br",
  "person": { "first_name": "João", "last_name": "Silva", "taxpayer_id": "12345678901" },
  "company": { "name": "ACME Comércio LTDA - Filial Centro", "tax_id": "12345678000280" },
  "zoop_id": null,
  "created_at": "2025-05-14T09:11:00.000000Z"
}

​
Erros

StatusQuando
400type não é um valor de subconta; company ausente quando type é SUB_SELLER_PJ; falha de validação em campos aninhados.
401Token de portador ausente ou inválido.
403O chamador não possui acesso à conta pai.
404Conta pai inexistente.

​
Exemplos

curl -X POST https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/sub/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "SUB_SELLER_PJ",
    "email": "centro@acme.com.br",
    "person": {
      "first_name": "João",
      "last_name": "Silva",
      "taxpayer_id": "12345678901",
      "mother_name": "Maria da Silva",
      "birthdate": "1985-04-12",
      "phone": "+5511999990000",
      "email": "joao@acme.com.br",
      "address": {
        "neighborhood": "Centro",
        "city": "São Paulo",
        "state": "SP",
        "postal_code": "01001000",
        "country_code": "BR",
        "street": "Rua Direita",
        "number": "100"
      }
    },
    "company": {
      "name": "ACME Comércio LTDA - Filial Centro",
      "tax_id": "12345678000280",
      "email": "contato@acme.com.br",
      "phone": "+551133334444",
      "address": {
        "neighborhood": "Centro",
        "city": "São Paulo",
        "state": "SP",
        "postal_code": "01001000",
        "country_code": "BR",
        "street": "Rua Direita",
        "number": "100"
      }
    }
  }'