Chargebacks

Payment disputes by day and reason — how many chargebacks were opened, how many were fraud-classified, how much money was disputed, and the successful transactions they are measured against. Requires the read_reports scope; empty on stores that have not granted it.

11 fields — 5 dimensions, 6 metrics. Date clauses (SINCE, UNTIL, DURING) use day.

The live, authoritative list is always GET /v1/datasets — this page is regenerated from the same catalog, but the endpoint reflects exactly what is deployed.

Query it

FROM chargebacks
  SHOW chargebacks
  GROUP BY grain
  SINCE -30d

See Querying with SoloQL for the language.

This dataset is queryable through SoloQL; it has no record-retrieval endpoint.

Fields

Field	Type	Role	Description
grain	string	dimension	Which aggregation Shopify computed the row at. Only day_reason exists today — one row per day per chargeback reason.
chargeback_reason	string	dimension	Why the cardholder's bank opened the dispute — e.g. fraudulent, product_not_received, product_unacceptable. (none) marks the row carrying the day's successful-transaction count, which Shopify reports without a reason.
chargebacks	number	metric	Payment disputes opened by cardholders' banks. The numerator of the chargeback rate.
fraudulent_chargebacks	number	metric	Disputes the bank classified as fraudulent. The numerator of the fraudulent chargeback rate.
chargeback_amount	money	metric	Money disputed, in the store's currency.
successful_transactions	number	metric	Payments that went through. THE DENOMINATOR of both rates — and the field that makes this dataset exactly re-aggregable at any grain.
chargeback_rate	percent	metric	Share of successful payments that were disputed. Blank on a day with no payments — an unmeasured day, not a dispute-free one.
fraudulent_chargeback_rate	percent	metric	Share of successful payments disputed as fraudulent. Blank on a day with no payments.
store	string	dimension	The shop the record belongs to. Filter with WHERE store IN ('Shop name') or GROUP BY store.
store_id	string	dimension	The shop's raw identifier — what an export or the API reports. Same shops as Store, shown as ids.
store_domain	string	dimension	The shop's myshopify.com domain. Filter with WHERE store_domain = 'shop.myshopify.com'.