discounts-and-promotions

Call client.discounts.create with a type (percentage or flat), amount, and code. Percentage amounts use integers where 1500 means 15%, and flat amounts use the smallest currency unit such as cents for USD.

Pass an array of codes in the discount_codes parameter when creating a checkout session. Codes stack in the order specified, up to a maximum of 20 codes, though eligibility rules still apply to each code individually.

The OpenAPI schema defines both flat and percentage types with currency_options for flat amounts. However, feature documentation states only percentage discounts are currently supported, so verify flat discount availability with Dodo support for your account.

Passing discount_codes as an empty array in subscriptions.changePlan explicitly removes all discounts. To preserve existing discounts, omit the parameter entirely and set preserve_on_plan_change to true on the discount itself.

Retrieve the code server-side with client.discounts.retrieveByCode, then check its expiration date, usage limit against times_used, and product restrictions. Never rely on client-side validation since users can modify codes in the browser.

subscription_cycles limits how many billing cycles a discount applies to on subscriptions, such as the first 3 months. expires_at is a hard calendar cutoff that applies to all uses of the code regardless of billing cycles.