Stripe-connect-reckon – a read-only monitor for Stripe Connect balance risk

AS — Mon, 29 Jun 2026 02:23:37 +0000

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

DEV Community: AS

Stripe-connect-reckon – a read-only monitor for Stripe Connect balance risk