Mercury:Manual: Difference between revisions

From Esoul Wiki
Jump to navigation Jump to search
Line 75: Line 75:
</pre>
</pre>


It's notable that all the discounts are calculated after the tax if specified. Please also be aware that there are ceilings in the calculation, the final discount could be slightly higher than the specification.
It's notable that all the discounts are calculated after the tax if specified. Please also be aware that there are ceilings in the calculation, the final discount could be slightly higher than the specification. It's most important when you sell an article with very low price near the minimal unit (e.g. $0.01), please read the next sections for details.
 


''* The examples are helping you to understand the discount. In the actual invoice, the discount won't be listed as a single amount but distributed to the articles.''
''* The examples are helping you to understand the discount. In the actual invoice, the discount won't be listed as a single amount but distributed to the articles.''

Revision as of 06:28, 16 July 2025

Website Setup

Shop Setup

Shop Management

Order

Coupon

A coupon is an one-time random code, which is often used as discount code in digital or printed form. A user can apply the code by entering it in the order process to get the specified discount (see detailed description below).

Each code has it's own start time and end time (expiration time). A user can only apply a code in this time interval.

Mercury allows to apply multiple coupons (no matter if they're in the same group or not) unless a coupon is declared as exclusive. You can limit the total discount of multiple coupons with coupon permissions, which is described later.

To create a coupon, you have to create a coupon group at first, which contains codes with same settings (name, amount, etc.). Then you can add codes to the group. There's an export function allowing you to export multiple codes to CSV table.

Please protect the codes carefully to avoid any illegal usage.

Detailed Application Rules

Each coupon has four core parameters: service, discount rate, minimal discount, and maximal discount.

When submitting an order, the system calculates the total price of all articles belonging to the specified service as the base.

Then the discount rate of base will be reduced. For example when a coupon with 10% rate of an order of $10 is applied, the discount will be 10% x $10 = $1, the final amount will be (1 - 10%) x $10 = $9 as shown in the table below. Below is another example *.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon [service: 'food', discount rate: 10%, minimal discount: $0, maximal discount: $100]

Final                       $ 14
Discount                    $ -0.4
Final after Discount        $ 13.6

If the discount is less than minimal discount, the coupon is still applied but the discount is set to $0. In the above example, if the minimal discount is set to $2, then the final amount will be $10. Below is another example *.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon [service: 'food', discount rate: 10%, minimal discount: $1, maximal discount: $100]

Final                       $ 14
Discount                    $  0
Final after Discount        $ 14

If the discount is more than maximal discount, the coupon is still applied but the discount is limit so that the discount is not larger than the specified value. In the above example if the maximal discount is set to $0.5 and minimal discount is unset (or set to $0), then the discount will be 5% x $10 = $0.5 and the final amount will be (1 - 5%) x $10 = $9.5, or calculate in this way $10 - $0.5 = $9.5 since the original discount $1 is larger than $0.5. Below is another example *.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon [service: 'food', discount rate: 10%, minimal discount: $0, maximal discount: $0.2]

Final                       $ 14
Discount                    $ -0.2
Final after Discount        $ 13.8

When multiple discounts are applied, the discount is calculated separately from the base.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon1 [service: 'food', discount rate: 10%, minimal discount: $0, maximal discount: $0.2]
Coupon2 [service: 'food', discount rate: 20%, minimal discount: $0, maximal discount: $100]

Final                       $ 14
Discount from Coupon 1      $ -0.2
Discount from Coupon 2      $ -0.8
Final after Discount        $ 13

It's notable that all the discounts are calculated after the tax if specified. Please also be aware that there are ceilings in the calculation, the final discount could be slightly higher than the specification. It's most important when you sell an article with very low price near the minimal unit (e.g. $0.01), please read the next sections for details.


* The examples are helping you to understand the discount. In the actual invoice, the discount won't be listed as a single amount but distributed to the articles.

Distribution of Discount and Handling of Returns

The above examples are helping you to understand the discount. In the actual us

Define Permissions

Handling of Returns

Voucher

A voucher is an one-time random code, which is often used as gift card in digital or printed form. A user can apply the code by entering it in their user center to get the specified amount of money assigned to their balance. The balance can be used later to pay the order fully or partially.

Each code has it's own start time and end time (expiration time). A user can only apply a code in this time interval.

To create a voucher, you have to create a voucher group at first, which contains codes with same settings (name, amount, etc.). Then you can add codes to the group. There's an export function allowing you to export multiple codes to CSV table.

Mercury is ready to sell digital products. You can sell the generated voucher code as digital gift cards.

Please protect the codes carefully to avoid any illegal usage .