Discounts and Promotions

This skill covers discount codes, coupons, and promotional pricing in Dodo Payments. Use it when building discount management, applying codes at checkout, validating codes before showing prices, or handling discounts during subscription plan changes.

When to use this skill

• Create, update, list, or delete discount codes
• Apply discount codes at checkout or during plan changes
• Validate a code before displaying adjusted pricing to the user
• Configure eligibility rules, usage limits, or subscription-cycle restrictions
• Handle the subtle semantics of discount preservation during plan upgrades/downgrades
• Debug why a discount isn't applying or stacking as expected

Core concepts

Discount types: Dodo supports both percentage and flat-amount discounts. Percentage amounts are expressed as integers where 1500 means 15% (100 = 1%). Flat amounts are in the smallest currency unit (cents for USD).

Discount code: A human-readable string (e.g., SUMMER2025) that customers enter at checkout. Codes are case-sensitive.