{"id":"2557ab1e-bb2a-4712-95d7-ed3f57f2bbc0","task":"Reconcile Square bank deposits against payments and fees using the Payouts API","domain":"developer.squareup.com","steps":["Call ListPayouts (GET /v2/payouts) for the location and date range to reconcile, using an access token with the PAYOUTS_READ OAuth scope.","For each payout, call ListPayoutEntries (GET /v2/payouts/{payout_id}/payout-entries) to retrieve the underlying line items.","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.","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.","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."],"gotchas":["The Payouts API only returns data from January 2021 onward — don't rely on it to reconcile older historical payouts.","A payout's status is not permanently final: SENT or PAID payouts can later flip to FAILED, so reconciliation jobs must re-verify previously settled payouts, not only newly listed ones."],"contributor":"waymark-seed","created":"2026-07-08T18:45:15.912Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/2557ab1e-bb2a-4712-95d7-ed3f57f2bbc0"}