--- schema_version: "1" id: 5c9d65880145dae5b63230ee2be9d0d5a91944777ada9855f60a491c9311e40e title: Promotion Reward Application API 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_reward_application_api.md canonical_url: https://help.salesforce.com/s/articleView?id=mktg.global_promotions_management_run_pricing_reward_application_api.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 5d08c06b7b561cf9a52ba51626dfb147d73007bc00caa52de03bc1c7a7c06aea description: Issue non-pricing rewards and update promotion and customer limits after customers place their orders. products: - Marketing release: "264" --- # Promotion Reward Application API Issue non-pricing rewards and update promotion and customer limits after customers place their orders. ### Required Editions
Available in: Lightning Experience
Available in: Enterprise, Unlimited, and Developer Editions with Real-Time Offer Management
After an order is placed, the API takes the cart's applied promotion and reward details as input. You can execute the API for contacts and accounts. If your company uses person accounts to manage customers, specify the Contact ID that's associated with the customer's person account. The API response contains the details of the pricing and non-pricing rewards provided to the customer for their order. The Promotion Reward Application API can be executed to provide these rewards: - Discounts - Vouchers - Games The Promotion Reward Application API also creates or updates the promotion’s related usage record based on the parameters present in the API request. | Parameter | Usage Records Created or Updated | | --- | --- | | rewards | Promotion Limit Usage and Promotion Party Usage records for points and vouchers. | | appliedPromotions | Promotion Party Usage records for the number of times customers have used the promotion. | Promotion Limit Usage records help track the usage of each promotion reward against the promotion’s limits. Promotion Party Usage records help track the usage of each promotion reward by customers against the promotion’s customer-level limits. The Promotion Reward Application API automatically manages these limits. - Promotion limits: - Points - Vouchers - Customer limits: - Points - Vouchers - Use per Customer You must set up processes to manage the per cart, per line item, liability, and total use limits. After the API is executed, the value of the Usage Count field in the customer's promotion party usage is incremented by 1. ![Tip](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_tip.png) Tip Apart from a promotion’s voucher and points limit, the marketing manager can add other limits for the promotion. You can set up a process to update the promotion’s usage or the promotion’s customer usage for the other promotion limits as well. ## Promotion Reward Application API for Promotions with Coupons When you run the API, specify the coupon code that the customer used for their order. The coupon code uniquely identifies the promotion that the customer used for their order. The API consists of the shouldCheckCouponUsageLimit parameter. If you already increased the usage of the coupon, set the parameter to False. To use the API to check whether the coupon is available for redemption and then increase the coupon usage count, set the parameter to True. ![Note](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_note.png) Note The shouldCheckCouponUsageLimit parameter and the Coupon Usage Increase API perform similar functions. To avoid potential conflicts, don't use them simultaneously.