Skip to Content
ExamplesReconcile Stripe payouts

πŸ’³ Reconcile Stripe payouts and flag anomalies

Stack β€” Trigger: schedule (interval) Β· Models: your choice Β· Tools: stripe (npm SDK), ledger/query API Β· Mode: single agent + constraints Β· Output: Slack exceptions report

Who it’s for β€” finance ops who reconcile Stripe against the ledger by hand every morning. What it does β€” each day it pulls Stripe payouts and charges, matches them against your internal ledger, and posts only the exceptions β€” mismatched amounts, missing entries, unexpected refunds β€” so a human looks at the 3 that matter, not the 3,000 that reconcile fine.

Build it

  1. Add Stripe as tools. Add the stripe npm package as an SDK tool (Tools β†’ Create β†’ SDK β†’ stripe β†’ Discover) β€” you get typed tools for payouts, charges, and refunds without writing wrappers.
  2. Connect your ledger via Connect API (a read-only query endpoint over your accounting DB).
  3. Store the Stripe key in the Credentials vault; the SDK tool reads it at run time β€” never in a prompt.
  4. Create the agent with: pull yesterday’s payouts and charges, match to the ledger by amount and reference, and report only unmatched or anomalous items.
  5. Constrain it β€” read-only; never issue or modify a charge or refund β€” reconciliation observes, it doesn’t act.
  6. Schedule it daily and publish the exceptions report to #finance on Slack.

Make it yours

  • Let it propose a correcting ledger entry and route it through request_approval β€” proposal, not execution.
  • Add a second-vendor verify pass on flagged anomalies to cut false positives.
  • Swap Stripe for Adyen or Braintree β€” connect their API the same way.

Uses β€” Finance Β· Stripe Β· Scheduled Β· Constraints