Use promotion codesBeta
Allow your customers to enter promotion codes at checkout.
Beta
The Custom Checkout integration is in private beta. To request access, click here.
Create a promotion code![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Create a promotion code by specifying an existing coupon
and a customer-facing code
to give to your customer.
If you don’t provide a code, Stripe generates a random one for you. The code is case-insensitive and unique across active promotion codes for any customer.
Promotion codes can be created in the coupons section of the Dashboard or with the API:
Enable promotion codes![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Enable user-redeemable promotion codes by specifying the allow_promotion_codes parameter when creating the Checkout Session.
Use promotion codes![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Use applyPromotionCode to apply a promotion code that your customer enters. Use removePromotionCode to remove all previously applied promotion codes.
Restrict usage![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can restrict how promotion codes are used when creating a promotion code:
- Specify customer to restrict usage to a single customer.
- Specify expires_at to set a date at which the promotion code can no longer be redeemed.
- Specify max_redemptions to limit the number of times the promotion code can be redeemed.
- Specify restrictions.minimum_amount and restrictions.minimum_amount_currency to set a minimum amount required to redeem this promotion code (e.g. a purchase must be $100 or more to work).