---
schema_version: "1"
id: 151dae1948356893bd23c8801ec0dcc352abf5230eb434beb16b9502e2338a71
title: B2C Commerce APIs for Coupons
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/cc/264-0-0/b2c_apis_for_coupons.md
canonical_url: https://help.salesforce.com/s/articleView?id=cc.b2c_apis_for_coupons.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: ccbfb9f82a2d231f2507218f67685baa752a5e0ea7638c78205dd270d3dc2ecf
description: Use the B2C Commerce API to add multiple coupon codes for the same coupon to a cart.
products:
  - Commerce
  - B2C Commerce
release: "264"
---
# B2C Commerce APIs for Coupons

Use the B2C Commerce API to add multiple coupon codes for the same coupon to a cart.

The behavior controlled by this setting is enforced regardless of how the coupon is added to basket: B2C Commerce Script API, SHOP API, `AddCouponToBasket` or `AddCouponToBasket2` pipelets.

Each unique code added to a basket results in a unique `CouponLineItem` being added. Conversely, every `CouponLineItem` represents a single coupon code.

When an order is created, all coupon codes associated with the order are marked as `redeemed`.

The logic for retrieving active customer promotions is the same as for other promotions. For example, `PromotionMgr.getActiveCustomerPromotions()` returns the same information whether a promotion is triggered in the cart by one coupon code or multiple.

When using this coupon type with a [Choice of Bonus Product](https://help.salesforce.com/s/articleView?id=cc.b2c_implementing_choice_of_bonus_product_discount.htm&release=264.0.0&type=5 "There are two types of choice of bonus products in the Salesforce B2C Commerce application: rule-based and list-based. Both are configurable and require application customization.") `BonusDiscountLineItem` created by B2C Commerce is associated with the triggering coupon code. The triggering coupon code is determined by the position of the coupon code and the bonus discount line item within the basket. You can access this association via the B2C Commerce Script API, so that the storefront application can show that the bonus products relate to a specific coupon code. If a coupon code is removed from the cart, only the related bonus products are also removed from the cart.

#### See Also

- [Multi-Coupon Redemption in the Same B2C Commerce Order](https://help.salesforce.com/s/articleView?id=cc.b2c_multiple_coupons_in_a_basket.htm&language=en_US)