SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-09
Browse: SET Merchant API

SET Merchant API · Statements & tax

A year's payouts for tax

GET/v1/tax/payouts

Key scope: read

Every payout made with POST /v1/payouts that was paid in the year, refunds to buyers left out, each with its verification and an exceptions list. The CSV's chain and tx columns feed an independent on-chain re-check.

Query parameters

year integerrequired
A calendar year, for example 2026.
customer string
Only this customer's objects (cus_…).
format "json" | "csv"
Default json.

Notes

  • verification: on_chain_confirmed, on_chain_pending, on_chain_mismatch, on_chain_failed, not_checked, bank_paid_per_bridge or sandbox_not_applicable.
  • Dates are UTC; USDC is valued at $1.00.

Errors

  • 400 year_invalid
  • 400 format_invalid
  • 400 customer_invalid
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.