Giảm giá

​

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

• Chiến dịch theo mùa: Black Friday, ra mắt sản phẩm hoặc kỷ niệm
• Ưu đãi thu hút: Khuyến khích mua lần đầu hoặc thưởng giới thiệu
• Duy trì: Thưởng quay lại hoặc cho khách hàng trung thành hiện có
• Giao dịch B2B: Giá thương lượng thông qua mã riêng tư

​

Lợi ích chính

• Giảm giá linh hoạt: Giảm giá theo phần trăm hoặc 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 thanh toán, payment hoặc subscription — kết hợp các chiến dịch (ví dụ: WELCOME10 + BLACKFRIDAY20) mà không cần tạo mã riêng
• Kiểm soát theo đối tượng: Giới hạn theo sản phẩm, chu kỳ subscription và điều kiện đủ của customer
• Quản trị chiến dịch: Lên lịch ngày bắt đầu, ngày hết hạn, giới hạn lượt sử dụng tổng thể và theo từng customer
• Định giá theo từng currency: Đặt khoản khấu trừ cố định, mức giảm tối đa và subtotal tối thiểu cho từng currency
• Checkout liền mạch: Hỗ trợ trường UI và API thông qua checkout sessions

​

Tạo mã giảm giá

​

Thiết lập trên dashboard

• Discount Name (bắt buộc): Tên hiển thị nội bộ và trên dashboard
• Code (bắt buộc): Chuỗi customer nhập tại checkout hoặc tạo mã ngẫu nhiên bằng nút được cung cấp
• Type (bắt buộc): Chọn Percentage (giảm theo phần trăm) hoặc Amount (khấu trừ một số tiền cố định)
• Amount (bắt buộc): Giá trị phần trăm hoặc số tiền cố định cho discount loại Amount
• Start Date (tùy chọn): Lên lịch để mã bắt đầu có hiệu lực sau; để trống để kích hoạt ngay lập tức
• Expiration Date (tùy chọn): Ngày sau đó mã sẽ không còn hiệu lực
• Usage Limit (tùy chọn): Tổng số lượt đổi tối đa trên tất cả customer
• Per-Customer Usage Limit (tùy chọn): Số lượt đổi tối đa của một customer. Khi đặt cả hai giới hạn, 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ả customer, customer lần đầu, customer hiện tại hoặc danh sách được chọn thủ công
• Currency Options (tùy chọn): Giá trị theo từng currency — xem Per-Currency Options
• Product Restriction (tùy chọn): Giới hạn phạm vi áp dụng cho các product được chọn
• Subscription Cycle Limit (tùy chọn): Số chu kỳ thanh toán mà discount được áp dụng
• Preserve on Plan Change (tùy chọn): Giữ discount hoạt động khi plan của subscription thay đổi (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ộ hoặc tích hợp

​

Các loại Discount

​

Điều kiện đủ của Customer

​

Currency Options theo từng Currency

• Amount — với discount loại Amount, đây là khoản khấu trừ; với discount loại Percentage, đây là mức tối đa code có thể giảm. Ánh xạ tới max_amount_possible trên API.
• Minimum subtotal — code chỉ được áp dụng khi cart đạt subtotal này. 0 có nghĩa là không có mức tối thiểu.
• Default — một mục có thể được đánh dấu là mặc định để các currency khác chưa được cấu hình chuyển đổi từ đó.

​

Trải nghiệm Checkout

1. Người mua nhập code vào trường checkout.
2. Các discount đủ điều kiện được áp dụng và tổng tiền cập nhật ngay lập tức.

​

Kết hợp Discount Code

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 giới thiệu: Khuyến mãi ra mắt trong thời gian giới hạn cho sản phẩm mới
• Mua số lượng lớn hoặc B2B: Discount theo hợp đồng cho các nhóm sản phẩm được chọn
• Chiến lược giữ chân: Mã win-back trong quy trình ngăn customer rời bỏ
• Chiến dịch theo mùa: Khuyến mãi theo ngày lễ hoặc sự kiện

​

Ví dụ Integration

​

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: 'prod_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 khi thay đổi plan

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

​

Cho phép nhập discount mà không áp dụng trước

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

​

Thực tiễn tốt nhất

• Đặt tên rõ ràng: Sử dụng các code dễ nhận biết và khớp với tên chiến dịch
• Giới hạn thời gian: Thêm thời hạn để tạo tính cấp thiết và ngăn việc lạm dụng
• Xác định phạm vi hợp lý: Giới hạn cho các product cụ thể để tránh 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 code trước khi xác nhận checkout
• Theo dõi tác động: Theo dõi lượt sử dụng và conversion theo từng chiến dịch