Ir para o conteúdo

Atualização da Cadeia de Certificado 2026

Informamos que no dia 5 de março de 2026, durante o horário comercial, haverá atualização do certificado da URL https://gateway.apiserpro.serpro.gov.br.

A partir dessa data, o Serpro contará com uma nova cadeia de certificado, sendo a raiz emitida por Autoridade Certificadora reconhecida mundialmente e a cadeia intermediária emitida pelo Serpro, aumentando a confiança nos serviços oferecidos.

Por que não disponibilizamos um passo a passo?

Devido à grande variedade de tecnologias, implementações e ambientes, cada um com sua forma particular de tratar questões relacionadas ao estabelecimento de conexões SSL/TLS, é inviável para o Serpro dar suporte individualizado aos clientes que porventura encontrem dificuldades ao acessar as APIs expostas com a nova cadeia de certificados.

Todavia, trata-se de assunto comum no meio técnico ligado á tecnologia da informação. Por isso, é extremamente importante que essa informação chegue até sua equipe Técnica.

O que fazer ?

Para evitar qualquer indisponibilidade, é necessário que seja realizada a configuração em seus sistemas, para que eles passem também a aceitar essa nova cadeia de certificado.

Isso será necessário para todas as suas aplicações que consomem serviços por esta URL (https://gateway.apiserpro.serpro.gov.br).

Destacamos que o Serpro passará a atuar com a nova cadeia durante o dia 05/03/2026, porém, já é possível que seja realizada a configuração nos sistemas de vocês desde agora. Inclusive, recomendamos que não deixem para o dia 05/03.

Clique nos botões a seguir e baixe a nova cadeia de certificado, configurando posteriormente seus sistemas para que seja aceita essa nova a cadeia de certificado.

Autoridade Raiz

Autoridade Intermediária

Como sugestão, os sistemas clientes das APIs do Serpro podem validar o acesso com a nova cadeia de certificados, ao desenvolver uma aplicação simples de testes, utilizando a mesma tecnologia e ambiente produtivo do sistema principal, inclusive podendo até ser um módulo de testes do sistema principal.

Nesta aplicação/módulo de testes, deve-se estabelecer uma conexão HTTP/TLS com o endereço https://gateway-val.apiserpro.serpro.gov.br. Esta url responde aos mesmos serviços da url de produção, como a geração de token de acesso e consumo de apis.

Caso a aplicação de testes retorne erros de certificado, então a equipe de desenvolvimento/operações deve incluir o certificado da autoridade certificadora GlobalSign (arquivo .crt disponíveis Aqui (Autoridade Raiz)) e/ou Aqui (Autoridade Intermediária)) como "confiáveis" em sua infraestrutura e repetir o teste.

Atenção

Para evitar qualquer risco de indisponibilidade, recomendamos que todas as aplicações que acessam a URL (https://gateway.apiserpro.serpro.gov.br) sejam configuradas para aceitarem/confiarem em ambas as cadeias de certificado, ou seja, a atual e a que será utilizada a partir de 05/03/26.

Dia 05/03 serviço indisponível. E agora?

Caso tenha realizado todas as configurações, testado nos ambientes disponibilizados e mesmo assim no dia 05/03/2026 o serviço estiver indisponível, orientamos que:

  • Acesse o formulário web de suporte do PRODUTO no menu ao lado (Produtos => Suporte => Nome do Produto), selecione a oferta de Indisponibilidade e cite a ocorrência após atualização da cadeia de certificado.

Nota

Crie uma solicitação por produto.

Produtos Impactados

  • ANTECIPAGOV
  • AVISA BR
  • BIOVALID
  • CARTÓRIO DATA
  • CONSULTA CCIR
  • CONSULTA CND
  • CONSULTA CNPJ
  • CONSULTA CPF
  • CONSULTA DÍVIDA ATIVA
  • CONSULTA DUE
  • CONSULTA FATURAMENTO
  • CONSULTA NFE
  • CONSULTA ONLINE SENATRAN
  • CONSULTA DE PRÁTICAS AGROPECUÁRIAS SUSTENTÁVEIS
  • CONSULTA RAIZ TECH
  • CONSULTA RENDA
  • CONSULTA RESTITUIÇÃO IRPF
  • DATAVALID
  • INTEGRA COMEX
  • INTEGRA CONTADOR
  • INTEGRA LOJA FRANCA
  • INTEGRA SIAFI
  • NOTIFICA BR
  • SISGCS
  • VIO

Última atualização: 27 de janeiro de 2026
Criada: 4 de abril de 2022