Create Promo Code List
Promo code lists contain large sets of promo codes. When defining a promo code list, you can specify its name, its date range, the points it can aware, and, perhaps most importantly, whether the list is for single-use, multi-use, or third-party promo codes.
Single-use codes are randomly generated and unique; they can be claimed only once. Setting the codes for single use is an excellent way to target the use to a very specific set of customers.
Alternatively, multi-use codes can be claimed multiple times. For this type of list, you can set a cap on the list and thereby help prevent fraud and limit liability. Codes acquired from a third party provider can also be assigned to a promo code list. They can then be activated and validated when a customer entes a promo code value.
For more information on choosing a promo code type, see Step 1 of the Create promo code procedural document.
Sequence Diagram
See the overall flow for this task below.
Best Practices
As you build applications or web sites that implement SessionM APIs to support promo codes, bear in mind these best practices:
- You may want to consider using caps to limit the number of claims against a list or a promo code. Doing so limits liability because you are capping the maximum amount of money that can be spent on a given promo code or promo code list.
- Caps limit the number of successful code entries for the life of a specific promo code list.
- When defining the request object for the endpoint that creates a promo code list using
POST /priv/v1/apps/:api_key/promotions
, you can specify a value forglobal_entry_cap
, which sets a maximum number of codes that can be redemeed for a promo code list.