Mã giảm giá

Tạo mã khuyến mãi để khách hàng áp dụng khi thanh toán. Giảm theo phần trăm hoặc số tiền cố định, có giới hạn thời gian hoặc số lần sử dụng, một lần hoặc định kỳ.

Mã giảm giá được quản lý trong ứng dụng của bạn tại Admin > Commerce > Products, mục Coupons, và trong tab Cupones của bảng quản trị ứng dụng đã được publish.

Cấu trúc của một mã giảm giá

Trường	Ghi chú
code	Mã khuyến mãi mà khách hàng nhập khi thanh toán (ví dụ: LAUNCH20)
percent_off hoặc amount_off	Chỉ dùng một trong hai. Phần trăm từ 1–100. Số tiền tính theo đơn vị tiền tệ nhỏ nhất (cent).
currency	Bắt buộc khi dùng amount_off (mã ISO ba chữ cái). Được chấp nhận lúc tạo và chuyển tiếp sang Stripe, nhưng không được lưu trữ hoặc trả về qua API sau đó.
duration	once (chỉ lần thanh toán đầu tiên), repeating (dùng với duration_in_months), hoặc forever
duration_in_months	Bắt buộc khi duration là repeating
max_redemptions	Tổng giới hạn số lần sử dụng trên toàn bộ khách hàng
redeem_by	Ngày hết hạn — sau ngày này mã giảm giá sẽ ngừng hoạt động
name	Tên hiển thị cho khách hàng thấy
active	Bật/tắt mã mà không cần xóa

Tạo mã giảm giá

Trong tab con Coupons, nhấn Add coupon và điền các trường. Một số cách dùng phổ biến:

Mục tiêu	Cài đặt
Giảm 20% mãi mãi	percent_off: 20, duration forever
Giảm $10, dùng một lần, hết hạn sau 30 ngày	amount_off: 1000, currency USD, duration once, max redemptions 1, redeem-by sau 30 ngày
Giảm 50% trong 3 tháng đầu của gói đăng ký	percent_off: 50, duration repeating, duration in months 3

Hoặc chỉ cần hỏi AI: "Create a LAUNCH20 coupon for 20% off forever."

Áp dụng mã giảm giá khi thanh toán

Có hai cách khách hàng có thể sử dụng mã:

• Trên trang thanh toán của Stripe — ô nhập mã khuyến mãi hiển thị tự động, vì vậy khách hàng có thể nhập mã ở đó mà bạn không cần làm thêm gì.
• Trong giỏ hàng của bạn — thêm ô nhập mã khuyến mãi vào giỏ hàng và truyền nội dung khách nhập vào lệnh gọi thanh toán dưới dạng couponCode. Server sẽ xác thực mã và tính toán mức giảm giá từ dữ liệu commerce của bạn (không bao giờ dựa trên số tiền do trình duyệt cung cấp), ghi lại vào đơn hàng, và đính kèm coupon Stripe tương ứng để đảm bảo số tiền tính đúng.

Hỏi AI: "Add a promo code field to the cart and apply it at checkout."

Xem danh sách, cập nhật, vô hiệu hóa

Tab con Coupons liệt kê tất cả mã giảm giá kèm số lần đã sử dụng so với giới hạn, giúp bạn theo dõi hiệu quả chiến dịch trong nháy mắt. Khả năng chỉnh sửa được giới hạn có chủ đích — xem bên dưới — nhưng bạn có thể tắt bất kỳ mã nào mà không cần xóa, và mã đó sẽ ngừng hoạt động khi thanh toán ngay lập tức.

Lưu ý và giới hạn

• Mã và mức giảm giá không thể thay đổi. Bạn có thể cập nhật name hiển thị và bật/tắt active, nhưng không thể thay đổi percent_off, amount_off, hay chính code. Hãy tạo mã mới nếu bạn cần điều khoản khác.
• times_redeemed tự động tăng và chỉ đọc — hữu ích để theo dõi hiệu quả chiến dịch.
• Mã giảm giá áp dụng theo khách hàng, không theo đơn hàng — nếu mã có forever và khách hàng đăng ký, mỗi lần gia hạn đều được hưởng giảm giá.