How to Change Order Status in Magento 2

Magento 2 provides a set of default statuses, which may vary depending on version and installed payment modules (e.g., PayPal adds additional statuses): Received, Suspected Fraud, Processing, Pending Payment, Payment Review, Pending, On Hold, Complete, Closed, Canceled, Rejected, PayPal Canceled Reversal, Pending PayPal, PayPal Reversed.

These statuses help merchants track the progress of each order through the fulfillment process.

There are several ways to change order status in Magento 2, depending on your requirements:

1. Manually through the Magento Admin panel
2. Programmatically using custom code
3. Via Magento REST API
4. Automatically using Magento 2 extensions

In this article, we will walk you through each of these methods. Choose the method that best aligns with your specific needs and technical capabilities.

Improve order processing speed with automatic invoicing, shipping creation, and status updates using our Auto Invoice & Shipment Extension.

How to Change Order Status in Magento 2 Manually in the Admin Panel

In the Magento 2 admin panel, you can only manually change the order status to On Hold or Canceled. All other statuses depend on payment method, payment status, shipping, and refunds.

Steps to change order status to Canceled or On hold status:

How to Change Order Status in Magento 2 Programmatically

Magento provides the OrderManagementInterface for performing standard order management actions.

In this example, we will create a Magento 2 model called ManageOrder that can hold, unhold, or cancel an order programmatically.

<?php

declare(strict_types=1);

namespace Vendor\OrderManagement\Model;

use Magento\Sales\Api\OrderManagementInterface;

class ManageOrder
{
    public function __construct(
        private readonly OrderManagementInterface $orderManagement
    ) {
    }

    public function hold(int $orderId): void
    {
        $this->orderManagement->hold($orderId);
    }

    public function unhold(int $orderId): void
    {
        $this->orderManagement->unHold($orderId);
    }

    public function cancel(int $orderId): void
    {
        $this->orderManagement->cancel($orderId);
    }
}

The following example shows how to use the ManageOrder model. Simply pass the order ID to the appropriate method depending on the action you pAGEwant to perform.

<?php

declare(strict_types=1);

namespace Vendor\OrderManagement\Console\Command;

use Vendor\OrderManagement\Model\ManageOrder;

class Example
{
    public function __construct(
        private readonly ManageOrder $manageOrder
    ) {
    }

    public function execute(): void
    {
        $this->manageOrder->hold(123);
    }
}

Here, the order with ID 123 will be placed on hold. In the same way, you can call unhold() or cancel() to perform the corresponding action.

How to Change Order Status in Magento 2 via REST API

To cancel an order through the Magento 2 REST API, obtain an access token and then call the dedicated cancel endpoint.

1. Get an Admin Access Token

If two-factor authentication is not enabled for the admin account, use:

curl -X POST \
  "https://magento-store.com/rest/V1/integration/admin/token" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin_username",
    "password": "admin_password"
  }'

If 2FA with Google Authenticator is enabled, send the current six-digit one-time password using the 2FA endpoint:

curl -X POST \
  "https://magento-store.com/rest/V1/tfa/provider/google/authenticate" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin_username",
    "password": "admin_password",
    "otp": "123456"
  }'

A successful request returns an admin access token. The endpoint may differ if another 2FA provider is configured.

2. Cancel the Order

Replace <access-token> with the returned token and <orderId> with the internal Magento order entity ID:

curl -X POST \
  "https://magento-store.com/rest/V1/orders/<orderId>/cancel" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <access-token>"

Magento validates whether the order can be canceled and processes the cancellation using its standard order management logic.

Similar REST API endpoints are available for other order operations, such as placing an order on hold or releasing it from hold:

POST /rest/V1/orders/<orderId>/hold
POST /rest/V1/orders/<orderId>/unhold
POST /rest/V1/orders/<orderId>/cancel

For operations such as invoicing or shipping, Magento provides separate REST API endpoints and request payloads.

How to Change Order Status in Magento 2 Automatically

One efficient way to automate order status updates in Magento 2 is by using the Magento 2 Auto Invoice & Shipment Extension. This extension can automatically generate invoices and shipments, which triggers an automatic change in the order status to Processing or Complete, depending on the fulfillment stage.

Key features of this extension include:

Frequently Asked Questions (FAQ)