Giảm giá

​

Mã giảm giá là gì?

​

Lợi ích chính

• Giảm giá linh hoạt: Giảm theo phần trăm hoặc theo số tiền cố định
• Mã có thể kết hợp: Áp dụng tối đa 20 mã cho mỗi lần checkout, payment hoặc subscription
• Kiểm soát có mục tiêu: Giới hạn theo sản phẩm, chu kỳ subscription và điều kiện đủ tư cách của khách hàng
• Quản trị chiến dịch: Ngày bắt đầu theo lịch, ngày hết hạn, giới hạn sử dụng tổng thể và theo từng khách hàng
• Định giá theo từng currency: Đặt số tiền giảm cố định, giới hạn số tiền và subtotal tối thiểu cho từng currency

​

Tạo mã giảm giá

​

Thiết lập trên Dashboard

• Discount Name (bắt buộc): Nhãn nội bộ cho dashboard.
• Code (bắt buộc): Chuỗi khách hàng nhập khi checkout. Tạo mã ngẫu nhiên hoặc nhập mã của riêng bạn (tối thiểu 3 ký tự, tự động chuyển thành chữ hoa).
• Type (bắt buộc): Percentage (giảm theo phần trăm) hoặc Amount (giảm một số tiền cố định).
• Amount (bắt buộc): Với percentage, phần trăm giảm trong dashboard (ví dụ: 15 cho 15%). Qua API, cùng giá trị này được biểu diễn theo basis points (1500). Với amount, đây là số tiền giảm cố định theo currency mặc định của mã.
• Start Date (tùy chọn): Lên lịch để mã được kích hoạt vào một ngày trong tương lai. Để trống để kích hoạt ngay lập tức.
• Expiration Date (tùy chọn): Ngày sau đó mã không còn có thể được đổi.
• Usage Limit (tùy chọn, trong Advanced): Tổng số lần đổi tối đa trên tất cả khách hàng.
• Per-Customer Usage Limit (tùy chọn, trong Advanced): Số lần đổi tối đa của một khách hàng bất kỳ. Khi cả hai được thiết lập, giá trị này phải nhỏ hơn hoặc bằng giới hạn sử dụng tổng thể.
• Customer Eligibility (tùy chọn): Giới hạn những người có thể đổi mã — tất cả khách hàng, khách hàng mua lần đầu, khách hàng hiện tại hoặc danh sách được chọn thủ công.
• Currency Options (tùy chọn): Số tiền giảm cho từng currency bạn bán. Xem Per-Currency Options.
• Product Restriction (tùy chọn): Giới hạn mã cho các sản phẩm cụ thể.
• Subscription Cycle Limit (tùy chọn, trong Advanced): Số chu kỳ billing mà giảm giá được áp dụng. Để trống nếu muốn áp dụng vô thời hạn.
• Preserve on Plan Change (tùy chọn): Giữ giảm giá khi subscription thay đổi plan (preserve_on_plan_change).
• Metadata (tùy chọn): Đính kèm các cặp key–value tùy chỉnh để theo dõi nội bộ.
• Require a minimum order value (tùy chọn, trong Advanced): Subtotal tối thiểu của giỏ hàng (theo từng currency) để mã được áp dụng.

​

Loại mã giảm giá

​

Đối tượng khách hàng đủ điều kiện

​

Tùy chọn theo tiền tệ

• Amount — với giảm giá Amount, đây là khoản giảm cố định theo currency đó; với giảm giá Percentage, đây là giới hạn giảm tối đa. Ánh xạ tới max_amount_possible trong API.
• Default — đánh dấu một currency là mặc định. Các currency chưa được cấu hình sẽ được quy đổi từ currency mặc định này.

• Minimum subtotal — mã chỉ được áp dụng khi giỏ hàng đạt subtotal này theo currency đó. 0 có nghĩa là không có mức tối thiểu.

​

Trải nghiệm Checkout

​

Kết hợp Discount Code

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

Quản lý API

​

Các trường hợp sử dụng phổ biến

• Ưu đãi mở đầu: Khuyến mãi ra mắt có thời hạn cho sản phẩm mới
• Bán số lượng lớn hoặc B2B: Giảm giá theo hợp đồng cho các nhóm sản phẩm được chọn
• Chiến lược giữ chân: Mã khuyến mãi thu hút lại khách hàng trong quy trình ngăn ngừa churn
• Chiến dịch theo mùa: Khuyến mãi theo ngày lễ hoặc sự kiện

​

Ví dụ tích hợp

​

Tạo Discount với Metadata

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

Áp dụng Discount trong Checkout Sessions

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

Áp dụng Discount trong quá trình thay đổi Plan

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

Ẩn trường mã giảm giá

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

Các phương pháp hay nhất

• Đặt tên rõ ràng: Sử dụng các mã dễ nhận biết và phù hợp với tên chiến dịch.
• Giới hạn thời gian: Thêm ngày hết hạn để tạo cảm giác cấp bách và ngăn việc sử dụng sai mục đích.
• Giới hạn phạm vi hợp lý: Giới hạn theo các sản phẩm cụ thể để tránh làm thất thoát biên lợi nhuận.
• Xác thực sớm: Kiểm tra khả năng áp dụng của mã trước khi xác nhận checkout.
• Theo dõi tác động: Theo dõi mức sử dụng và tỷ lệ chuyển đổi theo từng chiến dịch.