skills/payments-checkout/chargeback-management-prevention/SKILL.md
Prevent and manage chargebacks with fraud scoring, compelling evidence automation, Visa CE 3.0 / Mastercom integration, and win-rate optimization
npx skillsauth add finsilabs/awesome-ecommerce-skills chargeback-management-preventionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
| 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 |
The most cost-effective chargeback strategy is prevention.
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).
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.
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.
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.
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.
Add Stripe Radar rules for your risk profile:
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.
Shopify makes this straightforward: it pre-fills much of the evidence from the order data (shipping address, IP, order details).
Key rule: respond to every dispute, even low-value ones. Accepting a $10 chargeback still counts against your dispute ratio.
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.
Set a calendar reminder to check your dispute ratio monthly. Both Stripe and Shopify Payments provide this data:
Alert thresholds:
| 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 |
tools
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
development
Build a themeable storefront with design tokens and CSS custom properties that supports white-labeling, multi-brand variants, and dark mode
development
Speed up product discovery with instant search suggestions, fuzzy typo matching, and category-aware results powered by Algolia or Elasticsearch
development
Build a mobile-first storefront with thumb-friendly navigation, sticky add-to-cart buttons, and touch-optimized components for high mobile conversion