Promotion codes, upsells, and optional items

You can use Payment Links and the Stripe Dashboard to offer discounts, allow customers to upgrade their subscriptions, and market related products during checkout.

Add promotion codes

When you create a payment link in the Stripe Dashboard, you have the option of adding promotion codes. Customers can enter these codes on their payment page to apply discounts on their purchases.

Create a promotion code in the Dashboard by creating a coupon and then turning it into a customer-facing promotion code. Use the prefilled_promo_code URL parameter to prefill a promotion code when sharing a payment link. Learn more about how to generate promotion codes for Checkout.

Increase revenue potential with subscription upsells

Subscription upsells give customers the option to upgrade to a longer-term plan during checkout, such as progressing from monthly to yearly. This strategy might enhance your average order value and improve your cash flow.

You can configure a subscription upsell in the Dashboard on the Price detail page. You can view the details for a price by clicking on one you’ve added to a product. You’ll see a list of eligible upsell prices in the dropdown menu. After you select an upsell, it immediately applies to eligible payment links that use that price.

To set up a subscription upsell:

1. Choose a subscription under Subscriptions, navigate down to Pricing.
2. Use the overflow menu to select View price details.
3. Navigate down to Upsells, and in the Upsells to dropdown menu, select or add a price.

Offer optional items

You can offer up to 10 optional items on your payment link. Optional items allow your customers to purchase additional products before checking out. You can offer multiple products, and specify initial or adjustable quantity.

Dashboard

When you create a payment link in the Stripe Dashboard, you can click + Add recommended products to add up to 10 optional products to the payment link.

API

You can also create or update payment links with optional items through the API.

await stripe.paymentLinks.create({
  // ...
  line_items: [
    {
      price: '{{PRICE_ID}}',
      quantity: 1,
    },
  ],
  optional_items: [
    {
      price: '{{OTHER_PRICE_ID}}',
      quantity: 1,
    },
    {
      price: '{{ANOTHER_PRICE_ID}}',
      quantity: 1,
      adjustable_quantity: {
        enabled: true,
        minimum: 0,
        maximum: 10,
      },
    },
  ],
});

Add a product-associated optional item

Use cross-sells to specify complementary products that you always want recommended as optional items at checkout. When you configure a cross-sell associated with a product, the optional item appears across all eligible payment links with that product. Cross-sells won’t appear if you specify additional optional items on a payment link.

To configure a cross-sell:

1. On the Product catalog page, select your product.
2. On the product details page, under Cross-sells, find the product you want to cross-sell.

After you configure a cross-sell, the payment links that contain your designated product automatically add the cross-sell as an optional item.