Criar subconta

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

string (uuid)

required

Identificador da conta unificada pai.

Corpo

string

required

Deve ser SUB_SELLER_PF ou SUB_SELLER_PJ. Outros valores são rejeitados.

string

required

E-mail de contato da subconta.

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).

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

Status	Quando
`400`	`type` não é um valor de subconta; `company` ausente quando `type` é `SUB_SELLER_PJ`; falha de validação em campos aninhados.
`401`	Token de portador ausente ou inválido.
`403`	O chamador não possui acesso à conta pai.
`404`	Conta 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"
      }
    }
  }'

import requests

response = requests.post(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{seller_id}/sub/",
    headers={"Authorization": f"Bearer {access_token}"},
    json={
        "type": "SUB_SELLER_PJ",
        "email": "centro@acme.com.br",
        "person": {"first_name": "João", "last_name": "Silva", "taxpayer_id": "12345678901"},
        "company": {"name": "ACME Filial Centro", "tax_id": "12345678000280"},
    },
)
sub = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellerId}/sub/`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      type: "SUB_SELLER_PJ",
      email: "centro@acme.com.br",
      person: { first_name: "João", last_name: "Silva", taxpayer_id: "12345678901" },
      company: { name: "ACME Filial Centro", tax_id: "12345678000280" },
    }),
  },
);
const sub = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Parâmetros de caminho

Corpo

Resposta

Erros

Exemplos

​Parâmetros de caminho

​Corpo

​Resposta

​Erros

​Exemplos

Parâmetros de caminho

Corpo

Resposta

Erros

Exemplos