Organize your discounts with discount groups

What's new?

We've released the ability to create discount groups and assign them to discounts using the Paddle API.

Grouping discounts makes them more easily identifiable and easier to manage. For example, you may create groups for specific discounts targeted at:

• Marketing and new customer prospects that would be used by the marketing team.
• Retention or loyalty that would be used by customer service or operational teams.
• Seasonal promotions or campaigns like Black Friday or Cyber Monday.

How it works

Discounts let you reduce transaction totals by a percentage or a flat amount. You can create one-time or recurring discounts, set up codes for customers to use at checkout, restrict discounts to specific products, limit their usage, or set expiration dates for promotions.

Previously, you were unable to identify and group discounts together under the use, category, or purpose of that discount unless you passed custom data. With this change, you can:

• Create a discount group
  Add a name to the discount group to easily identify the category, purpose, or other criteria that you use to group discounts.
• Assign a discount to a group
  Create or update a discount with the discount_group_id field matching the id of a discount group. Discounts can only be assigned to one discount group at a time.
• See all discounts in a group
  Use the discount_group_id query parameter when listing discounts to filter discounts by their assigned discount group.

You can also use:

• The discount_group.created webhook to get notified when a discount group is created.
• Existing discount.created or discount.updated to detect when a discount is assigned to a discount group by checking for the discount_group_id field.

Next steps

This change is available in version 1 of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

Check out the discount group entity overview and our guide on creating and assigning groups to discounts to get started.