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.
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
Criada: 4 de abril de 2022