Magento credit memo get offline or online refund status

Magento credit memo get offline or online refund status

September 3, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento credit memo get offline or online refund status

Understanding Magento Credit Memo Refund Status

As an experienced e-commerce developer, I frequently receive queries from merchants looking to customize their Magento credit memo PDFs to include additional information about refunds. One common question is how to determine whether a refund was processed online or offline.

In this guide, we will explore the available options for retrieving this information and provide practical examples of how to achieve this in your Magento 2 store.

The Challenge: Retrieving Refund Status

You’ve correctly identified that the getTotalOfflineRefunded() method might seem like a suitable approach. However, you’re facing an issue where it consistently returns null values even when offline refunds have been processed.

This leads to two main questions:

  1. Why is getTotalOfflineRefunded() not working as expected?
  2. Are there alternative methods or attributes we can use to retrieve this information?

Let’s delve into these questions and discover a robust solution.

The Solution: Utilizing the Credit Memo Object

The key lies in understanding how Magento handles refunds and their association with credit memos.

When an offline refund is processed, it creates a new entity called sales_order_refund. This entity contains information about the refund amount and whether it was processed online or offline. However, this data is not directly accessible through the creditmemo object you’re currently working with.

To retrieve the necessary information, we need to access the associated refund object(s) of the credit memo. Here’s a step-by-step approach:

  1. First, obtain the credit memo ID using your existing logic.

    $creditMemoId = 123; // Replace with actual credit memo ID
    
  2. Retrieve the credit memo object using Magento’s repository.

    $objectManager = \Magento\Framework\App\ObjectManager::getInstance();
    $creditmemoRepository = $objectManager->create('Magento\Sales\Model\ResourceModel\Order\Creditmemo\CollectionFactory');
    $collection = $creditmemoRepository->create();
    $collection->addFieldToFilter('entity_id', $creditMemoId);
    
  3. Iterate through the associated refunds and check their status.

    foreach ($collection as $creditMemo) {
        $refundCollection = $objectManager->get('Magento\Sales\Model\Order\Creditmemo\Refund')->load($creditMemo->getEntityId());
        if (count($refundCollection)) {
            foreach ($refundCollection as $_refund) {
                if ($_refund->getOfflineAllowed()) { // Check for offline refund
                    $offlineRefund = true;
                    break;
                }
            }
        } else {
            // No refunds associated with the credit memo
        }
    }
    
  4. If the $offlineRefund variable is true, it indicates that at least one of the refunds was processed offline.

Best Practices for Customizing Credit Memo PDFs

While retrieving this information, remember a few best practices:

  1. Always use Magento’s repository classes instead of direct object manager calls in your customizations.
  2. Ensure you have proper version control and backups before making significant changes to core files or extensions.
  3. Test your customizations thoroughly to prevent any unintended impacts on other store functionalities.

Conclusion

Retrieving the offline refund status from a Magento credit memo requires understanding the relationships between creditmemo, sales_order_refund, and order entities.

By following the approach outlined in this guide, you can now accurately determine whether a refund was processed online or offline. This information can then be incorporated into your custom credit memo PDF template using Magento’s template rendering system.

For more information on extending Magento’s core functionalities and creating powerful e-commerce solutions, feel free to explore our comprehensive resources at Laravel Company. We provide expert guidance, tutorials, and best practices for both beginners and experienced developers in the Magento ecosystem.

Magento 2 Database Orders Errors

Our network