Using cross-sells gives customers the option to purchase other related products at Checkout. Cross-sells can increase your average order value and revenue.
For Checkout to offer a product as a cross-sell the product must meet the following criteria:
- Product The Product must contain a single Price.
- Currency The currency of the Price must match the currency of the other Prices in the Checkout Session.
- Recurring If the Price is recurring, the Checkout Session must be in subscription mode and the recurring interval must match the recurring interval of the other Prices in the Checkout Session.
- Upsell The Checkout Session must not also contain a subscription upsell. Currently cross-sells aren’t supported in Checkout Sessions with a subscription upsells.
Create a cross-sell
You can configure a cross-sell in the Dashboard on the Product details page. Visit the Product details page for the product from which you want to cross-sell another complimentary product. You’ll see a Cross-sells section with a dropdown menu containing your other Products. Select a Product with a single Price. After you configure it, all eligible Checkout Sessions cross-sell the product selected from the dropdown menu. For example, a customer purchasing a Starter Product would be cross-sold a Setup Fee.
In Checkout, buyers see an option to add the cross-sell to their purchase. If buyers add the cross-sell to the Checkout Session, they can also remove it. If they remove it, the option to add the cross-sell appears again.
Retrieve Checkout Session line items
After a customer adds a cross-sell, the
line_items for the Checkout Session update to reflect the addition. When fulfilling your order using the
checkout.session.completed webhook, make sure to retrieve the line items.
Remove a cross-sell
To remove a cross-sell, click the x next to it. After you remove it, the product won’t be offered to any new Checkout Sessions.