Product Discounts

After you configure pricing for a product or subscription, you can apply a custom discount to it. Each customer receives the discount at checkout.

For each discount, you can specify start and end dates and the number of rebills it applies to. Unlike coupons, product-level discounts can vary by the quantity selected.

You can retrieve discount information from the order.completed webhook and the /orders API endpoint.

Note: To apply multiple discounts to a single product, select the Combine Discounts checkbox when you edit the discount, and configure a coupon.

The sections below explain how to discount a product and a subscription. Select a section or use the TOC on the right to jump ahead.

Discount a product

To discount a product:

1. Go to the details page of the product you want to discount (Catalog > One-Time Products), or create a new product.

2. In the Discount section, click Edit. The Edit Discount dialog opens.

3. Under Discounted Price, select Standard to apply one discount to every purchase, or Volume to set discounts by quantity.

4. In the drop-down, select Percent Off or Amount Off, then enter the discount:

   • Percent Off: Enter a discount percentage, up to 100%.
   • Amount Off: Enter the amount to deduct in your base currency. Optionally, enter amounts for other currencies. Currencies left on Auto are converted from your base currency.

   If you selected Volume, enter the minimum quantity a customer must buy to receive each discount. To add another quantity, click + Add Quantity. To remove one, click the trash icon next to it.

5. To limit when the discount applies, under Discount Dates, select the Limit Discount Availability by Dates (UTC Time) checkbox and enter the start and end dates in UTC. Customers who purchase the product outside of the date range do not receive a discount. If you leave the checkbox cleared, the discount is valid indefinitely.

6. Optionally, under Discount Reason, enter a customer-facing message of up to 255 characters. Customers see it during checkout. To add the message in other languages, use the language drop-down.

7. Click Save.

Discount a subscription

To discount a subscription:

1. Go to the details page of the subscription you want to discount (Catalog > Subscription Plans), or create a new subscription.

2. In the Discount section, click Edit. The Edit Discount dialog opens.

3. Under Discounted Price, select Standard to apply one discount to every purchase, or Volume to set discounts by quantity.

4. In the drop-down, select Percent Off or Amount Off, then enter the discount:

   • Percent Off: Enter a discount percentage, up to 100%.
   • Amount Off: Enter the amount to deduct in your base currency. Optionally, enter amounts for other currencies. Currencies left on Auto are converted from your base currency.

   If you selected Volume, enter the minimum quantity a customer must buy to receive each discount. To add another quantity, click + Add Quantity. To remove one, click the trash icon next to it.

5. In the Discount Duration field, enter the number of subscription charges the discount applies to, up to 100. The count includes the initial purchase: 1 applies the discount to the first payment only, 2 to the first payment and the next rebill, and so on. Leave the field set to All to discount every charge.

   Note: If the subscription's Length is set to Rebill for a number of periods, the discount duration can't be more than that number.

6. To limit when the discount applies, under Discount Dates, select the Limit Discount Availability by Dates (UTC Time) checkbox and enter the start and end dates in UTC. Customers who purchase the subscription outside of the date range do not receive a discount. If you leave the checkbox cleared, the discount is valid indefinitely.

7. Optionally, under Discount Reason, enter a customer-facing message of up to 255 characters. Customers see it during checkout. To add the message in other languages, use the language drop-down.

8. Click Save.