orderRevise

Mutationin Checkout

Reopen an unpaid order for editing: a new cart holding the same contents, and the order cancelled. One mutation rather than a replicate-then-cancel pair, because half of it is not recoverable by the buyer -- replicating without cancelling leaves a duplicate order, and cancelling without replicating strands them with nothing to edit.

Available while the payment is still open as well as once it has failed: the buyer who presses back at the provider is standing on the resume page asking for their basket, and no outcome has been reported yet.

Arguments

Argument	Type	Description
orderId	ID!

Returns

OrderReviseResponse!

Field	Type	Description
cart	Cart	A new cart holding the same contents as the order that was closed
orderErrors	[OrderReviseError!]	Error details if the order could not be reopened

Example

Query

mutation OrderRevise($orderId: ID!) {
  orderRevise(orderId: $orderId) {
    cart {
      id
      version
      createdAt
      lastModifiedAt
      currency
      customerEmail
      isGuest
      totalQuantity
      deliveryRemarks
      vatNumber
      purchaseOrderNumber
      deliverySplit
      requestedDeliveryDate
      earliestCompleteDeliveryDate
      name
      defaultName
      status
    }
    orderErrors {
      __typename
      ... on OrderError {
        code
        message
      }
      ... on ValidationError {
        message
      }
    }
  }
}

Variables

{
  "orderId": "id-1"
}

Response

{
  "data": {
    "orderRevise": {
      "cart": {
        "id": "id-1",
        "version": "Example",
        "createdAt": "2026-10-01T09:30:00Z",
        "lastModifiedAt": "2026-10-01T09:30:00Z",
        "currency": "EUR",
        "customerEmail": "jane@example.com",
        "isGuest": true,
        "totalQuantity": 1,
        "deliveryRemarks": "Example",
        "vatNumber": "Example",
        "purchaseOrderNumber": "Example",
        "deliverySplit": "COMPLETE",
        "requestedDeliveryDate": "2026-10-01",
        "earliestCompleteDeliveryDate": "2026-10-01",
        "name": "Example",
        "defaultName": "Example",
        "status": "ACTIVE"
      },
      "orderErrors": [
        {
          "__typename": "OrderError",
          "code": "TARGET_NOT_FOUND",
          "message": "Example"
        }
      ]
    }
  }
}

The query selects the return type's fields two levels deep; pick the ones you need. The response shows its shape with placeholder values.

Served by

@evolve-framework/commercetools	Resolved
@evolve-framework/medusa	Not resolved
@evolve-framework/sfcc	Not resolved

Used by

The storefront packages that send it, in these GraphQL documents:

• @evolve-storefront/feature-order: OrderRevise