safe Safe & Secure online payment

User documentation: Cancel order request for WooCommerce

Basic setting

Show cancel order request button on order with this status

Controls which order statuses will display the “Cancel request” button to customers. This setting is a multi-select where you pick one or more order statuses (e.g., Processing, On hold). The selected statuses determine when customers may submit a cancellation request. Internally the plugin stores status keys like wc-processing but the UI presents them without the wc- prefix.

Example: Select “Processing” so customers can request cancellation while the order is being processed.

Disable cancel request option for orders with this payment methods

Prevents the cancel request option from appearing for orders placed using specific payment methods. Use the multi-select to choose one or more payment gateways (e.g., PayPal, Cash on Delivery). If a gateway is selected, orders paid with that method won’t show the cancellation request button.

Example: Select “Cash on Delivery” to disallow cancellation requests for COD orders.

Disable cancel request option for orders placed by this user group

Disables the cancel request feature for orders placed by selected WordPress user roles. Choose one or more roles (e.g., Customer, Subscriber). The “guest” option is also available to target guest customers separately.

Example: Select “wholesale_customer” (a custom role) to prevent users in that role from submitting cancel requests.

Admin message to show above the cancel order request box

Text displayed above the cancellation request box in the order area. Use this textarea to provide guidance or instructions to customers before they submit a cancellation request. HTML should be avoided unless explicitly intended.

Example: “Please provide a short reason for cancellation. We will review your request within 48 hours.”

Predefined reason for cancellation

List of preset cancellation reasons, one per line. These are shown as selectable reasons in the cancellation form. Each reason must be plain text without HTML. You can provide multiple lines—each line becomes one selectable option in the UI.

Example: Enter each reason on its own line like:
Product not as described
Found a better price elsewhere
Other

Remove cancel button after this time (minutes)

Specifies a time window (in minutes) after order placement during which the cancel request button remains visible. If left blank or set to 0, the button will not be hidden based on time. Use a numeric value to limit how long customers can submit requests after placing the order.

Example: Set to 60 to allow cancellation requests only within the first hour after the order was placed.

Add order detail page link in customer email

Controls whether an order detail page link is added to customer emails and which customers see it. This multi-select offers “Registered customer” and “Guest customer.” Choosing “guest” allows guest customers to view order details via the link included in emails.

Example: Select both “Registered customer” and “Guest customer” to include the order detail link for all customers.

Disable order completion email when cancellation request is rejected

When a cancellation request is rejected and the order status is changed back to “Completed”, WooCommerce normally sends an order completion email in addition to the cancellation rejection email. Enable this switch to suppress the order completion email and only send the cancellation rejection notification.

Example: Turn this on so customers receive only the “cancellation request rejected” email when you reject a request and mark the order completed.

Make order cancellation reason as required

Requires customers to provide a cancellation reason before submitting the request. When enabled, the reason field becomes mandatory—users must select a predefined reason or enter a custom reason to proceed.

Example: Enable this to force users to pick or type a reason, preventing empty submissions.

Allow customer to upload image along with cancellation reason

Allows customers to upload a single image file along with their cancellation reason. Enable this switch to let users attach supporting images (e.g., damaged product photos) when submitting a cancellation request.

Example: Turn on to allow customers to attach a photo showing a damaged item.

Allow Order Cancellations for Registered Customers Without Login

When enabled, registered customers can place cancellation requests without logging in. If disabled, registered users must log in to their account in order to submit a cancellation request. This setting is useful if you want to support registered users who may not be able to log in but can still verify via an email/order link.

Example: Enable to let a registered user submit a cancellation using the order link sent by email instead of requiring account login.

Button: Cancel request

Customize the label text for the cancel request button shown to customers. Enter the desired button text; the default is “Cancel Request”. This is a simple text field and supports translation strings via WordPress localization.

Example: Change to “Request Cancellation” to match your site’s wording.

Button: Submit cancellation request

Customize the label for the submit button on the cancellation form. The default is “Send Cancellation Request”. Use this text field to make the action text clearer or localized for your site.

Example: Change to “Submit Request” to keep labels concise.

Cancellation form heading: Request to cancel order #xxx

Heading text for the cancellation form. You can include the placeholder [order_no], which will be replaced with the actual order number when the form is shown. This field accepts a text string and is used as the form title.

Example: Use “Request to cancel order #[order_no]” which will display as “Request to cancel order #1234”.

Success message

Message displayed to the user after a cancellation request is successfully submitted. The placeholder [order_no] is supported and will be replaced with the real order number. Use plain text for the message.

Example: “Order cancellation request sent successfully for order #[order_no]” will appear as “Order cancellation request sent successfully for order #1234”.

Allow withdrawal of cancellation request

When enabled, customers can withdraw their cancellation request as long as the request has not yet been accepted or declined by an admin. This switch toggles whether the withdraw action and related UI are available to customers.

Example: Enable so a customer can retract their cancellation request if they change their mind before admin action.

Button: Withdraw cancellation

Custom label for the withdraw cancellation button. Change this text to whatever wording fits your site; the default is “Withdraw cancellation”. This field is a simple text input.

Example: Change to “Retract Request” for a shorter label.

Successfully withdrawn message

Message shown to users after they successfully withdraw a cancellation request. The placeholder [order_no] is supported and replaced with the actual order number.

Example: “Cancellation request withdrawn for order #[order_no]” will display as “Cancellation request withdrawn for order #1234”.

Repurchase

Show Repeat order button on order with this status

