Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
    Overview
    Create a payment link
    Share a payment link
    Track a payment link
    Create a buy button
    Customize checkout for payment links
    Collect addresses
    Charge for shipping
    Promotion codes, optional items, and upsells
    After you receive payment from a payment link
    Use the API to create and manage a payment link
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
Other Stripe products
Financial Connections
Crypto
Climate
HomePaymentsUse Payment Links

Promotion codes, upsells, and optional items

Use Payment Links to add promotion codes, upsells, and optional items to offer discounts and help market related products.

Copy page

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.

Note

By default, payment links create guest customers for one-time payments. As a result, promotion codes that are only eligible for first-time orders won’t work as expected.

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.

Customers can add optional items to their order during checkout.

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.

server.js
Node
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.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc
Related Guides
Subscription upsells
Products Used
Payments
Payment Links