Goal

Add per-order action buttons to the customer’s My Orders screen:

• Cancel Order — sends a cancellation request (message + order) into the suite’s cancel pipeline.
• Feedback — saves the customer’s comments on a completed order and notifies the site administrators.
• Request Refund — opens a refund-request form on eligible orders, showing the amount the policy allows.

Each action is backed by a Gravity Form you create and then map in Mobile App Manager → Forms Manager.

Before you start

• mam-woocommerce, MAM Main, and Gravity Forms are active.
• You know how to build a basic Gravity Form (see the Gravity Forms Manager recipes).

Step 1 — Build the three Gravity Forms

Each form needs fields the plugin can map. Use simple field types (text/textarea/hidden):

Step 2 — Map the forms in Forms Manager

1. Go to Mobile App Manager → Forms Manager and open the Field Settings tab.
2. Find the Cancel Order Form, Refund Form, and Feedback Form rows (registered there by mam-woocommerce).
3. Pick your Gravity Form in each dropdown and save; field-mapping dropdowns then appear under each — map each declared field (Message/postid etc.) to the matching GF field and save again.

Step 3 — Set the refund policy (Refund tab)

On Mobile App Manager → WooCommerce → Refund:

These are stored per user role (currently saved for the customer role — keys like tsl-setting-allow_refunds_customer).

Step 4 — Test in the app

Place a test order, then check the order in My Orders:

• Cancel Order appears while WooCommerce itself considers the order cancellable (same rule as the website’s My Account page). The button also requires the order row to carry a vendor — i.e. MAM WooCommerce Product Vendors is active — as cancellation processing is handled there.
• Feedback appears on Completed orders.
• Request Refund appears on Processing orders that pass the refund policy above.

What happens on submission

• Cancel: the plugin verifies the submitting user owns the order, then fires the mam_wc_cancel_order action with order_id, message, and partial_amount. The actual status change/refund is performed by the listener — MAM WooCommerce Product Vendors handles it on vendor stores (including the card refund via mam_pmt_refund_card). Without a listener, the request is recorded but nothing changes.
• Feedback: comments are sanitized and appended to the order’s order_feedback meta, and an order-feedback notification (with the comments, order id, and customer name) is sent to every administrator. Customize that message under the suite’s notification settings.
• Refund request: the button and the amount preview are driven by the policy settings. Note: as of 26.19.3 the refund form’s submission is not routed to a handler in this plugin (a long-unused legacy path was removed); actual refunds run through the cancel-order flow or store-side processing. If you rely on the refund form, treat it as a request-collection form and process refunds from wp-admin.

All three actions are authorization-checked server-side: the submitting app user must own the order (store managers always pass). See Hook: the `mam_wc_usercan` authorization filters* for the escape hatches.

Related articles

• Plugin: mam-woocommerce
• Hook: mam_wc_is_refund_allowed
• Hook: the `mam_wc_usercan` authorization filters*
• Recipe: Add a Gravity Form to your app (mam-gravity-forms-manager)

Metadata