thevitaminshots Refunds & Returns for WooCommerce

A complete refund and return request system for your WooCommerce store — free, GPL, and completely customizable.

Customers submit refund or return requests through a beautiful shortcode-based form. They enter their order number, get verified, describe the issue, and submit. You review the request in your WordPress admin, approve or deny it, and the customer gets notified automatically.

Perfect for stores that want a proper RMA (Return Merchandise Authorization) flow without the complexity of enterprise-grade tools.

Why store owners love it

• Configurable refund percentage — 100% full refunds, 50% partial refunds, or any value from 0 to 100
• Two tax modes — use your existing WooCommerce tax settings, OR upload a US ZIP-based CSV for granular tax lookup
• Order verification — customers must provide the order number AND matching email before they can submit
• Excluded categories — auto-hide products in categories like “Gift Cards” or “Bundles” from refund forms
• Return windows — enforce a “returns must be requested within X days of purchase” policy
• Email notifications — customer gets a confirmation, admin gets alerted; both are configurable
• Beautiful admin dashboard — filter by status/type, view details, approve/deny with one click
• Fully translation-ready — text domain, .pot generation supported

Features

• Two-in-one: refund requests AND return requests in the same plugin
• Requires WooCommerce (versions 5.6 to 8.x tested)
• Six tabs of settings: General, Refund, Return, Tax, Notifications, Advanced
• Customer form with three-step flow: Order lookup → Details → Submission confirmation
• Configurable refund percentage from 0% to 100%
• Two tax calculation modes: WooCommerce built-in tax rates OR CSV-based ZIP lookup
• Category exclusion (products in specific categories won’t appear in refund forms)
• Return window enforcement (configurable 1-365 days)
• Optional evidence requirements: photo uploads and/or video URL
• Six default return reasons (defective, wrong item, not as described, no longer needed, damaged in shipping, other) — pick which ones to offer
• Automatic customer confirmation email on submission
• Automatic customer status-update email when admin approves or denies
• Admin notification email routing
• Customizable form title, subtitle, and success message
• Accent color customization (matches your brand)
• Admin dashboard with filtering by status and type
• One-click approve/deny buttons with optional admin notes
• WooCommerce order lookup by numeric ID or custom order number
• Lightweight: under 80 KB total
• Free and open-source under GPL v2

Use cases

• E-commerce stores — give customers a self-service refund/return portal
• Subscription businesses — handle first-time-only refund policies (100% for first order, X% for subsequent)
• Digital goods stores — 50% or 25% partial refund policies with clear documentation
• Physical goods stores — full RMA workflow with photo/video evidence
• Multi-region US stores — precise per-ZIP tax refunds with CSV upload
• International stores — use WooCommerce’s built-in tax settings for automatic global tax handling

Compatibility

Works with Elementor, Divi, Beaver Builder, Bricks, Gutenberg, and the Classic Editor. Just paste the shortcode [tvsret_form] anywhere on your site. Tested on WordPress 5.6 through 7.0. Requires WooCommerce.

Source Code

All JavaScript and CSS files in this plugin are the actual source — nothing is minified or compiled. Every file in the plugin folder is human-readable production code.

For updates and documentation: https://thevitaminshots.com/plugins/

External services

This plugin does not connect to any external services controlled by the plugin author. All data (requests, tax rates, settings) is stored in your own WordPress database.

The plugin uses only WooCommerce’s own internal APIs (for order lookup, product data, and tax calculation) and WordPress core APIs (for options, database, and email). No third-party servers, no analytics, no telemetry.

If the store owner enables the CSV tax mode, the plugin reads tax rates from a CSV file that the store owner uploads directly through the admin panel. No CSV file is downloaded from any external source by the plugin.