Online Campus: betrouwbare betalingen op een leerplatform
De backend voor de online campus van een business school: cursusverkoop, getimede quizzen en certificaten die iedereen kan verifiëren.
- Rol
- Backend- en DevOps-engineer
- Periode
- apr 2026 tot sep 2026
- Status
- Live op ebschool.org
- Stack
- NestJS, Fastify, Prisma, Postgres, BullMQ, Paystack
- Probleem
- Een business school moest cursussen verkopen, getimede toetsen afnemen en certificaten uitgeven, met betalingen die nooit tot een dubbele inschrijving leiden of zoekraken.
- Wat ik deed
- Bouwde de backend en beheerde de infrastructuur, samen met een frontend engineer en een designer: idempotente Paystack-afhandeling met een reconciliatiejob, quizdeadlines die de server bewaakt, en certificaten die via een queue worden gerenderd.
- Resultaat
- Live, met betalende studenten die lessen en getimede quizzen doorlopen, en verifieerbare certificaten klaar voor de eerste afgeronde cursussen.

Het systeem
Studenten betalen, maken getimede toetsen en ontvangen certificaten, en elk daarvan is een belofte. Een betaling moet precies één keer tot een inschrijving leiden, ook als de provider de webhook twee keer of helemaal niet stuurt. Een quizdeadline moet standhouden, ook als de browser over de tijd liegt.
Backend- en DevOps-engineer gedurende vijf maanden, samen met een frontend engineer en een designer: 97 commits, 117 endpoints, 24 modellen en ongeveer 350 tests.
- studenten
- 10+
- endpoints
- 117
- tests
- 350
Van betaling tot certificaat. Hover of tik op een node om elke stap te zien.
Precies één keer afhandelen
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 meldt een geslaagde betaling.
Een geverifieerde webhook zet alleen een job in de queue. De worker handelt af binnen een transactie die dedupliceert op het event-id van de provider en een unique violation op de inschrijving behandelt als al afgehandeld. Als een betaling is gelukt maar niet kan worden afgehandeld, wordt die gelogd als terug te betalen in plaats van stilletjes te verdwijnen.
Een reconciliatiecron draait elke vijf minuten en vraagt de provider naar alles wat nog openstaat, zodat een webhook die nooit aankomt toch eindigt in een inschrijving.
Deadlines die de server bewaakt
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();
Een quiz starten slaat de geschudde vragen en een deadline op de server op.
Quizpogingen slaan hun eigen geschudde vraagvolgorde en een deadline op de server op. Een antwoord opslaan gebruikt optimistic concurrency en geeft een conflict terug als de poging in een andere tab is gewijzigd. Een job die elke minuut draait laat verlaten pogingen verlopen, en afronding telt mee voor de voortgang in de cursus.
Certificaten buiten het request-pad
Een cursus afronden zet alleen een job in de queue. Het request keert direct terug.
Een pdf renderen in headless Chrome is traag en vraagt veel geheugen, dus gebeurt het nooit in een request. Een eigen queue rendert, uploadt en mailt elk certificaat, en admins kunnen certificaten opnieuw uitgeven of intrekken. Via een publiek endpoint kan iedereen een certificaat verifiëren op basis van het id.
Keuzes die ik kan verdedigen
Apart workerproces
Chrome en pieken in webhooks kunnen de API niet uithongeren, en de worker schaalt zelfstandig.
Offset-paginering in plaats van cursors
Admins springen naar pagina N en sorteren op veel kolommen; de lijsten zijn zo klein dat de kosten van offset nooit merkbaar worden.
Circuit breaker op basis van Redis
Als een provider plat ligt, stoppen alle instances er tegelijk mee in plaats van dat elk het afzonderlijk ontdekt.