Skip to content
Docs

Four Leak Types in Stripe Connect: A Mechanism Breakdown

Understand the four silent fee leak types in Stripe Connect. See the specific event signatures and recovery paths for each failure mode.

2 min read

The four silent fee leak types in Stripe Connect platforms are distinct failure modes with specific event signatures and recovery paths. FeeGuard is a Stripe Connect recovery engine that finds the money refunds and disputes leave behind on connected accounts, providing a controlled path to take it back.

The Four Failure Modes

Four Connect failure modes cost platforms money silently, and none throws an error or appears in logs:

  1. Transfer never reversed: A destination charge is refunded without reverse_transfer. Stripe refunds the buyer from your balance while the connected account keeps the transfer.
  2. Refund sent with the fee kept: A refund occurs without refund_application_fee. Your platform fee stays attached to revenue that no longer exists.
  3. Dispute fee never recovered: In a lost dispute, Stripe debits you in full, and the connected account that received the funds is untouched.
  4. FX rate gap at settlement: FX slippage compounds across cross-border payouts.

Event Signatures and Missing Parameters

Each finding names the exact Stripe event behind it, connecting the event, the missing Stripe parameter, and the amount still in reach. The relevant events include:

  • [charge](/docs/charge.refunded).refunded
  • application_fee.refunded
  • charge.dispute.closed
  • balance.available

These events identify the specific transactional context where the leak occurred, allowing for precise reconciliation without requiring access to live transaction data.

Security and Architecture

FeeGuard operates with zero impact on the payment flow; it observes, it does not sit in the path. Security measures include read-only access by default on standard Stripe scopes, AES-256-GCM per-tenant key encryption, and an append-only audit trail on every action.

Verification

You can verify if any of these leak types are present in your data through a free audit at feeguard.dev. Paste an export (refund and dispute events, or a Stripe list/CSV); no API key is required, nothing is connected, and it runs in under 90 seconds. Detection and the 90-day lookback are free. A clean result means every refund and dispute in what was pasted reconciled correctly. There is also a seven-step manual reconciliation checklist on the page a team can run themselves.

FeeGuard is an independent product and is not affiliated with, endorsed by, or sponsored by Stripe, Inc. "Stripe" and "Stripe Connect" are trademarks of Stripe, Inc., referenced descriptively.

Published by PostHat, FeeGuard’s content pipeline. Every factual claim is grounded in FeeGuard’s product documentation.