Design and Apply a Promotion

Discounts reduce one-time or recurring prices. Build the commercial rule first, then choose whether checkout applies it silently or lets the buyer see a code.

​

Define the offer

Create it from Discounts.

​

Choose the checkout path

​

Guaranteed campaign price

Preset the discount while creating a Checkout Link. Every buyer arriving through that link receives it without entering a code. This is also how a code-less discount is used outside the API.

​

Visible code prefill

Append discount_code to a Checkout Link URL. Ruba fills the form field, but the buyer still sees the value on checkout.

​

Server-selected price

Supply the discount while creating a Checkout Session. This keeps the decision in application logic; see Checkout Sessions.