completeOrder mutation

The completeOrder mutation synchronizes order details before you run the placeOrder mutation.

When the mutation runs, Commerce generates and returns a token in the orderV2.token field. You can supply the token value to the guestOrderByToken query to retrieve details about an order created by a guest shopper.

Preconditions

Before you run the completeOrder mutation, ensure that:

1. A cart has been created (guest or logged-in customer).
2. Products have been added to the cart.
3. Billing and shipping addresses have been set, if applicable.
4. A shipping method has been selected (for physical products).
5. A payment or checkout ID has been generated and is available.
6. For guest carts, a valid email address has been assigned.

Limitations

• The completeOrder mutation is similar to the placeOrder mutation, but includes an additional required field id to capture the payment identifier.
• On success, the mutation returns the orderV2 object containing the number and token fields.
• The token field allows guest users to retrieve their order using queries such as guestOrderByToken.

Syntax

Copy
mutation {
  completeOrder(
    input: CompleteOrderInput
  ) {
    CompleteOrderOutput
  }
}
Copied to your clipboard
mutation {
  completeOrder(
    input: CompleteOrderInput
  ) {
    CompleteOrderOutput
  }
}

Example usage

Request:

Copy
mutation {
  completeOrder(input: {
    cartId: "AJCY8dhIfuch9LcDHAxEkw7oG3DjGdKt"
    id: "88455624KT013492F"
  }) {
    orderV2 {
      number
      token
    }
    errors {
      message
      code
    }
  }
}
Copied to your clipboard
mutation {
  completeOrder(input: {
    cartId: "AJCY8dhIfuch9LcDHAxEkw7oG3DjGdKt"
    id: "88455624KT013492F"
  }) {
    orderV2 {
      number
      token
    }
    errors {
      message
      code
    }
  }
}

Response:

Copy
{
  "data": {
    "completeOrder": {
      "orderV2": {
        "number": "0000000012",
        "token": "0:3:OSScWU6PKLn3kFyMhNWyskG0opgVvFBnJmtuaFHKGwDFT83S6Kv9U39iYwixuU+vhwDz2AF4pCs3GtLhHbQ="
      },
      "errors": []
    }
  }
}
Copied to your clipboard
{
  "data": {
    "completeOrder": {
      "orderV2": {
        "number": "0000000012",
        "token": "0:3:OSScWU6PKLn3kFyMhNWyskG0opgVvFBnJmtuaFHKGwDFT83S6Kv9U39iYwixuU+vhwDz2AF4pCs3GtLhHbQ="
      },
      "errors": []
    }
  }
}

Input attributes

CompleteOrderInput

Output attributes

CompleteOrderOutput

OrderV2 object

Error object

Possible error codes

Last updated 11/4/2025

Was this helpful?

Yes

No