Registrar vendedor

Endpoint: POST /seller/register/

Autenticação: não exigida na rota. A chamada é encaminhada à infraestrutura de processamento utilizando a credencial privilegiada da plataforma, portanto este endpoint não pode ser acessível a clientes não confiáveis.

Esta é a rota legada de registro direto. Para novas integrações, recomenda-se utilizar POST /unified/accounts/sellers/, que centraliza o cadastro pelo modelo unificado de contas. Encaminha o corpo recebido para a infraestrutura de processamento:

type: "individual" → cadastro de vendedor pessoa física (PF).
type: "business" → cadastro de vendedor pessoa jurídica (PJ).

O campo type é removido do payload antes do encaminhamento. O restante é enviado tal como recebido, portanto o formato do corpo precisa atender ao que a infraestrutura de processamento espera. O status HTTP e o corpo JSON retornados pela infraestrutura são repassados sem modificação.

Corpo da requisição

string

required

Aceita "individual" (pessoa física) ou "business" (pessoa jurídica). Define para qual rota o payload será encaminhado. É removido antes do envio.

Vendedores pessoa física (`type = "individual"`)

string

required

Primeiro nome do vendedor.

string

required

Sobrenome do vendedor.

string

E-mail de contato.

string

Telefone de contato. Recomenda-se o formato internacional.

string

required

CPF do vendedor, somente dígitos (11 caracteres).

string

Data de nascimento em formato ISO 8601 (AAAA-MM-DD). O valor "0000-00-00" é normalizado para null no uso interno.

string

Código MCC de 4 dígitos. Consulte os valores válidos em GET /seller/mcc/.

string

Texto que aparecerá na fatura do portador do cartão.

string

Receita mensal declarada, enviada como string.

object

Endereço do vendedor. Chaves: line1, line2, neighborhood, city, state, postal_code, country_code.

Vendedores pessoa jurídica (`type = "business"`)

string

required

Razão social da empresa.

string

Telefone da empresa.

string

E-mail de contato da empresa.

string

required

CNPJ da empresa, somente dígitos (14 caracteres).

string

Código MCC de 4 dígitos.

string

Texto que aparecerá na fatura do portador do cartão.

string

Receita mensal declarada, enviada como string.

object

Endereço da empresa. Chaves: line1, line2, neighborhood, city, state, postal_code, country_code.

object

required

Representante legal da empresa. Chaves: first_name, last_name, email, phone_number, taxpayer_id (CPF), birthdate (AAAA-MM-DD).

object

Endereço residencial do representante legal. Mesmas chaves de business_address. A rotina interna de validação também aceita owner.address e o remapeia para owner_address.

Resposta

O corpo retornado corresponde exatamente ao retorno da infraestrutura de processamento para a operação de cadastro. Um cadastro bem-sucedido responde com 201 Created e inclui um identificador (id) que deve ser persistido — esse valor passa a ser o identificador histórico do vendedor na infraestrutura de processamento.

{
  "id": "27e17b778b404a83bf1f35100c46f111",
  "resource": "seller",
  "status": "pending",
  "type": "individual",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "email": "ada@example.com",
  "taxpayer_id": "12345678901",
  "marketplace_id": "...",
  "created_at": "2026-01-12T10:24:11.000Z",
  "updated_at": "2026-01-12T10:24:11.000Z"
}

Erros

Status	Quando ocorre
`400`	Campo `type` ausente ou diferente de `individual`/`business`. Também ocorre quando o payload é rejeitado (CPF/CNPJ inválido, campos obrigatórios ausentes etc.).
`405`	O método da requisição não é `POST`.
`4xx` / `5xx`	Qualquer código de erro retornado pela infraestrutura de processamento é repassado com o respectivo corpo JSON.

Exemplos

curl -X POST https://api.dlpay.cloud/seller/register/ \
  -H "Content-Type: application/json" \
  -d '{
    "type": "individual",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "email": "ada@example.com",
    "phone_number": "+5511999999999",
    "taxpayer_id": "12345678901",
    "birthdate": "1990-01-15",
    "mcc": "5734",
    "statement_descriptor": "ADA STORE",
    "address": {
      "line1": "Rua Exemplo",
      "line2": "100",
      "neighborhood": "Centro",
      "city": "Sao Paulo",
      "state": "SP",
      "postal_code": "01000000",
      "country_code": "BR"
    }
  }'

import requests

payload = {
    "type": "business",
    "business_name": "Ada & Co",
    "business_phone": "+5511999999999",
    "business_email": "contact@adaco.example",
    "ein": "12345678000199",
    "mcc": "5734",
    "statement_descriptor": "ADA CO",
    "business_address": {
        "line1": "Av. Paulista",
        "line2": "1000",
        "neighborhood": "Bela Vista",
        "city": "Sao Paulo",
        "state": "SP",
        "postal_code": "01310100",
        "country_code": "BR",
    },
    "owner": {
        "first_name": "Ada",
        "last_name": "Lovelace",
        "email": "ada@example.com",
        "phone_number": "+5511999999999",
        "taxpayer_id": "12345678901",
        "birthdate": "1990-01-15",
    },
    "owner_address": {
        "line1": "Rua Exemplo",
        "line2": "100",
        "neighborhood": "Centro",
        "city": "Sao Paulo",
        "state": "SP",
        "postal_code": "01000000",
        "country_code": "BR",
    },
}

response = requests.post(
    "https://api.dlpay.cloud/seller/register/",
    json=payload,
)
data = response.json()

const response = await fetch("https://api.dlpay.cloud/seller/register/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "individual",
    first_name: "Ada",
    last_name: "Lovelace",
    email: "ada@example.com",
    phone_number: "+5511999999999",
    taxpayer_id: "12345678901",
    birthdate: "1990-01-15",
    mcc: "5734",
    statement_descriptor: "ADA STORE",
    address: {
      line1: "Rua Exemplo",
      line2: "100",
      neighborhood: "Centro",
      city: "Sao Paulo",
      state: "SP",
      postal_code: "01000000",
      country_code: "BR",
    },
  }),
});
const data = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Corpo da requisição

Vendedores pessoa física (`type = "individual"`)

Vendedores pessoa jurídica (`type = "business"`)

Resposta

Erros

Exemplos

​Corpo da requisição

​Vendedores pessoa física (type = "individual")

​Vendedores pessoa jurídica (type = "business")

​Resposta

​Erros

​Exemplos

Corpo da requisição

Vendedores pessoa física (`type = "individual"`)

Vendedores pessoa jurídica (`type = "business"`)

Resposta

Erros

Exemplos