Online Campus: pagos fiables en una plataforma de aprendizaje
El backend del campus online de una escuela de negocios: venta de cursos, cuestionarios cronometrados y certificados que cualquiera puede verificar.
- Rol
- Ingeniero backend y DevOps
- Periodo
- abr 2026 a sept 2026
- Stack
- NestJS, Fastify, Prisma, Postgres, BullMQ, Paystack
- Problema
- Una escuela de negocios necesitaba vender cursos, hacer evaluaciones cronometradas y emitir certificados, con pagos que nunca matricularan dos veces ni se perdieran.
- Qué hice
- Construí el backend y gestioné su infraestructura, junto a un ingeniero frontend y un diseñador: procesamiento idempotente de pagos de Paystack con un job de conciliación, plazos de cuestionarios controlados por el servidor y certificados generados en una cola.
- Resultado
- En producción, con estudiantes de pago avanzando por lecciones y cuestionarios cronometrados, y certificados verificables listos para los primeros que terminen.

El sistema
Los estudiantes pagan, hacen evaluaciones cronometradas y reciben certificados, y cada una de esas cosas es una promesa. Un pago tiene que matricular exactamente una vez aunque el proveedor envíe el webhook dos veces o ninguna. El plazo de un cuestionario tiene que cumplirse aunque el navegador mienta sobre la hora.
Ingeniero backend y DevOps durante cinco meses, junto a un ingeniero frontend y un diseñador: 97 commits, 117 endpoints, 24 modelos y unos 350 tests.
- estudiantes
- 10+
- endpoints
- 117
- tests
- 350
Del pago al certificado. Pasa el cursor o toca un nodo para ver cada paso.
Procesar exactamente una vez
payment-fulfillment.service.ts (simplified)
await prisma.$transaction(async (tx) => { if (await tx.paymentEvent.findUnique({ where: { eventId } })) return; await tx.paymentEvent.create({ data: { eventId } }); await tx.enrollment.create({ data: { userId, courseId } });});// every 5 minutes: ask Paystack about anything still pending
Paystack notifica un cobro correcto.
Un webhook verificado solo encola un job. El worker procesa el pago dentro de una transacción que deduplica por el id de evento del proveedor y trata una violación de unicidad en la matrícula como algo ya hecho. Si un pago se completó pero no se puede procesar, se registra como pendiente de reembolso en lugar de descartarse en silencio.
Un cron de conciliación se ejecuta cada cinco minutos y consulta al proveedor por todo lo que siga pendiente, así que un webhook que nunca llega también acaba en una matrícula.
Plazos que controla el servidor
learn-quiz-session.service.ts (simplified)
const { count } = await tx.quizAttempt.updateMany({ where: { id, version, deadlineAt: { gt: new Date() } }, data: { answers, version: { increment: 1 } },});if (count === 0) throw new ConflictException();
Empezar un cuestionario guarda en el servidor las preguntas barajadas y un plazo.
Los intentos de cuestionario guardan su propio orden aleatorio de preguntas y un plazo en el servidor. Guardar una respuesta usa concurrencia optimista y devuelve un conflicto si el intento cambió en otra pestaña. Un job que corre cada minuto caduca los intentos abandonados, y al completarlos se actualiza el progreso del curso.
Certificados fuera del ciclo de la petición
Terminar un curso solo encola un job. La petición responde al instante.
Generar un PDF con headless Chrome es lento y consume mucha memoria, así que nunca ocurre dentro de una petición. Una cola dedicada genera, sube y envía por email cada certificado, y los administradores pueden reemitirlos o revocarlos. Un endpoint público permite a cualquiera verificar un certificado por su id.
Decisiones que defiendo
Proceso de worker separado
Chrome y las ráfagas de webhooks no pueden dejar sin recursos a la API, y el worker escala por su cuenta.
Paginación por offset en lugar de cursores
Los administradores saltan a la página N y ordenan por muchas columnas; los listados son lo bastante pequeños como para que el coste del offset no se note.
Circuit breaker respaldado por Redis
Cuando un proveedor está caído, todas las instancias dejan de llamarlo a la vez en lugar de descubrirlo cada una por separado.