Купоны

Создавайте промокоды, которые покупатели могут применять при оформлении заказа. Процентные или фиксированные скидки, с ограниченным сроком действия или лимитом использования, разовые или повторяющиеся.

Купонами можно управлять в разделе Admin > Commerce > Products вашего приложения, во вкладке Coupons, а также во вкладке Cupones панели администратора опубликованного приложения.

Структура купона

Поле	Примечания
code	Промокод, который покупатель вводит при оформлении заказа (например, LAUNCH20)
percent_off или amount_off	Взаимоисключающие поля. Процент — от 1 до 100. Сумма указывается в минимальных единицах валюты (центах).
currency	Обязательно для скидок amount_off (трёхбуквенный код ISO). Принимается при создании и передаётся в Stripe, но не сохраняется в базе данных и не возвращается API впоследствии.
duration	once (только первый платёж), repeating (на протяжении duration_in_months), или forever
duration_in_months	Обязательно, когда duration имеет значение repeating
max_redemptions	Общий лимит использования для всех покупателей
redeem_by	Дата истечения срока действия, после которой купон перестаёт работать
name	Отображаемое название, которое видит покупатель
active	Переключатель для включения/отключения без удаления

Создание купона

Во вкладке Coupons нажми Add coupon и заполни поля. Несколько типичных сценариев:

Цель	Настройки
Скидка 20% навсегда	percent_off: 20, duration forever
Скидка $10, одноразовая, действует 30 дней	amount_off: 1000, currency USD, duration once, max redemptions 1, redeem-by через 30 дней
Скидка 50% на первые 3 месяца подписки	percent_off: 50, duration repeating, duration in months 3

Или просто попроси AI: "Create a LAUNCH20 coupon for 20% off forever."

Применение купона при оформлении заказа

Покупатель может использовать промокод двумя способами:

• На странице оформления заказа Stripe — поле для промокода отображается автоматически, и покупатель может ввести его без каких-либо дополнительных действий с твоей стороны.
• В собственной корзине — добавь поле для промокода в корзину и передай введённое значение в вызов оформления заказа как couponCode. Сервер проверяет код и вычисляет скидку на основе данных из твоего раздела Commerce (никогда — из суммы, переданной браузером), записывает её в заказ и прикрепляет соответствующий купон Stripe, чтобы сумма списания была корректной.

Попроси AI: "Add a promo code field to the cart and apply it at checkout."

Просмотр, редактирование и деактивация

Вкладка Coupons отображает все купоны с информацией о том, сколько раз каждый из них был использован относительно установленного лимита — это позволяет отслеживать эффективность кампаний с первого взгляда. Возможности редактирования намеренно ограничены — подробнее ниже, — но ты можешь деактивировать любой купон без удаления, и он немедленно перестанет работать при оформлении заказа.

Примечания и ограничения

• Коды и суммы скидок нельзя изменить. Ты можешь обновить отображаемое поле name и переключить active, но не percent_off, amount_off или сам code. Если нужны другие условия — создай новый купон.
• times_redeemed увеличивается автоматически и доступен только для чтения — удобно для отслеживания эффективности кампаний.
• Купоны применяются на уровне покупателя, а не заказа — если купон имеет значение forever и покупатель оформляет подписку, каждое продление будет включать скидку.