Planes, Suscripciones y Pagos Wompi

El módulo de Facturación y Suscripciones (/billing) administra los límites operativos de cada empresa (plan-limits), periodos de prueba de 14 días, paquetes de créditos IA sin vencimiento, recursos adicionales mensuales (add-ons) y cobros locales seguros a través de Wompi Bancolombia (PSE, Nequi, Bancolombia y Tarjetas de Crédito/Débito).

Consulta Pública y Privada del Catálogo

Catálogo público (GET /public/pricing): devuelve los 5 planes oficiales (Gratuito, Básico, Profesional, Empresarial, Escala), ciclos mensual/anual, paquetes de créditos y recursos extra tanto en Pesos Colombianos (COP) como en Dólares (USD).
Resumen del tenant (GET /billing/summary): expone el plan activo de la organización, fecha de corte, uso real frente a los cupos contratados (usuarios, conexiones omnicanal, agentes IA, documentos RAG) y saldo de créditos.

Flujo de Checkout y Confirmación con Wompi

Generación de orden firmada (POST /billing/wompi/checkout)

Un administrador verificado envía el plan deseado, ciclo (monthly / yearly), paquetes de créditos o add-ons. El servidor calcula el importe autoritativo en backend, genera una referencia única idempotente y firma criptográficamente la integridad de la transacción para el widget de Wompi.
Pago seguro en Wompi

El usuario completa el pago con PSE, Nequi, Botón Bancolombia o tarjeta sin que datos sensibles de tarjeta toquen los servidores de Matias Impulso.
Confirmación por Webhook + Verificación Activa

Wompi notifica el resultado a POST /webhooks/wompi (con firma verificada). Adicionalmente, el cliente puede confirmar de inmediato el estado mediante POST /billing/wompi/verify o consultar el recibo con GET /billing/wompi/checkout/:reference.
Aprovisionamiento Transaccional Inmediato

Al aprobarse la transacción, se activan de forma atómica e idempotente los nuevos cupos del plan, los recursos extra y los créditos IA comprados, quedando registrado en GET /billing/wompi/payments.