Use promotion codesBeta
Allow your customers to enter promotion codes at checkout.
Private preview
The Custom Checkout integration is in private preview. To request access, click here.
Create a promotion code
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
Enable user-redeemable promotion codes by specifying the allow_promotion_codes parameter when creating the Checkout Session.
Use promotion codes
Use applyPromotionCode to apply a promotion code that your customer enters. Use removePromotionCode to remove all previously applied promotion codes.
Restrict usage
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).