Get Stripe disputes is a WordPress ability from WooCommerce Stripe Gateway — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Get Stripe disputes

Read-only
WooCommerce Stripe Gateway Ecommerce woocommerce-gateway-stripe/get-disputes

List Stripe disputes, optionally filtered by charge, payment intent, or date range.

Requires the WooCommerce Stripe Gateway plugin active on WordPress 6.9+ with WooCommerce 10.9 or later, since every ability registers through WooCommerce Core's AbilitiesLoader. Abilities are also gated behind the 'wc_stripe_abilities_enabled' filter, which defaults to off, and the current user needs the 'manage_woocommerce' capability.

What it does

This ability lists Stripe disputes via Stripe's disputes API. It accepts an optional limit (1-100, defaulting to 10), filters for a specific charge or payment_intent ID, a created date range (created_gte/created_lte), and Stripe's cursor pagination (starting_after/ending_before). Stripe's disputes endpoint doesn't support filtering by status server-side, so the source code notes that any status filtering has to happen after the list is returned. This gives an AI assistant a fast way to survey open or recent chargebacks tied to a particular payment.

See it in action

You ask your AI assistant

"List the most recent 10 Stripe disputes tied to payment intent pi_3PQxyz."

Inputs

Name Type Required Description
limit integer No Maximum number of disputes to return. Defaults to 10; Stripe caps at 100.
starting_after string No Stripe cursor — return disputes after this object ID.
ending_before string No Stripe cursor — return disputes before this object ID.
charge string No Filter to disputes associated with a specific charge (ch_xxx).
payment_intent string No Filter to disputes associated with a specific payment intent (pi_xxx).
created_gte integer No Filter to disputes created at or after this Unix timestamp.
created_lte integer No Filter to disputes created at or before this Unix timestamp.

Returns

A Stripe list of raw dispute objects matching the given filters; Stripe does not support server-side filtering by status.

Permission

The current user must have the 'manage_woocommerce' capability, checked via WC_Stripe_Abilities_Registrar::can_manage_woocommerce().

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.