My Cart

User Manual - Store Credit and Refund

Magento 2 Store Credit and Refund introduces store credits that can be beneficially utilized by shoppers towards purchases. The Admin can monitor transactions and other statistics of individual customers; refund orders automatically into store credits, apply for credit on shipping and tax, send automatic store credit notifications by email, etc. 

API documentation link

 

Installing Store Credit and Refund

Command Line Installation

  1. Backup your web directory and store database
  2. Download the Store Credit and Refund installation package
  3. Upload contents of the Store Credit and Refund installation package to your store root directory
  4. In SSH console of your server navigate to your store root folder:
cd path_to_the_store_root_folder

run the following command:

php bin/magento module:enable Aheadworks_StoreCredit

php bin/magento module:enable Aheadworks_StoreCreditGraphQl

then:

php bin/magento setup:upgrade

after:

php bin/magento setup:static-content:deploy -f

5. Flush store cache; log out from the backend and log in again

Make sure the installation is done from the FTP administrator account. Otherwise, set 775 permissions to the store root directory after the extension is deployed.

Composer Installation

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

1. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

Run the following command:

composer config repositories.aheadworks composer https://dist.aheadworks.com/

On successful execution of the command you will be able to use the composer to install the extensions.

To install the extension:

2. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

 3. Run the following command to install the latest version of the extension:

composer require aheadworks/module-store-credit

if you need to install a specific version, run this command:

composer require aheadworks/module-store-credit:<version>

 

Specify the version of the extension in <version>

When prompted, enter Public Key (Username) and Private Key (Password):

Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site:

Run the following command to install Store Credit and Refund GraphQl:

composer require aheadworks/module-store-credit-graph-ql

4. Enable the extension:

php -f bin/magento module:enable <Module_Name>

php -f bin/magento module:enable Aheadworks_StoreCreditGraphQl

 

Add the product name in <Module_Name>

Next, register the extension:

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

bin/magento module:status

Clean store cache, by running the following command:

bin/magento cache:clean

Log out and Log in the backend again.

Want to use the Hyvä theme module?

To install the Hyvä theme module, you need to install the module via composer using command:

composer require hyva-themes/magento2-aheadworks-store-credit

To upgrade the extension:

5. To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

Update per module name:

composer update aheadworks/module-store-credit

Updater per version:

composer require aheadworks/module-store-credit:<version>

Run the following commands to upgrade, deploy, and clean the cache.

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Uninstalling

Since Magento introduced declarative Database you need to be very carefull when uninstalling or disabling the module.

NOTE: Please be very careful when uninstalling/disabling this module. This module uses a declarative DB scheme. Once the module is uninstalled the DB tables will be lost.

Manual Removal

1) Run command: 

bin/magento module:uninstall --non-composer Aheadworks_StoreCredit

It will remove hide price attributes from the system (e.g. eav_entity_type table).

2) Disable extension: 

bin/magento module:disable Aheadworks_StoreCredit

3) Run setup upgrade: 

bin/magento setup:upgrade

It will remove module related tables from the system (hp_rule_entity, hp_rule_product, etc).

4) Remove module files manually: 

app/code/Aheadworks/StoreCredit

Automatic Removal (via Composer)

1) Disable extension:

bin/magento module:disable Aheadworks_StoreCredit

2) Run setup upgrade: 

bin/magento setup:upgrade

3)

php bin/magento module:uninstall Aheadworks_StoreCredit

 

 

 

Compatibility

Module Version 

Magento Version 

PHP 

1.1.9  and earlier versions

2.3.Х - 2.3.6

2.4.0 - 2.4.3

7.4 and earlier versions

As of version 1.1.10

2.4.0 - 2.4.4

7.4, 8.1

As of version 1.1.11

2.4.4 - 2.4.6

8.1

 

 

 

Introducing Store Credit and Refund

Overview

Store Credit and Refund extension allows processing refunds and promoting additional sales with the in-store currency - the store credit:

  • Automatic refunding of orders into store credit;
  • Email notifications;
  • Manual updates and mass actions;
  • Credit balance at the storefront pages;
  • Prices, discounted by store credit;
  • Credit checkout;
  • Dedicated customer account section;
  • Integration with Smart One Step Checkout.

Short Description

The extension introduces an in-store currency - the store credit. Store credits can be used to refund orders and award customers on various occasions. To issue a refund, the Store-owner proceeds to the credit memo of the order and clicks the' Refund' button, 'Refund to store credit' checkbox is ticked by default. The order is then refunded in full to the Customer, who can spend credits towards the purchase of any product in the store.

On Backend, Store Credit and Refund offers two grids: 'Transactions' and 'Customers'. The former provides an overview of all credit transactions and allows adding/subtracting store credit from customer accounts either one by one or via mass actions. The Customers grid provides an overview of customer store credit balances. It, furthermore, comes with reference links to customer accounts.

On Frontend, the extension adds a dedicated section to the customer's account. In the 'Store Credit & Refund' section customer can track all credit transactions and subscribe to credit balance updates. In addition, the store credit balance of the customer can be displayed in the header of all store pages. Moreover every product page can have a price discounted by the available store credit displayed.

Known Issues

The present version of the extension (v. 1.1.6) does not support Multishipping Addresses Checkout (store credit balance is not shown on the Checkout page and can not be applied).

Integrations

What's New?

