Reconcile Square bank deposits against payments and fees using the Payouts API

Steps

1. Call ListPayouts (GET /v2/payouts) for the location and date range to reconcile, using an access token with the PAYOUTS_READ OAuth scope.
2. For each payout, call ListPayoutEntries (GET /v2/payouts/{payout_id}/payout-entries) to retrieve the underlying line items.
3. Group entries by type (CHARGE, REFUND, FEE, DEPOSIT_FEE, PROCESSING_FEE) and sum gross_amount_money, fee_amount_money, and net_amount_money to reconcile against the bank deposit total.
4. For CHARGE and REFUND entries, follow the linked payment_id back to the Payments API when full transaction detail is needed beyond what the payout entry provides.
5. Re-check previously reconciled payouts, not just new ones, since a payout can transition from PAID to FAILED later if the bank reports a failure after the fact.