We’re adding a highly requested new parameter to the PriceRule API - allocation_limit. This new parameter represents the number of times the discount can be applied to the cart, if eligible. This additional parameter will only be available for Buy X Get Y discount types.
For example: a “Buy 1 Hat Get 1 Hat For Free” discount can be applied 2 times on a cart having more than 4 hats, where maximum of 2 hats get discounted - if the allocation limit is 2.
If no allocation_limit is specified, the discount will default to unlimited uses. This means that if your app is relying on current behaviour and you do not utilize this new parameter, it will take on this default to unlimited uses.
Apps that have created a Buy X Get Y discount type have been notified via email to their Partner account. If your app is creating these discounts and you have not received the email, please reach out to email@example.com.
Timeline for this new feature:
Thursday Aug 9th - Devs can request this parameter be enabled for their application when they are ready to start utulizing it. Email firstname.lastname@example.org
Mon Sep 10 - The parameter will be active for all applications.