Magento 2 Observer not working on event 'checkout_onepage_controller_success_action'

Magento 2 Observer not working on event 'checkout_onepage_controller_success_action'

September 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 Observer not working on event 'checkout_onepage_controller_success_action'

Solving Magento 2 Observer Issues for ‘checkout_onepage_controller_success_action’ Event

You’re facing a common challenge many developers encounter when working with Magento 2 observers—getting them to fire correctly on specific events like checkout_onepage_controller_success_action. Let’s dive into the steps you’ve attempted and find the solution.

Understanding Magento 2 Observer Configuration

First, let’s ensure your configuration is correct. You’re using the right XML structure in your events.xml file:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Event/etc/events.xsd">
    <event name="checkout_onepage_controller_success_action">
        <observer instance="[company]\[module]\Observer\CheckoutSuccessObserver" name="checkout_onepage_controller_success_action_observer"/>
    </event>
</config>

And your observer class is properly implemented:

namespace [company]\[module]\Observer;

use Magento\Framework\Event\ObserverInterface;
use Magento\Framework\Event\Observer;

class CheckoutSuccessObserver implements ObserverInterface
{
    public function execute(Observer $observer)
    {
        $order = $observer->getEvent()->getOrder();
        print_r($order); exit;
    }
}

Common Pitfalls and Solutions

1. Compilation Process

You’ve mentioned running the necessary commands (bin/magento setup:upgrade, bin/magento setup:di:compile, bin/magento cache:clean). This is correctly done in the right order.

2. Observer Name Mismatch

Ensure that the observer name specified in your XML configuration matches exactly with what you’ve set in your observer class. In your case, it seems fine (checkout_onepage_controller_success_action_observer).

3. Event Dispatching Sequence

The event checkout_onepage_controller_success_action is dispatched late in the checkout process. Make sure you’re testing after a successful order placement.

Advanced Troubleshooting Steps

If the above doesn’t resolve your issue, consider the following:

1. Check for PHP Errors: Ensure there are no PHP errors stopping the execution flow. Enable error reporting to see if anything is being blocked.

ini_set('display_errors', 1);
error_reporting(E_ALL | E_STRICT);

2. Debug Observer Execution

Add a debug log in your observer:

$writer = new \Zend_Log_Writer_Stream(BPloge_PATH . '/var/log/debug.log');
$logger = new \Zend_Log();
$logger->addWriter($writer);
$logger->info('Observer executed');

This will help you verify if the observer is being called at all.

3. Event Ordering

Ensure no other module is overriding or preventing this event from firing. Check for any custom plugins or changes to the checkout process in your theme.

Conclusion

In most cases, if you’ve followed the proper Magento 2 development guidelines and run the necessary commands, your observer should work as expected on events like checkout_onepage_controller_success_action.

Remember, Magento 2 has a complex event system with many moving parts. It’s crucial to understand when each event is dispatched during the checkout process.

If you’re still facing issues after following this guide, I recommend checking out our detailed tutorials on Magento 2 observer development for a more comprehensive walkthrough.

Magento 2 Checkout Cache Extensions

Our network