[ Web Proxy ]
URL:
Viewing: https://developer.paddle.com/api-reference/discounts/ [Back]  [Original]

Discounts | Paddle Developer Docs

For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling append .md to any URL.

Skip to content
Paddle Docs home
Search Ask AI Toggle Theme svg]:px-3 hidden md:flex" href="https://login.paddle.com/start" data-auth-button="true" data-login-url="https://login.paddle.com/start" data-dashboard-url="https://vendors.paddle.com" data-dashboard-api="https://api.paddle.com/userinfo" data-astro-cid-mq3pp5jd="true"> Login

API reference

Overview

Discounts

Discount entities describe percentage or amount-based discounts for transactions. They're sometimes called coupons or promo codes.

Discounts let you reduce a transaction total by a percentage, a flat amount per transaction, or a flat amount per unit on a transaction.

Discount entities hold information like:

  • How the discount reduces the total of the transaction.
  • Whether the discount is one-time or recurring.
  • When the discount is valid to.
  • Which items in your catalog the discount applies to.
  • Whether this discount can be applied by customers using a code.

Discounts work with prices, transactions, checkouts, and subscriptions.

By default, discounts apply to the entire value of a transaction. You can link discounts to price entities to limit them to certain prices. For example, you can create a discount for subscription plans that won't work on other items.

Use discount codes to let customers apply discounts themselves at checkout, or pass a discount to a checkout to apply it automatically.

Discounts don't have to have codes. They can be applied manually to transactions as part of the sales process.

Discounts can be added to a discount group to organize them. You can only add a discount to one discount group at a time. You can list discounts by discount groups to see which discounts are in which groups.

There's no delete operation for discounts. Use the update a discount operation to archive discounts when you no longer need them. To learn more, see Delete entities

Was this page helpful?

Yes, helpfulNo, not helpfulI have feedback

Paddle.com Market Ltd. 20122026


Web Proxy Viewer  |  New URL  |  Original Page