
- Problem
- The brand needed its own store instead of relying on marketplaces, with payments and stock that stay consistent under real traffic.
- Approach
- A Next.js front end and a separate Express / TypeScript API, both on Vercel, with Firestore and Firebase Auth. Mercado Pago Checkout Bricks keeps payment inside the site.
- Key decisions
- Signature-verified, idempotent webhooks: an order is fulfilled exactly once, whichever path confirms the payment first.
- Stock is reserved in a transaction for 30 minutes, and the payment link expires at the same moment.
- Underpaid payments are never fulfilled; PayPal was switched off because its sandbox mode allowed fake payments.
- Vitest + Testing Library, Sentry monitoring and transactional email via Resend.
- Outcome
- Live with catalog, accounts, admin and Mercado Pago checkout working end to end: payment inside the site, stock reservation and automatic order confirmation.



