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/registerCria uma nova conta de merchant. O merchant é criado com status PENDING e precisa ser aprovado por um admin.
Body (JSON)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
email | string | Sim | Email do merchant |
password | string | Sim | Senha (mín. 8 caracteres) |
companyName | string | Sim | Razão social |
cnpj | string | Sim | CNPJ (14 dígitos) |
phone | string | Sim | Telefone 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/loginAutentica um merchant e retorna tokens JWT.
Body (JSON)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
email | string | Sim | Email cadastrado |
password | string | Sim | Senha 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/refreshRenova o access token usando o refresh token.
Body (JSON)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
refreshToken | string | Sim | Refresh token recebido no login |
Resposta 200JSON
{
"success": true,
"data": {
"accessToken": "eyJhbGciOiJIUzI1NiIs..."
}
}Logout
POST
/v1/auth/logoutAuth
Invalida o refresh token atual.
Resposta 200JSON
{
"success": true,
"data": {
"message": "Logout realizado com sucesso"
}
}