This setting controls for which order statuses the “Repeat order” button is displayed. It is a multiselect field where you can choose one or more order statuses (or “All Order types”) that will allow customers to repeat the order. If no status is selected the button will not appear for any orders; choosing “all” will enable it for every order status.

Example: Select “completed” and “processing” so the Repeat order button appears only on orders with those statuses.

Default action of repeat order button

Sets the default behavior performed when a customer clicks the repeat order button. It is a select field with three options: – “Ask customer” — show a popup asking whether to merge into the cart or replace the cart contents. – “Merge” — automatically merge the repeated order items into the current cart. – “Replace” — replace the current cart contents with the repeated order’s items. This default is used when the customer does not explicitly choose an action in the popup or when popup prompting is disabled.

Example: Choose “merge” so clicking Repeat order will add items to whatever is already in the cart.

Show reorder button on View order and Order success page

A switch (on/off) that determines whether the reorder button is shown on the View Order page (order details) and the Order Success/Thank You page. When enabled, customers will see a Repeat order button on those pages for eligible orders; when disabled, the button will be hidden even if other settings would otherwise allow it.

Example: Enable this switch to let customers reorder directly from their order confirmation page.

What to do after repeat order products are added to the cart

Controls the post-add behavior after the repeat order items are inserted into the cart. Options: – “Ask customer” — show a popup with links (and possibly buttons) letting the customer go to cart or checkout. – “Direct redirect to cart page” — immediately redirect the customer to the cart page. – “Direct redirect to checkout page” — immediately redirect the customer to the checkout page. Choose the flow that best fits your store UX (instant redirect vs letting the customer continue browsing).

Example: Select “redirect-checkout” to send customers straight to checkout after items are added.

Repeat order

Text label for the repeat order button displayed to customers. This is a plain text field where you can set the button text shown in the UI when offering the repeat order action.

Example: Set the label to “Buy Again” instead of “Repeat Order” for clearer wording.

Replace cart

Text label for the button that replaces the current cart with items from the repeated order. Use this field to customize the label shown in the popup or UI when the “replace” action is presented.

Example: Change the label to “Replace My Cart” to make the action explicit.

Merge cart

Text label for the button that merges the repeated order items into the existing cart. This field customizes the label used when offering the merge action in the popup or UI.

Example: Use “Add to Cart” to match other store wording for adding items.

Go to Cart

Text label for the button or link that takes the customer to the cart page after successful insertion of repeated order items. Customize this to match your store’s language.

Example: Change to “View Cart” so customers clearly understand the destination.

Go to Checkout

Text label for the button or link that takes the customer to the checkout page after successful insertion of repeated order items. This label appears in popups or confirmation dialogs where you present a direct checkout option.

Example: Set it to “Proceed to Checkout” for clarity.

Success popup background color

Color picker value used for the background of the success toast or popup shown when repeat order items are successfully added. Provide a HEX color value; the default is #51a564 (green). This helps visually indicate success to customers.

Example: Use “#28a745” for a Bootstrap-like success green.

Error popup background color

Color picker value used for the background of error toasts or popups when the repeat order fails or there is an issue. Provide a HEX color value; the default is #ff4747 (red). This visually signals failure or problems to the user.

Example: Use “#dc3545” for a Bootstrap-style danger red.

Button in popup background color

Color picker value for the background color of action buttons inside the popup (e.g., Go to Cart, Go to Checkout, Merge/Replace). Provide a HEX color value; default is #cccccc (light gray). This controls button appearance in the popup UI.

Example: Use “#007bff” to make popup buttons match a primary blue style.

Button in popup text color

Color picker value for the text color of action buttons inside the popup. Provide a HEX color value; default is #000000 (black). Adjust this to ensure sufficient contrast with the button background color for accessibility.

Example: Use “#ffffff” (white) when the button background is a dark color like blue.

Auto Refund

Auto refund only work when you have the TerraWallet plugin or our Add coupon by link plugin installed in your website as the auto refund amount is credited in to this wallet or coupon.

Enable store credit refund

Toggle to enable automatic store-credit (wallet) refunds when a customer submits a cancellation request. When enabled, cancellation requests can be automatically accepted and the refund amount credited to the customer’s wallet instead of performing a standard payment gateway refund. Default is disabled.

Example: Turn this ON so that when a customer cancels order #123 the order is accepted and $25 is added to their store wallet balance immediately.

Store credit refund choice given to customer

Controls whether customers are offered a choice to receive their refund as store credit or whether all refunds are forced into store credit. Options include forcing all refunds to wallet (no choice) or showing an option on the cancellation form that the customer can select. The setting values are: wallet-refund (force wallet, no choice) and give-option (present a choice to the user). Default is wallet-refund.

Example: Select “give-option” to show a checkbox on the cancel form labeled “Refund to store credit” so customers can opt in; select “wallet-refund” to always refund to wallet without asking.

Order status for partially refunded in wallet

Select which WooCommerce order status should be applied when an order is partially cancelled and the partial refund is issued to the wallet. The dropdown lists your shop’s order statuses (keys without the “wc-” prefix); choose the status that correctly reflects a partial wallet refund in your workflow. Default value is partial-refunded (or the plugin’s equivalent label).

Example: Choose “partially-refunded” so partially cancelled orders appear with that status in the orders list after issuing a partial wallet refund.

Credit refund amount in the wallet

Text shown on the cancellation request form next to the wallet/store-credit refund option when customers are given a choice. This field lets you customize the label or explanatory text that describes the credit/refund amount behavior in the wallet. The default string is the plugin’s localized “Credit refund amount in the wallet”.

Example: Change this text to “Refund to store credit (instant)” so customers clearly see that selecting the option will credit their account immediately.