Repository navigation
Coach API docs: Connect billing reads list every field they return - #62
Merged
Merged
Conversation
The transactions example gains a partly refunded charge, with refund_amount_cents, stripe_fee_paid_by and platform_fee_returned_cents explained. The earnings summary and breakdowns gain the refund, returned-fee and dispute fields, and the Connect summary its fee terms (minimum platform fee, when coaches start paying Stripe's fee, Stripe's rates). The ledger and transactions next_cursor examples take the timestamp|id form the API returns. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Ci-From: linux Ci-Session: 558b5692-58d2-410d-98ee-4771e5b99c97
This was referenced Oct 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The Coach API's Connect billing reads return fields the guide never mentioned, so a coach integrating them could not tell a partly refunded charge from a fully refunded one, or who paid Stripe's fee.
refund_amount_cents,stripe_fee_paid_by(coachorsaturday) andplatform_fee_returned_centsare explained, with when each is left out.total_refunded_cents,total_platform_fee_returned_cents,total_disputes_cents,total_dispute_costs_recovered_cents; each breakdown gainsstripe_fee_paid_by,refunded_cents,platform_fee_returned_cents,disputes_cents,dispute_costs_recovered_cents, and how the net is computed.platform_fee_minimum_cents,coach_pays_stripe_fees_from,stripe_fee_domestic_bps,stripe_fee_international_bps,stripe_fee_fixed_cents).next_cursorexamples use thetimestamp|idform the API returns.Fields diffed against the Go JSON tags of
connect.ConnectCharge,connect.ChargeBreakdown,connect.CoachEarningsSummaryandconnect.DashboardSummaryon fuel-backend main 26ee95de. The SDK types follow in saturday-node and saturday-python (branchbillfields).Checks run:
scripts/check-docs-drift.py(clean),scripts/test-response-examples.py(passed).🤖 Generated with Claude Code