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

​
type
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")

​
first_name
string
required
Primeiro nome do vendedor.
​
last_name
string
required
Sobrenome do vendedor.
​
email
string
E-mail de contato.
​
phone_number
string
Telefone de contato. Recomenda-se o formato internacional.
​
taxpayer_id
string
required
CPF do vendedor, somente dígitos (11 caracteres).
​
birthdate
string
Data de nascimento em formato ISO 8601 (AAAA-MM-DD). O valor "0000-00-00" é normalizado para null no uso interno.
​
mcc
string
Código MCC de 4 dígitos. Consulte os valores válidos em GET /seller/mcc/.
​
statement_descriptor
string
Texto que aparecerá na fatura do portador do cartão.
​
revenue
string
Receita mensal declarada, enviada como string.
​
address
object
Endereço do vendedor. Chaves: line1, line2, neighborhood, city, state, postal_code, country_code.

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

​
business_name
string
required
Razão social da empresa.
​
business_phone
string
Telefone da empresa.
​
business_email
string
E-mail de contato da empresa.
​
ein
string
required
CNPJ da empresa, somente dígitos (14 caracteres).
​
mcc
string
Código MCC de 4 dígitos.
​
statement_descriptor
string
Texto que aparecerá na fatura do portador do cartão.
​
revenue
string
Receita mensal declarada, enviada como string.
​
business_address
object
Endereço da empresa. Chaves: line1, line2, neighborhood, city, state, postal_code, country_code.
​
owner
object
required
Representante legal da empresa. Chaves: first_name, last_name, email, phone_number, taxpayer_id (CPF), birthdate (AAAA-MM-DD).
​
owner_address
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

StatusQuando ocorre
400Campo type ausente ou diferente de individual/business. Também ocorre quando o payload é rejeitado (CPF/CNPJ inválido, campos obrigatórios ausentes etc.).
405O método da requisição não é POST.
4xx / 5xxQualquer 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"
    }
  }'