Купони

Створюйте промокоди, які клієнти можуть застосовувати під час оформлення замовлення. Відсоткові або фіксовані знижки, обмежені у часі або за кількістю використань, одноразові або повторювані.

Купонами керують у розділі 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. Сервер перевіряє код і обчислює знижку на основі даних твоєї крамниці (але ніколи не зі значення, яке надіслав браузер), записує її до замовлення та прикріплює відповідний купон 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 і клієнт оформив підписку, знижка поширюватиметься на кожне поновлення.