Ambientes e Autenticação

Ambientes disponíveis

O GTPayroll disponibiliza dois ambientes para integração:

Ambiente	URL Base	Finalidade
Homologação	https://consignado.staging.giro.tech	Testes e validação da integração
Produção	https://consignado.giro.tech	Operações reais

Utilize sempre o ambiente de homologação durante o desenvolvimento e testes. O ambiente de produção deve ser utilizado apenas após validação completa do fluxo.

---

Autenticação

A API utiliza JWT (JSON Web Token) para autenticação. O token é fornecido pela equipe de integração durante o onboarding do originador.

Como obter o token

1. Entre em contato com a equipe de integração da Giro.Tech

2. Informe os dados do originador (CNPJ, razão social, contato técnico)

3. O token JWT será gerado e entregue de forma segura

Utilizando o token

Inclua o token no header Authorization de todas as requisições:

cURL

curl -X GET 'https://consignado.staging.giro.tech/api/v1/originator/employees' \
  -H 'Authorization: Bearer {{seu_token_jwt}}' \
  -H 'Content-Type: application/json'

JavaScript

Python

---

Headers obrigatórios

Header	Valor	Descrição
Authorization	Bearer {token}	Token JWT de autenticação
Content-Type	application/json	Formato do corpo da requisição (para POST/PUT)

---

Códigos de resposta comuns

Código	Significado	Quando ocorre
200	Sucesso	Requisição processada com sucesso
201	Criado	Recurso criado com sucesso (POST)
202	Aceito	Processamento assíncrono iniciado
204	Sem conteúdo	Operação realizada sem corpo de resposta
400	Requisição inválida	Dados de entrada inválidos ou incompletos
401	Não autenticado	Token ausente, inválido ou expirado
403	Sem permissão	Token válido mas sem permissão para o recurso
404	Não encontrado	Recurso inexistente
409	Conflito	Operação não permitida no estado atual do recurso

Quando o token expirar, será necessário solicitar um novo token à equipe de integração. Tokens expirados retornam 401 Unauthorized.

---

Restrição de IPs

Se necessário, a Giro.Tech pode configurar restrição de IP (allowlist) para acesso ao ambiente de produção. Solicite à equipe de integração caso sua política de segurança exija essa configuração.

Central de Atendimento | Giro.TechGiro.Tech