Skip to content

alexander-zuev/riposte

Repository files navigation

Riposte

License: AGPL v3 Status: Alpha Deploy to Cloudflare Workers CI

riposte.sh | Open-source AI agent that fights your Stripe disputes on autopilot

🚀 Getting started

Cloud — hosted setup at riposte.sh: connect Stripe, connect your data, done.

Self-hosted — run it on your own Cloudflare account. See Self-hosting below.

💸 Why

Chargebacks are revenue you fight to win back — hours per case, and most teams just eat the loss.

Managed services take ~30% of what they recover, on thin generic-payment-data evidence (looking at you Stripe Smart Disputes).

Riposte wins them back automatically, with your data, no cut. It reads what the customer actually did and received to answer the bank's only question: did they get what they paid for?

⚙️ How it works

Setup — once, guided by the agent in chat:

CONNECT     Stripe + your data source (MCP)
   ↓
SETUP       the agent reads your schema and drafts your dispute playbook
   ↓
REVIEW      dry-run on a real dispute, you approve
   ↓
GO LIVE     you're live

Runtime — then every new dispute is handled automatically:

   ┌──────────────┐
   │   WEBHOOK    │   Stripe reports a new dispute
   └──────┬───────┘
          ▼
   ┌──────────────┐
   │    ENRICH    │   pull the charge, customer, and prior refunds
   └──────┬───────┘
          ▼
   ┌──────────────┐  ◄─ your playbook + database (MCP)
   │   COLLECT    │   match the customer, pull their real usage since the charge
   └──────┬───────┘
          ▼
   ┌──────────────┐
   │   GENERATE   │   assemble a deterministic evidence PDF
   └──────┬───────┘
          ▼
   ┌──────────────┐
   │    SUBMIT    │   file with Stripe  ·  or approve first (HITL)
   └──────┬───────┘
          ▼
       won / lost  →  Slack + email

🛠️ Tech stack

Layer What
Frontend TanStack Start + React
Backend Cloudflare Workers, Workflows
Agent Agents SDK, Workers AI Gemma 4
Database PlanetScale Postgres
Integrations Stripe App + OAuth/webhooks/Disputes API, Slack, Email

🏠 Self-hosting

Configure your Cloudflare bindings and secrets, then wrangler deploy. Not turnkey yet — see docs/public.

🤝 Contributing

Ideas and contributions welcome — open an issue to start.

📚 Docs

docs/public is open. docs/private (product research, launch planning, specs, screenshots) is git-crypt-encrypted and not part of the public distribution.

⚖️ License

AGPLv3

About

AI agent that wins your Stripe disputes on autopilot

Topics

Resources

License

Stars

Watchers

Forks

Contributors