shopify-admin-partial-refund-pattern-detector

Detect suspicious partial refund patterns in Shopify orders via GraphQL.

174|18|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-partial-refund-pattern-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-admin-partial-refund-pattern-detector
Source: https://github.com/40RTY-ai/shopify-admin-skills/tree/main/skills/order-intelligence/shopify-admin-partial-refund-pattern-detector
Command: npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-partial-refund-pattern-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps Shopify merchants identify suspicious refund behavior by surfacing orders with multiple partial refunds or unusually high partial-refund-to-total ratios that may indicate fraud, repeat customer dissatisfaction, or a refund process gap.

Core Features & Use Cases

  • Flags multi-refund and high-ratio orders: Marks orders with at least a configurable minimum number of partial refunds and/or where refunded amount to order total exceeds a configurable ratio while excluding fully refunded cases.
  • Groups repeat-offender customers: Aggregates flagged results by customer to highlight customers with multiple flagged orders in the lookback window for deeper review.
  • Provides auditable outputs and guidance: Produces a CSV report including refund counts, ratios, and refund timestamps, while clearly stating that results are advisory (read-only, no mutations).

Quick Start

Use the shopify-admin-partial-refund-pattern-detector skill to analyze the last 90 days of partially refunded orders and output a human-readable report to partial_refund_patterns_<date>.csv for manual review.

Frequently Asked Questions about shopify-admin-partial-refund-pattern-detector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect suspicious partial refund patterns in Shopify orders?

To detect suspicious partial refund patterns in Shopify orders, you query historical order data via read-only GraphQL to flag orders with multiple partial refunds or high refund-to-total ratios. The analysis groups results by customer and outputs a CSV or JSON summary for administrative review.

What is a high partial-refund-to-total ratio in Shopify fraud detection?

A high partial-refund-to-total ratio in Shopify fraud detection is a configurable threshold rule that flags orders where the refunded amount compared to the order total exceeds a set percentage. This metric helps identify suspicious refund behavior while excluding fully refunded cases from the analysis.

Can I use Shopify GraphQL queries to audit repeat customer refund abuse?

Yes, you can use Shopify GraphQL queries to audit repeat customer refund abuse by executing a read-only orders query within a configurable lookback window. The results aggregate flagged orders by customer to highlight repeat-offender customers with multiple suspicious partial refunds.

How do I export Shopify refund analysis data to CSV for manual review?

You export Shopify refund analysis data to CSV for manual review by running a read-only GraphQL orders query that computes refund counts, ratios, and refund timestamps. The query generates an auditable CSV report file containing all flagged partial refund patterns for administrative workflows.

Does this Shopify refund analysis tool modify orders or issue refunds?

No, this Shopify refund analysis tool does not modify orders or issue refunds. It executes strictly read-only GraphQL queries to compute refund counts and ratios, producing advisory CSV or JSON outputs for fraud monitoring and refund process auditing without performing any data mutations.

What is the best way to monitor partial refunds for Shopify customer-support quality analysis?

The best way to monitor partial refunds for Shopify customer-support quality analysis is to configure a lookback window and apply threshold rules to read-only GraphQL order data. This flags unusual refund behavior and outputs a summary report highlighting process gaps or repeat customer dissatisfaction.