chargeback-management-prevention
Prevent and manage chargebacks with fraud scoring, compelling evidence automation, Visa CE 3.0 / Mastercom integration, and win-rate optimization
Best use case
chargeback-management-prevention is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Prevent and manage chargebacks with fraud scoring, compelling evidence automation, Visa CE 3.0 / Mastercom integration, and win-rate optimization
Teams using chargeback-management-prevention should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/chargeback-management-prevention/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How chargeback-management-prevention Compares
| Feature / Agent | chargeback-management-prevention | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Prevent and manage chargebacks with fraud scoring, compelling evidence automation, Visa CE 3.0 / Mastercom integration, and win-rate optimization
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Chargeback Management and Prevention ## Overview A chargeback occurs when a cardholder disputes a transaction with their bank, forcing a reversal of funds and levying a fee ($15–$100 per dispute) on the merchant. A chargeback ratio above 1% (Visa) or 1.5% (Mastercard) triggers the card network's dispute monitoring programs, which can result in monthly fines and ultimately account termination. Effective chargeback management has two tracks: (1) preventing disputes with fraud scoring and clear communication, and (2) winning more disputes by submitting complete evidence within the response window. Most platforms now integrate directly with Stripe or PayPal for dispute management, making automated evidence submission accessible to all merchants. ## When to Use This Skill - When chargeback ratio is approaching 0.65% (the early-warning level Visa monitors before the 1% threshold) - When your team is manually compiling evidence packages and missing response deadlines - When processing international transactions with higher dispute rates - When your dispute win rate is below 40% and you need to understand why - When friendly fraud (customers who received goods but dispute anyway) is a significant problem ## Core Instructions ### Step 1: Determine your platform and dispute management approach | Platform | How Disputes Are Handled | Recommended Tool | |----------|------------------------|-----------------| | **Shopify Payments** | Disputes managed in Shopify Admin → Payments → Disputes | Shopify's built-in dispute response + Chargebacks911 or Kount for high volume | | **Shopify + Stripe** | Disputes appear in Stripe Dashboard + Shopify Admin | Stripe Radar for prevention; Stripe's dispute workflow for response | | **WooCommerce + Stripe** | Disputes in Stripe Dashboard; no WooCommerce-native interface | Stripe Radar for fraud scoring; Stripe Dashboard for dispute response | | **WooCommerce + PayPal** | Disputes in PayPal Resolution Center | PayPal Seller Protection + manual evidence submission in Resolution Center | | **BigCommerce** | Depends on payment gateway; Stripe and PayPal most common | Same as WooCommerce equivalent above | | **Custom / Headless** | Stripe Radar + Stripe dispute webhooks for automation | Build automated evidence collection triggered by `charge.dispute.created` webhook | ### Step 2: Set up fraud prevention (before chargebacks happen) The most cost-effective chargeback strategy is prevention. #### Shopify 1. **Enable Shopify Fraud Analysis**: Go to **Settings → Payments → Fraud prevention**. Shopify automatically analyzes orders and flags high-risk ones with indicators (billing/shipping address mismatch, CVV failure, AVS mismatch). 2. **Act on fraud indicators**: For orders with multiple red flags, go to **Orders → [Order] → Fraud analysis** and review the risk factors before fulfilling. Cancel and refund orders with a "High" risk level before they ship. 3. **Enable Shopify Protect** (if on Shopify Payments): This is Shopify's built-in chargeback protection for fraudulent orders. Eligible orders are automatically covered — Shopify pays the chargeback amount and fee. Go to **Settings → Payments** to verify Protect is active on your account. 4. **Install Signifyd or NoFraud**: For higher-volume stores, install **Signifyd** or **NoFraud** from the Shopify App Store. These provide chargeback guarantees — if a fraud dispute occurs on an order they approved, they pay the chargeback. #### WooCommerce 1. **Enable Stripe Radar**: In the Stripe Dashboard, go to **Radar → Rules** and configure fraud rules. Stripe Radar evaluates every transaction and blocks high-risk ones. 2. **Add Stripe Radar rules** for your risk profile: - Block payments where the billing zip code does not match - Require 3D Secure for transactions above $500 - Block prepaid cards for digital goods (high fraud category) 3. **Enable AVS and CVV checks**: In **Stripe Dashboard → Settings → Radar** enable AVS and CVC checks. Go to **WooCommerce → Settings → Payments → Stripe** and enable the "Require a valid postal code from the customer" option. #### BigCommerce 1. Go to **Store Setup → Payment Methods** and enable your gateway's fraud filters 2. For Stripe: configure Radar rules in the Stripe Dashboard (same as WooCommerce above) 3. For PayPal: enable **PayPal Seller Protection** requirements — require signature confirmation for orders over $250 ### Step 3: Respond to disputes effectively #### Shopify Payments 1. Go to **Settings → Payments → Disputes** — all open disputes appear here with response deadlines 2. Click on a dispute to see the reason code and deadline (typically 7–21 days from the dispute date) 3. Click **Submit evidence** and fill in: - Tracking number and carrier confirmation of delivery - Customer's IP address and billing address at time of purchase - Email communications with the customer about the order - Your refund policy (link to the policy page) - For digital goods: proof of delivery and usage logs 4. Submit before the deadline — Shopify notifies you via email when a new dispute is created **Shopify makes this straightforward**: it pre-fills much of the evidence from the order data (shipping address, IP, order details). #### Stripe Dashboard (WooCommerce, BigCommerce, Custom) 1. Go to **Stripe Dashboard → Disputes** — all open disputes with deadlines are listed 2. Click on a dispute to open the evidence submission form 3. Stripe's form has specific fields for each evidence type: - **Shipping documentation**: paste the tracking number and carrier - **Customer communication**: paste email correspondence - **Refund policy**: paste your policy text or URL - **Service documentation**: describe what was delivered and when 4. Under **Uncategorized text**, add a narrative summary: "Customer placed order on [date], order shipped [date] via [carrier], tracking [number], delivered [date]" 5. Click **Submit evidence** — Stripe sends the package to the card network **Key rule**: respond to every dispute, even low-value ones. Accepting a $10 chargeback still counts against your dispute ratio. #### PayPal Resolution Center (WooCommerce, BigCommerce) 1. Log in to your PayPal Business account and go to **Resolution Center → Cases** 2. Click on the open case and select **Respond** 3. For "Item Not Received" disputes: provide the tracking number and delivery confirmation 4. For "Unauthorized Transaction" disputes: provide proof of shipment, IP address, and any communication with the customer 5. Submit by the deadline shown on the case ### Step 4: Use Visa CE 3.0 for friendly fraud Visa Compelling Evidence 3.0 (CE 3.0) is a powerful tool for disputing friendly fraud (customer received goods but claims they did not authorize the purchase). If the customer has 2 prior non-disputed transactions on the same card in the past 120 days, you can submit these as evidence to shift liability to the issuer. In **Stripe Dashboard**: when submitting evidence for a Visa fraud dispute, scroll to the **Prior undisputed transactions** section and add the charge IDs of 2 prior non-disputed purchases by the same customer. Stripe will format and submit this as CE 3.0 evidence. ### Step 5: Monitor your dispute ratio Set a calendar reminder to check your dispute ratio monthly. Both Stripe and Shopify Payments provide this data: - **Stripe**: Go to **Dashboard → Radar → Disputes** and filter by month. Count disputes / total transactions = dispute ratio - **Shopify Payments**: Go to **Settings → Payments → Disputes** and review the monthly summary **Alert thresholds:** - 0.65%: Warning level — review your fraud prevention rules - 0.90%: Critical level — Visa's early intervention program; contact your payment processor - 1.00%: Visa monitoring program enrollment — monthly fines begin ## Best Practices - **Respond to every dispute** — even $5–$20 disputes count against your ratio; only accept (concede) a dispute if the win probability is near zero - **Collect evidence at order creation**, not when the dispute arrives — delivery confirmations, IP addresses, and device data are harder to obtain 60 days later - **Use Shopify Protect or Signifyd** if on Shopify — chargeback guarantees remove the financial risk entirely for covered orders - **Set response deadline reminders at T-5 days** — the response window is non-negotiable; build calendar reminders for all open disputes - **Block repeat disputers** — customers with 2+ chargebacks in 12 months should be flagged; Stripe Radar allows you to create a block rule for email addresses with prior disputes ## Common Pitfalls | Problem | Solution | |---------|----------| | Missing the response deadline | Stripe and Shopify both send email alerts when a dispute is created; ensure alerts go to a monitored inbox, not a noreply@ address | | Evidence submitted but dispute still lost | Evidence must be factual and specific — vague statements lose; tracking numbers, delivery scans, and customer emails win | | High friendly fraud rate | Implement Visa CE 3.0 using prior transaction evidence; add an explicit refund policy acceptance checkbox at checkout | | Dispute ratio counted differently by processor and card network | Visa counts chargebacks-to-transactions in the same calendar month; use the same calculation window for your monitoring | | PayPal disputes not visible until escalated | Check PayPal Resolution Center daily, not just your email; disputes start as "Inquiries" before becoming "Disputes" | | Shopify Protect not covering all orders | Protect has eligibility requirements (card-present equivalent signals); review the Protect coverage report to see which order types qualify | ## Related Skills - @stripe-integration - @payment-reconciliation-automation - @fraud-detection - @order-processing-pipeline
Related Skills
coupon-management
Build a coupon system with percentage and fixed discounts, usage limits per customer, expiration dates, and bulk unique-code generation
payout-split-management
Manage complex payout splits for marketplaces and platforms with seller disbursements, commission calculation, tax withholding, and 1099 reporting
currency-hedging-management
Manage foreign exchange risk for multi-currency ecommerce with FX rate tracking, hedging strategies, and realized/unrealized gain-loss accounting
ugc-campaign-management
Source, curate, and display user-generated content at scale with rights management, brand safety moderation, and trust-building social proof galleries
product-information-management
Centralize product data in a PIM system like Akeneo or Salsify and syndicate enriched content to all your sales channels automatically
returns-management
Process returns end to end — generate prepaid labels, apply refund or exchange logic, update inventory, and notify customers automatically
vendor-management
Manage supplier relationships with a portal for purchase orders, dropship routing, delivery tracking, and vendor performance scorecards
order-management-system
Design an order management system that routes orders to the right warehouse, handles split shipments, and manages backorders gracefully
accounts-payable-management
Manage supplier invoices and vendor payments with automated receipt matching, payment scheduling, early discount optimization, and reconciliation workflows
wishlist-save-for-later
Let shoppers save products to a wishlist, share it with friends, and get notified when saved items come back in stock or drop in price
storefront-theming
Build a themeable storefront with design tokens and CSS custom properties that supports white-labeling, multi-brand variants, and dark mode
search-autocomplete
Speed up product discovery with instant search suggestions, fuzzy typo matching, and category-aware results powered by Algolia or Elasticsearch