Skip to content

Discounts ​

A discount represents the actual application of a coupon or promotion code. It contains information about when the discount began, when it will end, and what it is applied to.

Related guide: Applying discounts to subscriptions

Endpoints ​

Delete a customer discount ​

  • DELETE /v1/customers/:id/discount

Delete a subscription discount ​

  • DELETE /v1/subscriptions/:id/discount

Events ​

  • customer.discount.created Occurs whenever a coupon is attached to a customer.

  • customer.discount.deleted Occurs whenever a coupon is removed from a customer.

  • customer.discount.updated Occurs whenever a customer is switched from one coupon to another.

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18