Catálogo de API

Inicio de sesión, registro, verificación de correo y recuperación de contraseña. Emite el Bearer Token.

Personal Access Tokens para integraciones sistema a sistema: crear, listar, renovar y revocar (90 días por defecto, máximo 365).

Catálogos de referencia: países, departamentos, ciudades, tipos de documento y de organización, y Términos y Condiciones vigentes.

Crear, listar, consultar, actualizar, enviar (DRAFT → SENT), cancelar y eliminar solicitudes, con su historial de estados. La empresa solo puede llevarlas a DRAFT, SENT o CANCELLED; los demás estados los asignan MATICERTS y el proceso de emisión.

Adjuntos de una solicitud en Base64 (PDF, imágenes o ZIP) y descarga mediante URL firmada.

Disparar la emisión, consultar su estado, descargar el certificado (URL firmada a un .zip con el .p12 y su PIN, o en Base64) y renovar por 1 año más los certificados Viafirma de 1 año.

Link de verificación de identidad (KYC), rechazo de una solicitud en curso y revocación de certificados emitidos.

Compra de certificados prepago: crear la orden, pagarla con WOMPI, consultar su estado y reintentar pagos pendientes.

Tarifas por volumen en COP (vigencia de 1 o 2 años) según tu tipo de usuario, con IVA incluido.

Cupo disponible de tu empresa para crear solicitudes (asignado más comprado).

Endpoints que reciben notificaciones push firmadas con HMAC-SHA256: alta, edición, rotación del secret e historial de entregas.

Certificados próximos a vencer o vencidos sin renovar y bandeja de notificaciones del usuario.

Datos de tu empresa y sus parámetros de configuración general.

Datos personales del usuario autenticado y tipos de usuario.

Consumo de certificados de tu empresa por año y por mes.

Encabezado (líneas, pie y logo) de los reportes PDF y Excel.