--- schema_version: "1" id: 580bcdd111c2309fb4c204bd428c531a76d05b8cc13f9535157fe083b158dd3d title: Coupon Usage APIs collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/global_promotions_management_run_pricing_coupon_usage_api.md canonical_url: https://help.salesforce.com/s/articleView?id=mktg.global_promotions_management_run_pricing_coupon_usage_api.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: b96354171611302ca819f800623cefcc80dbd0b868dff3f5427e54bcf33a684f description: Use the Coupon Usage APIs to accurately track the usage of coupons by customers. When customers select a coupon for their cart, use the Coupon Usage Increase API to increase the coupon usage count. If a customer removes a selected coupon from their cart, use the Coupon Usage Decrease API to revert the coupon usage count. products: - Marketing release: "264" --- # Coupon Usage APIs Use the Coupon Usage APIs to accurately track the usage of coupons by customers. When customers select a coupon for their cart, use the Coupon Usage Increase API to increase the coupon usage count. If a customer removes a selected coupon from their cart, use the Coupon Usage Decrease API to revert the coupon usage count. ### Required Editions
Available in: Lightning Experience
Available in: Enterprise, Unlimited, and Developer Editions with Real-Time Offer Management
## Coupon Usage Increase API The API manages coupon redemptions by tracking the overall usage and per customer usage of each coupon. When a customer selects a coupon that they want to apply to their cart for a promotion, run the Coupon Usage Increase API to redeem the selected coupon for the customer. The API increases the overall usage count of the coupon and the customer's usage count of the coupon. The API response provides detailed information about the coupon including the updated usage count, the coupon's redemption limit, and the remaining number of redemptions available for the coupon and the customer. ## Coupon Usage Decrease API Use the Coupon Usage Decrease API to reduce the usage count of coupons when customers deselect a coupon from their cart. The Coupon Usage Decrease API can also be used to decrease the coupon usage count when a transaction fails or is canceled. The API response provides detailed information about the coupon for which the usage count has been decreased. The information also includes the coupon's updated redemption limit and the remaining number of redemptions available for the coupon and the customer. ![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-real_time_offer_management-264-0-0-production-enus/9bd7649d-776f-43e6-b210-f781a48bbc79/images/icon_example.png) Example The marketing managers at Cloud Kicks have created a promotion for Sneakerheads, offering a US$50 discount on sneakers with a minimum purchase of $100 at the store. The coupon for this promotion can be redeemed up to 15,000 times in total, with a limit of 5 redemptions per customer. When a customer successfully makes a purchase by using the coupon, use the Coupon Usage Increase API to update the redemption count for the coupon. `[ { "couponCode": "SNEAKER50", "isSuccess": true, "redemptionLimit": 15000, "redemptionLimitPerCustomer": 5, "remainingRedemptionCount": 13447, "remainingRedemptionCountForCustomer": 2 } ]` The SNEAKER50 coupon was initially selected but the customer removed it from their cart later. Use the Coupon Usage Decrease API to revert the count. The result shows that there are still 13,448 redemptions left overall and 3 remaining for this particular customer. `{ "couponCode": "SNEAKER50", "isSuccess": false "redemptionLimit": 15000, "redemptionLimitPerCustomer": 5, "remainingRedemptionCount": 13448, "remainingRedemptionCountForCustomer": 3 } ]`