As of version 1.1.8 the present extension enables the following:

  • Integration with OSC 2.0.0

 

Extension Settings 

Before using the extension the Storeowner proceeds to the extension settings page that can be found at Stores → Configuration → Aheadworks Extensions → Store Credit and Refund.

General

General settings control default extension's behavior and define how the store credit should be applied to orders:

  • Allow applying Store Credit on Shipping - if enabled customers can pay for shipping with store credit;
  • Allow applying Store Credit on Tax - if enabled customers can pay order taxes with store credit;
  • Refund to Store Credit Automatically - if enabled the checkbox 'Refund to Store Credit' at the credit memo page is ticked by default allowing one click refunds.

Storefront

Storefront section controls the extension's behavior on the Frontend and where the extension blocks are displayed:

  • Store Credit Balance in Top Link - defines if the available store credit balance of the customer is displayed in the page header;
  • Hide the top-link if Store Credit balance is empty - defines if 'Store Credit Balance in Top Link' is displayed if customer does not have store credit available;
  • Display prices discounted by available Store Credit - defines if the notification on how much customer can save by paying with credit balance is displayed below product price.

Click to see how it works on the frontend

 

The present version of the extension (v. 1.1.6) does not support Multishipping Addresses Checkout (store credit balance is not shown on the Checkout page and can not be applied).

Email Notifications

Email Notifications controls how the credit balance updates are delivered to customers:

  • Subscribe Customers to Store Credit Notifications by Default - is enabled all customers will receive email notifications on credit balance updates;
  • Sender - defines the email address from which all email notifications are sent;
  • Balance Update - defines the email template of the balance notifications;
  • Store Credit Balance Notifications Sent When - defines on what conditions the balance updates are sent:
    • Balance adjusted by admin;
    • Order cancelled;
    • Refund by Store Credit;
    • Reimburse of spent Store Credit;
    • Store Credit used in order.

To change the email template the Storeowner navigates to Marketing → Email Templates, creates new template and in the field 'Template' selects Aheadworks_StoreCredit > Balance update template to save as new.

Store Credit spent on the cancelled order is refunded automatically to the Customer's balance.

Once done with the settings the Storeowner clicks on the Save Config button to apply the changes made.

 

 

Issuing Refunds

To issue a refund to store credit Storeowner navigates to the required order at Sales > Orders and proceeds to the Credit Memo of the order.

At the bottom of the page the Storeowner can see a 'Refund to Store Credit' checkbox with a field allowing for manual store credit input:

  • By default the Grand Total value of the order is specified in the field;
  • If required the Storeowner can specify any value from 0 to Order Grand Total to partially refund order to store credit;
  • Refund to Store Credit field value cannot exceed Order Grand Total value.

 

 

Manual Transactions

Store Credit and Refund extension supports manual transactions allowing the storeowner updating customer's credit balance whenever required. To manually update credit balance the storeowner navigates to Marketing → Store Credit & Refund by Aheadworks → Transactions.

Transactions grid comes with the following interactive elements:

  • "Columns" button allows customizing the grid look by hiding, applying columns. Some columns may be excessive and some relevant to the current tasks;
  • "Filters" button allows looking for particular transactions depending on the filters selected;
  • "Defaoylt View" button allows saving the perfect grid look to quickly load it whenever required.

To add new transaction the storeowner clicks on the Add New Transaction button.

Store Credit and Refund extension supports manual transactions allowing the storeowner updating customer's credit balance whenever required. To manually update credit balance the storeowner navigates to Marketing → Store Credit & Refund by Aheadworks → Transactions.

Transactions grid comes with the following interactive elements:

  • The Columns button allows customizing the grid look by hiding, applying columns. Some columns may be excessive and some relevant to the current tasks;
  • The Filters button allows looking for particular transactions depending on the filters selected;
  • The Default View button allows saving the perfect grid look to quickly load it whenever required.

To add new transaction, the Admin clicks on the Add New Transaction button in the top right of the page.

At the New Transaction page the Admin specifies:

  • Website - the store view the transaction should be made for;
  • Balance adjustment value - how much store credit should be added/subtracted from customer(s) account(s);
  • Comment (visible for customer) - a short message on the transaction for customer;
  • Comment (visible for admin only) - a short message for the store administrator.

When done with the transaction options the Admin is suggested to select customer(s) by clicking on the Add Customers button. Once customer(s) is selected the Admin clicks on the Save Transaction button.

New transaction is now displayed in the Transactions grid.

 

 

Tracking Customer Balance

For the performance tracking and understanding how many customers have active store credit balance the extension introduces Customers grid that can be accessed via Marketing Store Credit & Refund by Aheadworks Customers.

The grid comes with the same interactive elements as Transactions grid. Here the storeowner can get an overview of the store credit earn-spent history and see if customer(s) is subscribed to the balance updates.

 

 

Customer Account Section

Store Credit and Refund extension introduces its section to the customer account dashboard.

At the Store Credit & Refund section customers can find the following:

  • Current store credit balance;
  • All store credit transactions;
  • Order references;
  • Subscription to store credit balance updates.

 

Product Page

Write Your Own Review

Already used our product?

We would appreciate your feedback. Please, leave a review.

Only registered users can write reviews. Please Sign in or create an account
Report incorrect information

Still Have Questions?

Our customer care team is here for you!

Contact Us