User Manual - Store Credit and Refund
- Installing Store Credit and Refund
- Uninstalling
- Introducing Store Credit and Refund
- Compatibility
- Extension Settings
- Issuing Refunds
- Manual Transactions
- Tracking Customer Balance
- Customer Account Section
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
- Backup your web directory and store database
- Download the Store Credit and Refund installation package
- Upload contents of the Store Credit and Refund installation package to your store root directory
- 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 |
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> |
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 |
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 |
1.1.9 and earlier versions |
2.3.Х - 2.3.6 2.4.0 - 2.4.3 |
As of version 1.1.10 |
2.4.0 - 2.4.4 |
As of version 1.1.11 |
2.4.4 - 2.4.6 |
As of version 1.2.2 |
2.4.5 - 2.4.7 |
The PHP version depends on your current Magento version. Please, refer to your Magento version release notes.
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 IssuesThe 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
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:
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:
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.
Already used our product?
We would appreciate your feedback. Please, leave a review.