---
title: Cancel orders
description: >-
  Cancel orders before they are fulfilled, or request a cancellation from the
  retailer.
source_url:
  html: 'https://shopify.dev/docs/apps/build/collective/cancellations'
  md: 'https://shopify.dev/docs/apps/build/collective/cancellations.md'
---

ExpandOn this page

* [How it works](https://shopify.dev/docs/apps/build/collective/cancellations.md#how-it-works)
* [Submit a cancellation request](https://shopify.dev/docs/apps/build/collective/cancellations.md#submit-a-cancellation-request)
* [Cancel an order before fulfilling](https://shopify.dev/docs/apps/build/collective/cancellations.md#cancel-an-order-before-fulfilling)
* [Next steps](https://shopify.dev/docs/apps/build/collective/cancellations.md#next-steps)

# Cancel orders

Merchants often need to cancel orders that they receive, and this works differently if you're acting as the retailer or as the supplier in the relationship.

In this guide you'll learn:

* How retailers can submit a cancellation requests for orders fulfilled by suppliers
* How suppliers can communicate cancellation status to their retailers

***

## How it works

1. A retailer can request a cancellation from the supplier.
2. If the order is not yet paid, Collective cancels the order automatically.
3. If the order is paid, the supplier can decide whether to cancel the order or not.
4. If the supplier cancels the order, the retailer will receive a notification.
5. The supplier can also cancel the order before it's paid.
6. If the supplier cancels the order, the retailer order will be canceled automatically.

***

## Submit a cancellation request

As a retailer you can request an order cancellation for a particular fulfillment order linked to a supplier using [`fulfillmentOrderSubmitCancellationRequest`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentOrderSubmitCancellationRequest).

If the order is not yet paid, Collective cancels the order automatically.

You can listen to the following webhooks to know if the supplier is accepting or rejecting the cancellation:

* [`fulfillment_orders/cancellation_request_accepted`](https://shopify.dev/docs/api/webhooks?reference=toml#list-of-topics-fulfillment_orders/cancellation_request_accepted)

* [`fulfillment_orders/cancellation_request_rejected`](https://shopify.dev/docs/api/webhooks?reference=toml#list-of-topics-fulfillment_orders/cancellation_request_rejected)

  If the supplier wishes to cancel the order, you will receive a notification via: [`fulfillment_orders/fulfillment_service_failed_to_complete`](https://shopify.dev/docs/api/webhooks?reference=toml#list-of-topics-fulfillment_orders/fulfillment_service_failed_to_complete)

  The order will be canceled automatically so no further action is required.

***

## Cancel an order before fulfilling

As a supplier you can cancel the order before fulfilling using [`orderCancel`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderCancel). When that happens, the order is also canceled on the retailer store and the refund happens automatically.

The retailer might also ask you to cancel the order by clicking "Request cancellation" on their store. NOTE: There's no way to detect this programmatically other than by receiving a cancellation request email.

If cancellation is requested, the order will be canceled automatically 14 days after payment was collected, if payment is still pending, or if it has not been shipped within this time.

***

## Next steps

* Configure [returns options](https://shopify.dev/docs/apps/build/collective/returns).

***

* [How it works](https://shopify.dev/docs/apps/build/collective/cancellations.md#how-it-works)
* [Submit a cancellation request](https://shopify.dev/docs/apps/build/collective/cancellations.md#submit-a-cancellation-request)
* [Cancel an order before fulfilling](https://shopify.dev/docs/apps/build/collective/cancellations.md#cancel-an-order-before-fulfilling)
* [Next steps](https://shopify.dev/docs/apps/build/collective/cancellations.md#next-steps)