I worked on a marketplace where a connected account went negative, Stripe suspended its payouts, and refunds silently queued as pending — no error, no alert, discovered via a customer complaint.
stripe-connect-reckon is a small read-only TypeScript library that watches connected accounts and reports issues with severity:
- NEGATIVE_BALANCE_RISK (per-currency)
- FAILED_PAYOUT
- UNRECONCILED_REFUND (vs. the state your app reports)
- EVENT_GAP (within Stripe's 30-day events window)
Design notes:
- Read-only by design: only calls list/retrieve endpoints, never writes. v0 takes no corrective action on purpose.
- Clean architecture: a pure core (no I/O, no stripe import) behind a thin read-only adapter, so detection is unit-tested with fixtures and zero network (47 tests).
- Not a sync engine — it works a level up: read, evaluate, report. Pinned to stripe-node v22 / API version 2026-06-24.dahlia. Dual ESM+CJS, MIT.
- It's v0.1.0 and honest about its limits (two detectors need your app's state; the event window is 30 days; it never remediates). I'd love feedback on what other read-only signals are worth catching.
npm: https://www.npmjs.com/package/stripe-connect-reckon
GitHub: https://github.com/tonytonycoder11/stripe-connect-reckon
Top comments (0)