Promo code consumption scenarios

This article explains the possible scenarios of how promo codes are consumed and how they are accounted for in each scenario.

This scenario demonstrates the behavior of a generic promo code during a successful order process.

Promo code details: Total Quantity = 10 (Available Quantity = 10, Consumed Quantity = 0)
Workflow:
1. Customer adds products to cart and applies promo code.
2. Customer proceeds to the payment page, generating a new Invoice with status "Issued." One promo code quantity is reserved, reducing the Available Quantity by 1.
3. Upon successful payment, the promo code quantities are updated as follows:
  - Total Quantity = 10; Available Quantity = 9; Consumed Quantity = 1

This scenario examines the behavior of a generic promo code when an order's invoice is cancelled.

Promo code details: Total Quantity = 10 (Available Quantity = 10, Consumed Quantity = 0)
Workflow:
1. Customer applies the promo code to the cart and proceeds to payment, resulting in the creation of a new Invoice with status "Issued" and a reserved promo code quantity.
2. The customer returns to the checkout page by clicking "Back to Checkout," changing the Invoice status from "Issued" to "Cancelled." This action releases the reserved promo code.
3. Upon returning to the Checkout page, the promo code quantities reset as follows:
  - Total Quantity = 10; Available Quantity = 10; Consumed Quantity = 0

This scenario explores the behavior of a generic promo code when an order's invoice is abandoned.

Promo code details: Total Quantity = 10 (Available Quantity = 10, Consumed Quantity = 0)
Workflow:
1. Customer applies the promo code to the cart and proceeds to payment, resulting in the creation of a new Invoice with status "Issued" and a reserved promo code quantity.
2. The customer decides not to proceed with the purchase and closes their browser window. After 15 minutes, the Invoice status changes from "Issued" to "Abandoned," releasing the reserved promo code.
3. Upon returning to the Checkout page, the promo code quantities reset as follows:
  - Total Quantity = 10; Available Quantity = 10; Consumed Quantity = 0

This case illustrates the behavior of a generic promo code in a refund scenario.

Promo code details: Total Quantity = 10 (Available Quantity = 10, Consumed Quantity = 0)
Workflow:
1. Customer adds products to cart and applies promo code.
2. Customer proceeds to the payment page, generating a new Invoice with status "Issued." One promo code quantity is reserved, reducing the Available Quantity by 1.
3. Upon successful payment, the promo code quantities are updated:
  - Total Quantity = 10; Available Quantity = 9; Consumed Quantity = 1
4. The customer requests a refund. Promo code quantities remain unchanged:
  - Total Quantity = 10; Available Quantity = 9; Consumed Quantity = 1

The availability of uniquely generated promo codes operates differently from generic promo codes. When creating a promo code with the 'Generate Unique Codes' checkbox enabled, a set number of unique codes equal to the specified total quantity are generated. These unique codes are marked as consumed at the code item level upon use and cannot be reused, thereby preventing overuse of the total available quantity.

The available and consumed quantities of uniquely generated promo codes are updated by a scheduled task that runs hourly. This update primarily serves as a visual indicator for Avalon users, as the system tracks availability and consumption at the code item level rather than the promo code level.

Additionally, it's important to note that the total quantity of uniquely generated promo codes cannot be reduced once set. This clarification should provide clarity on the functionality and limitations of these promo codes.

Last updated 6 months ago