Skip to content

Order Cancellation

The order cancellation flow sends a WhatsApp notification when an order is cancelled, so the customer is informed promptly and given the reason.

When an order is cancelled in Shopify — from the admin, the API, or a customer action — Shopify fires the orders/cancelled webhook. WhatPro then:

  1. Cleans up any pending confirmation message for the order. If a delayed payment-confirmation or review-request message was still queued, it is cancelled so the customer is not asked to confirm or review an order they no longer have.
  2. Sends the order cancellation notification, provided an enabled cancellation flow exists and the order has a usable phone number.

If the customer cancels through a WhatsApp button on a confirmation message, they already receive that button’s own follow-up reply. To avoid a duplicate message, WhatPro detects this case and does not also send the cancellation template. Merchant-initiated cancellations from the Shopify admin always send the template normally.

The order cancellation flow is available on Growth and Plus. Starter and Basic do not include it. See Plans.

VariableDescription
customer_first_nameCustomer’s first name; falls back to a generic greeting when unknown.
order_numberThe order name (for example #1001).
cancel_reasonA human-readable cancellation reason, localized to the flow’s language.
total_priceThe order total with currency.
order_totalLegacy alias for total_price.
order_itemsA formatted list of the order’s line items.
shipping_addressThe order’s formatted shipping address.

The cancel_reason value is derived from Shopify’s cancellation reason and rendered in the flow’s language. WhatPro provides default labels for Shopify’s standard reasons:

Shopify reasonDefault label
CustomerCustomer changed or canceled order
DeclinedPayment declined
FraudFraudulent order
InventoryItems unavailable
StaffStaff error
OtherOther

You can override the label for each reason in the cancellation flow’s editor. Arabic-language flows render the Arabic equivalents.

The order cancellation flow uses the flow’s own order-tag templates rather than the lifecycle order-tagging system used by the payment confirmation flows. When a cancellation is processed, WhatPro also strips the “awaiting send” lifecycle tag from the order, since any pending confirmation send for it has been cancelled. See Order tags.

  1. Confirm your plan is Growth or Plus. See Plans.
  2. In Flows, create or enable the Order cancellation flow.
  3. Optionally edit the cancellation reason labels and the message body.
  4. Wait for the template to be Approved by Meta before it can send. See Flows overview.