orderCancel

mutation

Requires write_orders access scope or write_marketplace_orders access scope. Also: This action cannot be reversed.

Cancels an order.

Arguments

Anchor to notifyCustomernotifyCustomer • BooleanDefault:false: Whether to send a notification to the customer about the order cancellation.
Anchor to orderIdorderId • ID!required: The ID of the order to be canceled.
Anchor to reasonreason • OrderCancelReason!required: The reason for canceling the order.
Anchor to refundrefund • Boolean!required: Indicates whether to refund the amount paid by the customer. Authorized payments will be voided regardless of this setting.
Anchor to restockrestock • Boolean!required: Whether to restock the inventory committed to the order. For unpaid orders fulfilled from locations that have been deactivated, inventory will not be restocked to the deactivated locations even if this argument is set to true.
Anchor to staffNotestaffNote • StringDefault:null: A staff-facing note about the order cancellation. This is not visible to the customer.

Was this section helpful?

Anchor to OrderCancelPayload returnsOrderCancelPayload returns

Anchor to jobjob • Job: The job that asynchronously cancels the order.
Anchor to orderCancelUserErrorsorderCancelUserErrors • [OrderCancelUserError!]!non-null: The list of errors that occurred from executing the mutation.
Anchor to userErrorsuserErrors • [UserError!]!non-nullDeprecated: The list of errors that occurred from executing the mutation.

Was this section helpful?

Mutation Reference

1mutation orderCancel($notifyCustomer: Boolean, $orderId: ID!, $reason: OrderCancelReason!, $refund: Boolean!, $restock: Boolean!, $staffNote: String) {
2  orderCancel(notifyCustomer: $notifyCustomer, orderId: $orderId, reason: $reason, refund: $refund, restock: $restock, staffNote: $staffNote) {
3    job {
4      # Job fields
5    }
6    orderCancelUserErrors {
7      # OrderCancelUserError fields
8    }
9    userErrors {
10      field
11      message
12    }
13  }
14}

Input

1{
2  "notifyCustomer": true,
3  "orderId": "gid://shopify/<objectName>/10079785100",
4  "reason": "CUSTOMER",
5  "refund": true,
6  "restock": true,
7  "staffNote": "<your-staffNote>"
8}

{
  "notifyCustomer": true,
  "orderId": "gid://shopify/<objectName>/10079785100",
  "reason": "CUSTOMER",
  "refund": true,
  "restock": true,
  "staffNote": "<your-staffNote>"
}