Description
MINRETURNS connects your WooCommerce store to the MINRETURNS returns and exchanges service. Customers can start a return from their orders. Your team reviews requests and manages decisions in MINRETURNS.
The connector is free. A MINRETURNS account is required. MINRETURNS offers a trial and paid service plans; see https://minreturns.com/pricing. Installing this plugin does not purchase a subscription.
Store connection
- Connect through the standard WooCommerce authorization screen instead of copying API keys manually.
- Confirm the organization that will receive your store data in MINRETURNS.
- View API access, order and catalog synchronization, webhook activity and customer-button status.
- View the connected store, organization, last synchronization, last webhook and software versions.
- Check the connection, open MINRETURNS or disconnect from the plugin screen.
- Keep the existing manual setup in an expandable advanced-settings section.
Customer links and notifications
- Add a returns link to My Account orders and the customer order page.
- Optionally include a durable portal link in WooCommerce emails.
- Generate short-lived HMAC-signed customer links for supported order statuses.
- Show authorized store administrators a dismissible notification about a new return, with a link to its record in MINRETURNS.
- Keep return decisions, approvals and financial actions in MINRETURNS.
Notifications are polled periodically using WordPress cron and on visits to the plugin screen. Delivery depends on cron activity and connectivity; notifications are not instant push messages.
The plugin supports WooCommerce High-Performance Order Storage (HPOS). HTTPS and PHP OpenSSL are required for automatic connection.
External service and data use
This plugin uses https://minreturns.com to provide the integration. External calls begin when you connect or configure the service, run a diagnostic check, use a connected customer link or maintain an existing connection. Configured WooCommerce webhooks also send events to MINRETURNS.
During authorization, WooCommerce sends dedicated Read/Write REST API credentials to MINRETURNS. Your WordPress administrator password is not sent. The Read/Write permission is broad; it allows the service to create webhooks and perform supported store operations. Review the WooCommerce permission screen before approval.
The connection exchanges your store URL, organization selection, a random authorization state, a one-time connection code and integration credentials. Connection checks send WordPress, WooCommerce and plugin versions. The service uses the granted WooCommerce API access to synchronize orders and catalog data. Order data can include customer contact and address details, line items, totals and statuses. Catalog data can include products, variations, prices and stock information.
Webhooks send order and product event payloads for order.created, order.updated, product.created and product.updated. Signed customer links contain an installation identifier, order reference, expiry and signature. Diagnostic checks may use a store order to verify signed access. The plugin retrieves short return notifications, including request and order references, a decision summary, amount and a MINRETURNS link; acknowledging a notification sends its identifier.
Automatic connection credentials and manual secrets are stored encrypted with a key derived from WordPress salts. Changing those salts can require reconnecting the integration. MINRETURNS stores service-side credentials encrypted. Customer and order data handling is governed by the service documents:
- Service: https://minreturns.com
- Privacy policy: https://minreturns.com/privacy
- Terms: https://minreturns.com/terms
- Data processing agreement: https://minreturns.com/dpa
- Plans: https://minreturns.com/pricing
Screenshots
Installation
- Install the MINRETURNS ZIP using Plugins > Add New > Upload Plugin, then activate it. Once listed in WordPress.org, the same plugin can also be installed from the directory.
- Ensure WooCommerce is active and the store and WordPress administration use HTTPS.
- Open WooCommerce > MINRETURNS and select Connect MINRETURNS.
- Sign in to MINRETURNS and confirm the intended organization and store.
- Approve the dedicated Read/Write permission in WooCommerce.
- Return to the plugin screen. If the authorization callback is still processing, use Complete connection.
- Check the initial synchronization. Webhook activity remains pending until a real supported event arrives.
To update an existing 4.0.0 installation, upload the new ZIP and choose to replace the installed plugin. Do not uninstall first: uninstall intentionally removes connector settings and stored credentials.
FAQ
-
Can I still connect manually?
-
Yes. Open Manual connection / Advanced settings. Existing fields, API-key tools, diagnostics and webhook setup remain available.
-
Why does MINRETURNS report that the organization has another store’s orders?
-
This protects existing data from being mixed with a different WooCommerce store. Select an appropriate organization or arrange a controlled migration. Do not delete production orders to bypass the check.
-
Why are events still pending after synchronization?
-
Synchronization and webhook delivery are separate checks. The event status changes after MINRETURNS receives a supported event. On a test store, create a test order and check the last-webhook status.
-
Can I approve returns in WordPress?
-
No. Notifications open the corresponding record in MINRETURNS, where permissions, decisions and financial actions are managed.
-
How do I disconnect?
-
Use Disconnect on the plugin screen. You can also revoke the dedicated API key under WooCommerce > Settings > Advanced > REST API. If the service cannot confirm disconnection, the plugin reports the error instead of pretending access was revoked.
-
What happens when I deactivate or delete the plugin?
-
Deactivation stops the notification schedule and keeps settings for reactivation. Deletion removes the plugin’s local options, temporary keys and identified MINRETURNS API keys. It does not erase orders or returns in MINRETURNS. Disconnect while the service is reachable before deletion to revoke the remote connection. Webhooks can be reviewed separately in WooCommerce settings.
-
Does the plugin send email or issue refunds itself?
-
The plugin adds an optional link to existing WooCommerce emails. Return notifications and return processing are provided by MINRETURNS. Plugin installation does not initiate a payment or refund.
-
What languages are supported?
-
English and Ukrainian are included. The existing Ukrainian wording is preserved through the bundled translation. The interface follows the WordPress user/site language. A translation template is included. Service-provided messages and saved custom button labels retain their original language.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“MINRETURNS — Returns and Exchanges” is open source software. The following people have contributed to this plugin.
Contributors
Translate “MINRETURNS — Returns and Exchanges” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
4.0.1
- Replace short echo tags and use WordPress URL parsing.
- Prepare database table identifiers and prefix uninstall variables.
- Document narrowly scoped fresh-key database reads and state-validated callbacks.
- Restrict plugin-page polling to the authorized WooCommerce administration screen.
- Add translation support and English directory documentation.
- Preserve connection storage, customer signatures, manual setup and integration endpoints.
4.0.0
- Add WooCommerce authorization-based connection, connection status and return notifications.
- Keep manual setup as an expandable fallback and encrypt connection credentials.
3.0.1
- Improve dedicated REST API-key creation and manual setup diagnostics.