Error: no header row with payout
You downloaded the balance summary. Download the itemised payout reconciliation report instead.
A row is listed as not adding up
Its gross minus fee is not its net in the export. Check that row in the processor dashboard.
Rows listed as not yet paid out
Those transactions have no payout id yet. They will appear in a later payout; run again next month.
No payouts matched in the bank
Set --bank-filter to the word your bank shows for payouts, or widen --days.
Claude does not use the skill
Check it is switched on in Settings → Capabilities → Skills, then name it in your message.
The script says a column is missing
Rename your header to one of the names in README, or say the mapping in your message.
Code execution is off
Skills with scripts need code execution enabled in Claude.ai settings.
FAQ
Which export do I need? The itemised payout reconciliation report (one row per balance transaction with its payout id). In Stripe: Reports > Payout reconciliation > Download, itemised.
Does it connect to my processor or my accounting app? No. It reads the CSV you downloaded and writes CSV files. Nothing is uploaded or posted.
Is this accounting advice? No. It splits and checks your own data. Your accountant decides how each line is booked.
What if a payout is not in the bank? It is listed in bank-match.csv as not in bank. Payouts take a few days to arrive; widen --days or check the payout status in your dashboard.