Loading
Prepare for Email to Become the Default Login ExperienceRead More
The online Trailblazer Community becomes read-only Oct 30, 2026Read More
Important Advisory: iOS Update Impacting CG Mobile ApplicationRead More
Learn About Real-Time Offer Management
Run Pricing Promotions

Run Pricing Promotions

After marketing managers activate a promotion that uses pricing promotion templates, system integrators can integrate business APIs with external systems. The APIs show customers the promotions that their carts are eligible for and to apply the promotions that customers select for their cart.

  • Eligible Promotions API
    Use the Eligible Promotions API to provide customers with a list of pricing promotions that are eligible for customer carts. The API can get the list of eligible promotions for contacts, accounts, and loyalty program members.
  • Promotion Evaluation and Execution API
    The Promotion Evaluation and Execution API evaluates cart details and returns the adjusted price of cart and line items after applying eligible promotions based on the selected promotion evaluation method.
  • 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.
  • Promotion Reward Application API
    Issue non-pricing rewards and update promotion and customer limits after customers place their orders.
  • Promotion Configuration API
    Use the Promotion Configuration API to access and export active promotion configurations.
  • Promotion Enrollment API
    Use the Promotion Enrollment API to enroll a customer in a promotion and create an enrollment record. To provide a seamless experience, integrate this API with external systems such as shopping sites and mobile apps that manage customer profiles.
  • Coupon Validation API
    Use the Coupon Validation API to verify manually entered coupon codes before applying discounts. Validating coupons upfront—rather than waiting until checkout—gives customers immediate feedback on whether their code works. The API checks if the coupon exists, is active, hasn't reached redemption limits, and if the cart is eligible for the promotion.
  • Workflow to Run Pricing Promotions
    Review the workflow for how multiple APIs work together to show customers the promotions their carts are eligible for and to apply the promotions that customers use for their orders. The workflow differs depending on whether your company's promotions use coupons or not.
  • Run Pricing Promotions for Global Audiences
    If your promotions are translated in different languages, Get Eligible API and Promotion Evaluation and Execution API show the promotional details in the translated languages. The promotion’s display language depends on the default language of the user who runs the API.
 
Loading
Salesforce Help | Article