Certificados

VeriFactu · Certificados

Gestión de certificados

VeriFactu requiere certificados X.509 emitidos por CAMs (Autoridades de Certificación) españolas.

Tipos de certificado compatibles

Tipo	Caso de uso	Emisor
FNMT Clase 2	Personas físicas	FNMT-RCM
DNIe	Ciudadanos españoles	DNIe
Camerfirma	Empresas	Camerfirma
Firmaprofesional	Profesionales	Firmaprofesional

Subir un certificado

POST /verifactu/v1/certificates
Content-Type: multipart/form-data

file: certificate.pfx
password: your_pfx_password

Almacenamiento de certificados

Kreyo almacena los certificados de forma segura:

• Cifrado en reposo — Cifrado AES-256
• Solo en memoria durante la firma — Nunca se escribe en disco sin cifrar
• Acceso controlado — Solo tu API key puede usar tus certificados

Usar certificados

Al enviar un registro, referencia tu certificado por su ID:

{
  "certificate_id": "cert_abc123",
  "invoice": { ... }
}

Renovación de certificados

1. Sube el nuevo certificado
2. Actualiza tus integraciones con el nuevo certificate_id
3. Los registros anteriores siguen siendo válidos (firmados con el certificado anterior)

Consideraciones de seguridad

• Usa contraseñas PFX robustas (12+ caracteres)
• Rota los certificados anualmente
• Revoca los certificados comprometidos de inmediato