API atual/Referência completa/Autenticação avançada

Adoção de conta importada por CNPJ

Envia um código ao e-mail antigo de uma conta B2B importada, para o cliente assumir o cadastro ao se registrar.

Quando a loja vem de outra plataforma, os clientes empresariais são importados sem senha. Se um deles se cadastra de novo com o mesmo CNPJ, a loja não pode simplesmente entregar a conta importada: qualquer pessoa que souber o CNPJ assumiria o cadastro. A adoção resolve isso: antes do registro, a plataforma manda um código de verificação ao e-mail que já está na conta importada, e o cliente só consegue assumir a conta se informar esse código.

Esta rota é só o passo de envio. O código volta no campo adoption_otp de POST /api/v1/auth/register, junto com o CNPJ.

POST/api/v1/auth/cnpj-adoption/otp/requestPública

Pedir o código de adoção

Corpo da requisição

cnpjstringobrigatório

CNPJ da empresa, com ou sem pontuação.

Cabeçalhos

X-Recaptcha-Tokenstring

Token reCAPTCHA v3, exigido só se a loja configurou reCAPTCHA.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/auth/cnpj-adoption/otp/request" \
  -H "Content-Type: application/json" \
  -d '{
  "cnpj": "12.345.678/0001-95"
}'

Resposta

200Pedido aceito

json

{
  "success": true
}

Campos da resposta

successboolean

Sempre true. Não indica que um e-mail foi enviado.

Erros

Status	Quando	Exemplo de corpo
400	CNPJ ausente ou corpo inválido.	`{"error":"invalid_request","detail":"CNPJ is required"}`
403	reCAPTCHA exigido e ausente ou reprovado.	`{"error":"captcha_required","detail":"reCAPTCHA token is required"}`
429	Limite de requisições da família `/auth/`.	`{"error":"rate limit exceeded","detail":"too many requests, please try again later"}`
503	A loja não habilitou a adoção ou o envio do código.	`{"error":"cnpj_adoption_unavailable","detail":"contact the store to verify the imported account"}`

Veja também