🛡️

Shield

Full Stack Production Microservice

Overview

Shield is a full-stack dispute handling application that integrates with payment providers to receive dispute notifications, automatically collect relevant evidence, and submit structured response documents to contest chargebacks on behalf of the business.

The system reduces the manual effort involved in chargeback responses — evidence is collected automatically from order history, fulfillment records, and customer data, then surfaced in a WYSIWYG editor where teams can review and finalize documents before submission.

Dispute intake & chargeback response flow

Features

API for receiving operations requests from internal teams and payment provider webhooks
Asynchronous workers to collect evidence from order history, fulfillment records, and customer data
Internal UI to review collected evidence and submit final dispute documents
PDF generator and WYSIWYG editor for building structured chargeback response documents

Architecture

Part of a broader microservices ecosystem. Shield listens for dispute events from payment providers via webhooks and pulls evidence from other internal services to build response packages.

Frontend

Internal UI for operations teams to review auto-collected evidence, edit documents in a WYSIWYG editor, and submit final responses to payment providers.

API

Handles webhook ingestion from payment providers and requests from the frontend. Orchestrates evidence collection and document generation flows.

Workers

Inngest functions collect evidence asynchronously after a dispute is received — pulling from order, fulfillment, and customer records — with retry logic for reliability.

Database

MongoDB stores dispute records, collected evidence, document drafts, and submission history in a flexible document model suited to varied dispute data shapes.

Tech Stack

Frontend

Next.js React Tailwind CSS shadcn/ui Slate

Backend

TypeScript Bun Elysia.js Inngest MongoDB Docker GCP

← 💳 Nexus 🎯 Scope →