Processo de Homologação

Antes de operar em produção, todo originador passa por um processo de homologação no ambiente de staging para validar a integração completa com a API do GTPayroll.

---

Como funciona

Durante a homologação, a equipe de integração da Giro.Tech fornece CPFs de teste que simulam diferentes cenários do fluxo de originação. Esses CPFs permitem validar o comportamento da sua integração em situações reais — desde o cadastro do employee até a averbação do contrato.

Os CPFs de teste só funcionam no ambiente de homologação (https://consignado.staging.giro.tech). Não utilize esses CPFs em produção.

---

CPFs de teste

A equipe de integração fornecerá CPFs específicos para cada cenário abaixo:

Cenário	Comportamento esperado	Finalidade
CPF com margem	Autorização aprovada, margem disponível, fluxo completo até averbação	Validar o fluxo de originação completo (happy path)
CPF sem margem	Autorização aprovada, margem retorna zerada ou indisponível	Validar tratamento quando o trabalhador não possui margem consignável
CPF não elegível	Autorização rejeitada ou trabalhador não encontrado no Dataprev	Validar tratamento de rejeição e erros de elegibilidade

Os CPFs de teste são fornecidos pela equipe de integração durante o onboarding. Não utilize CPFs reais no ambiente de homologação.

---

Etapas da homologação

1. Configuração inicial

• Receber o token JWT de homologação

• Configurar a URL base do ambiente de staging

• Receber os CPFs de teste

2. Validação do fluxo completo (CPF com margem)

Executar o fluxo de originação completo com o CPF que possui margem:

Criar Employee → Enviar Autorização → Consultar Margem → Criar Simulação → Criar Proposta → Criar Contrato

Passo	O que validar
Criar Employee	Retorno 201, publicId gerado
Enviar Autorização	Retorno 202, link de assinatura enviado
Consultar Status	Polling até autorização concluída
Consultar Margem	Retorno 200 com margem disponível
Criar Simulação	Retorno 201 com cálculos financeiros
Criar Proposta	Retorno 201 com dados consolidados
Criar Contrato	Retorno 201, link de assinatura da CCB

3. Validação de cenários de erro

CPF sem margem

1. Criar Employee com o CPF sem margem

2. Enviar Autorização e aguardar conclusão

3. Consultar Margem — deve retornar margem zerada/indisponível

4. Validar que sua aplicação trata corretamente a ausência de margem

CPF não elegível

1. Criar Employee com o CPF não elegível

2. Enviar Autorização — deve retornar rejeição ou erro de elegibilidade

3. Validar que sua aplicação trata corretamente a rejeição

4. Validação de endpoints auxiliares

• Consultar Limites de Empréstimo e validar parâmetros

• Consultar Bancos disponíveis

• Testar Reenvio de link de assinatura

• Testar Cancelamento de contrato

5. Validação da integração embedded (se aplicável)

Se a integração utilizar o widget embedded:

• Validar renderização do widget no iframe/WebView

• Validar recebimento dos eventos (gt:ready, gt:flow_complete, gt:flow_error)

• Validar handler de gt:open_url para assinatura digital

• Testar nos dispositivos/navegadores alvo

---

Checklist de homologação

Use este checklist para garantir que todos os cenários foram validados:

• Token JWT configurado e funcionando

• Fluxo completo com CPF com margem (happy path)

• Tratamento de CPF sem margem

• Tratamento de CPF não elegível

• Consulta de limites de empréstimo

• Consulta de bancos

• Reenvio de link de assinatura

• Cancelamento de contrato

• Integração embedded validada (se aplicável)

• Tratamento de erros HTTP (401, 403, 404, 409)

---

Aprovação e go-live

Após concluir todas as validações, entre em contato com a equipe de integração para:

1. Revisão conjunta dos testes realizados

2. Recebimento do token JWT de produção

3. Liberação do domínio de produção (se necessário)

4. Ativação do originador no ambiente de produção

Após a aprovação, você receberá as credenciais de produção e poderá iniciar operações reais com trabalhadores.

Central de Atendimento | Giro.TechGiro.Tech