Credit notes

Grant credit notes to customers, generating a coupon code.



  • Copy the module into <thelia_root>/local/modules/ directory and be sure that the name of the module is CreditNote.
  • Activate it in your thelia administration panel


Add it in your main thelia composer.json file

composer require thelia/credit-note-module:~1.0


From an order page in the back-office, in the modules tab, you can grant a new credit note by inputting an amount (in the order's original currency) and optionally a message for the customer. A coupon code will be created that can be redeemed by the customer for this amount. An email will be sent to the customer to notify him.

Existing credit notes are displayed in several places:

  • the order page list all existing credit notes for this order
  • the total amount granted in credit notes is displayed in the orders list
  • a link to the corresponding order is added to the coupons list, if the coupon is a credit note


Some options are available in the module configuration page:

  • the validity period of the generated coupons (default: 365 days)
  • the prefix of the generated coupon codes (default: CREDIT)
  • whether the generated coupons should be restricted to the customer that initially placed the order (default: yes)


Create a credit note from an order

use CreditNote\Event\OrderCreditNoteEvent;
use CreditNote\Event\OrderCreditNoteEvents;

$event = (new OrderCreditNoteEvent())
    ->setAmount(20) // in the order's currency

$dispatcher->dispatch(OrderCreditNoteEvents::CREATE, $event);



Lists credit notes on orders.

Input arguments

Argument Description
id Id or list of ids of credit notes
order_id Id or list of ids of the associated order(s)
coupon_id Id or list of ids of the generated coupon(s)
order Order of the results
lang Locale of the results

Where order is one of the following:

  • id (default)
  • id-reverse
  • order_id
  • order_id-reverse
  • coupon_id
  • coupon_id-reverse
  • amount
  • amount-reverse
  • message
  • message-reverse

Output arguments

Variable Description
$ID Id
$ORDER_ID Id of the associated order
$COUPON_ID Id of the generated coupon
$AMOUNT Credit note amount (in the associated order's currency)
$MESSAGE Localized message associated to the credit note
$LOCALE Locale of the results

Mail templates


Template used to notify customers that they have been granted a new credit note from an order.


Credit notes

Grants credit notes to customers, generating a coupon code

Compatibility :

Thelia 2.1

Compatibility :

Thelia 2.2

Compatibility :

Thelia 2.3

Author :

Say Hi & Get in Touch - +33(0)4 44 05 31 00

Thelia Network English
E-commerce solution

E-commerce software, useful to create and manage online stores, published under a free license. Discover our new version, based on many modern technologies !

Download Thelia

A team of experts at your service.


Over 7000 online stores powered by Thelia


Customize your Thelia.


Thelia editor