Koumail
A monthly merchandise box for Kouman’s fans, built for 200,000 of them in one night
Koumail is a monthly subscription box for fans of Kouman (youtube.com/@Kouman), one of the biggest Persian YouTube channels. Fans sign up, pay before a monthly deadline, and a box of Kouman merchandise ships to them each month. Fantazio makes the merchandise, and I built the platform.
The subscription page on a phone
Image coming soon
Fantazio is Kouman's official merchandise partner: t-shirts, hoodies, mugs, banners, all of it. When their team wanted a monthly subscription box, I was honoured to build it. I had seen other people build platforms for them, and the problem was always the same: if you don't know how printing, packing and shipping work, you can't write software that works for them. So I built it myself, to follow the way we already work and give the fans a better experience.
A monthly box
Image coming soon
A fan picks a plan on their phone and pays before the monthly deadline, and that month's box is theirs. Most fans pay right before the cutoff. One Kouman merchandise drop in the summer of 2025 brought 200,000 fans in a single night, so Koumail is built for a night like that. Reminders go out seven, three and one day before the deadline, and if one payment gateway starts failing, payments move to another. After the cutoff, the packing line gets its list and the boxes go out.
Payment night: the live numbers
Image coming soon
The payment rush and the packing line had to hold up together. A fan is never charged twice and never loses a month they paid for. Every payment is checked to the exact amount and recorded in the same step that gives them the box.
The payments dashboard
Image coming soon
It is ready, and waiting on infrastructure before it launches.
The packing line on a drop night
Image coming soon
The load test before launch
Image coming soon
Under the hood
A Go API and worker, a PostgreSQL double-entry ledger, a transactional outbox for SMS and Telegram, health-scored routing across payment gateways, and load tests for the deadline-night rush.
Integrations
- Shaparak PSPs
- Kavenegar
- Telegram Bot API
- Redis
- PostgreSQL
- Docker / GHCR
- GitHub Actions
- Prometheus / Grafana
- k6