Add discountsBeta

You can use discounts in Checkout to reduce the amount charged to a customer for one-time payments. Coupons and promotion codes can:

• Apply a discount to an entire purchase subtotal
• Apply a discount to specific products
• Reduce the total charged by a percentage or a flat amount
• Create customer-facing promotion codes on top of coupons to share directly with customers

Coupons and promotion codes

A Coupon represents a percent-off or amount-off discount. A Promotion Code represents a customer-redeemable code for a coupon. A single coupon can have multiple promotion code associated to it.

With Custom Checkout, you can either apply a coupon to the session ahead of time or allow your customers to enter promotion codes at checkout.

Create a coupon

Create coupons in the Dashboard or with the API:

curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d duration=once \
  -d id=free-period \
  -d percent_off=100

You can choose between a fixed amount discount and a percentage discount by choosing amount_off or percent_off.

If discounting a subscription, you can use the duration and duration_in_months parameters to configure how the coupon applies to subsequent charges in the subscription. The default is a one-time discount.

After creation, only the name of the coupon is editable.