Certificados Digitais A1

A emissão direta com os órgãos públicos exige a assinatura com certificado digital ICP-Brasil padrão A1 (PKCS#12 / .pfx) da empresa emissora.

---

POST Upload de Certificado A1

Cadastra ou atualiza o certificado digital A1 para a conta autenticada.

POST /v1/certificates

SEGURANÇA MÁXIMA

Os certificados são criptografados em repouso no banco de dados utilizando AES-256-GCM com chave mestra de segurança derivada. A senha é utilizada exclusivamente em memória durante o processo de assinatura XML ou handshake mTLS.

Requisição

Envie como multipart/form-data ou payload em JSON codificado em Base64:

cURL (Base64)

curl --request POST \
  --url http://localhost:3333/v1/certificates \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: fylee_live_...' \
  --data '{
    "pfxBase64": "MIIK9wIBAzCCC78GCSqGSIb3DQEHAaCCC7AEggusMII...",
    "password": "SenhaDoCertificado123"
  }'

Exemplo de Resposta (201 Created)

{
  "id": "cert_9812481023",
  "cnpj": "11222333000181",
  "razaoSocial": "EMPRESA EXEMPLO LTDA",
  "validoDe": "2026-01-15T00:00:00.000Z",
  "validoAte": "2027-01-15T23:59:59.000Z",
  "diasRestantes": 100,
  "status": "ATIVO"
}

---

GET Consultar Status do Certificado

Verifica a data de expiração, dados do titular e dias restantes de validade.

GET /v1/certificates/status

cURL

curl --request GET \
  --url http://localhost:3333/v1/certificates/status \
  --header 'x-api-key: fylee_live_...'

Exemplo de Resposta (200 OK)

{
  "hasCertificate": true,
  "cnpj": "11222333000181",
  "validoAte": "2027-01-15T23:59:59.000Z",
  "diasRestantes": 100,
  "expirado": false
}