Autenticação

A API usa JWT (JSON Web Tokens) para autenticação. Inclua o token no header Authorization de cada requisição.

Header de autenticação
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Registro

POST
/v1/auth/register

Cria uma nova conta de merchant. O merchant é criado com status PENDING e precisa ser aprovado por um admin.

Body (JSON)

ParâmetroTipoObrigatórioDescrição
emailstringSimEmail do merchant
passwordstringSimSenha (mín. 8 caracteres)
companyNamestringSimRazão social
cnpjstringSimCNPJ (14 dígitos)
phonestringSimTelefone com DDD
Exemplobash
curl -X POST https://api.pagniv.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "MinhaSenh@123",
    "companyName": "Empresa Ltda",
    "cnpj": "12345678901234",
    "phone": "11999998888"
  }'
Resposta 201JSON
{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "refreshToken": "eyJhbGciOiJIUzI1NiIs..."
  }
}

Login

POST
/v1/auth/login

Autentica um merchant e retorna tokens JWT.

Body (JSON)

ParâmetroTipoObrigatórioDescrição
emailstringSimEmail cadastrado
passwordstringSimSenha da conta
Exemplobash
curl -X POST https://api.pagniv.com/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "MinhaSenh@123"
  }'
Resposta 200JSON
{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "refreshToken": "eyJhbGciOiJIUzI1NiIs..."
  }
}

Renovar Token

POST
/v1/auth/refresh

Renova o access token usando o refresh token.

Body (JSON)

ParâmetroTipoObrigatórioDescrição
refreshTokenstringSimRefresh token recebido no login
Resposta 200JSON
{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs..."
  }
}

Logout

POST
/v1/auth/logout
Auth

Invalida o refresh token atual.

Resposta 200JSON
{
  "success": true,
  "data": {
    "message": "Logout realizado com sucesso"
  }
}