magento payment gateway custom method return

magento payment gateway custom method return

September 8, 2026 · Illustrated author avatarBy Stefan Bogdanescu
magento payment gateway custom method return

Handling Payment Gateway Returns in Magento: A Comprehensive Guide

Hello developers! Today, we’re going to tackle an important aspect of integrating payment gateways into your Magento store - handling returns from the bank or payment service provider.

Understanding the Payment Process

Before diving into the technical details, let’s first understand the flow. When a customer places an order and chooses your custom payment method (let’s call it Paysolution), you’ll need to redirect them to the Paysolution gateway for processing.

  1. The customer submits the order.
  2. Magento redirects them to the Paysolution gateway URL with all necessary data encoded in the request parameters.
  3. Paysolution processes the transaction and, if successful, redirects back to a specified return URL on your store with status information.

The Challenge: Where to Handle the Return

This is where many developers get stuck. You know how to send the customer to Paysolution, but you’re unsure what to do next - where exactly in the Magento MVC structure should you handle this return data?

Let me shed some light on that.

Creating a Custom Controller for Handling Returns

To handle the return from Paysolution, you’ll need to create a new controller in your module. Here’s how:

  1. Create the Controller Navigate to app/code/local/YourCompany/Paysolution/controllers and create a new file named “ReturnController.php”.

    app/code/local/YourCompany/Paysolution/controllers
    └── ReturnController.php
    
  2. Extend Mage_Core_Controller_Front_Action

    In your ReturnController.php, extend the core controller class:

    <?php
    class YourCompany_Paysolution_ReturnController extends Mage_Core_Controller_Front_Action
    {
        // Your code here.
    }
    
  3. Handle the indexAction method This is where you’ll retrieve data from Paysolution’s return URL parameters and update your order status accordingly.

    public function indexAction()
    {
        $orderId = $this->getRequest()->getParam('transaction_id');
        $status  = $this->getRequest()->getParam('status');
    
        // Load the order by ID.
        $order = Mage::getModel('sales/order')->load($orderId);
    
        if ($order && $order->getId()) {
            // Update the order status based on the Paysolution return status.
            if ($status == 'success') {
                $order->setState(Mage_Sales_Model_Order::STATE_PROCESSING, true);
                $order->addStatusHistoryComment('Payment accepted by Paysolution.', false);
            } elseif ($status == 'failure') {
                $order->setState(Mage_Sales_Model_Order::STATE_CANCELED, true);
                $order->addStatusHistoryComment('Payment declined by Paysolution.', false);
            }
    
            // Save the order.
            $order->save();
        }
    }
    
  4. Configure the Return URL in Paysolution

    In your Paysolution account settings, configure the return URL as follows:

    https://your-magento-store.com/paysolution/return
    

Conclusion: Redirecting Customers After Payment Processing

Now that you’ve implemented this custom controller, when a customer submits an order and is redirected to Paysolution for processing, Paysolution will redirect back to the configured return URL after processing.

The indexAction method in your ReturnController.php file will then retrieve the order ID and status from the return parameters, update the order accordingly, and save it. This ensures that your Magento store maintains accurate order statuses based on Paysolution’s transaction results.

Remember to clear your cache (mage cache:clean) after creating or updating any controller files in your module.

Happy coding! If you found this guide helpful, share it with your fellow developers. And if you’re looking for more advanced Magento tutorials and resources, be sure to check out Laravel Company’s blog. We cover everything from Magento extensions to custom development best practices.

Extensions Orders Customers Import/Export

Our network