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 theo phần trăm hoặc số tiền cố định
• Kiểm soát mục tiêu: Giới hạn theo sản phẩm và các chu kỳ đăng ký
• Quản lý chiến dịch: Ngày hết hạn và giới hạn sử dụng
• Thanh toán liền mạch: Hỗ trợ UI và API qua các phiên thanh toán

​

Tạo mã giảm giá

​

Thiết lập bằng bảng điều khiển

• Tên Mã Giảm Giá (bắt buộc): Tên hiển thị nội bộ và trên bảng điều khiển
• Mã (bắt buộc): Chuỗi mà khách hàng nhập tại thanh toán
• Loại & Số Tiền (bắt buộc): Đặt giá trị phần trăm hoặc cố định, hoặc tạo mã ngẫu nhiên bằng nút được cung cấp
• Ngày Hết Hạn (không bắt buộc): Ngày sau đó mã sẽ không còn hiệu lực
• Giới Hạn Sử Dụng (không bắt buộc): Số lần đổi tối đa trên tất cả khách hàng
• Giới Hạn Sản Phẩm (không bắt buộc): Giới hạn áp dụng cho các sản phẩm được chọn
• Giới Hạn Chu Kỳ Đăng Ký (không bắt buộc): Số chu kỳ thanh toán mà mã giảm giá áp dụng cho
• Metadata (không bắt buộc): Đính kèm cặp key–value tùy chỉnh để theo dõi nội bộ hoặc tích hợp

​

Trải nghiệm thanh toán

1. Người mua nhập mã vào trường thanh toán.
2. Mã giảm giá đủ điều kiện được áp dụng và tổng tiền sẽ cập nhật ngay lập tức.

​

Quản lý API

​

Trường hợp sử dụng phổ biến

• Ưu đãi giới thiệu: Khuyến mãi ra mắt giới hạn thời gian cho sản phẩm mới
• Số lượng lớn hoặc B2B: Chiết khấu hợp đồng cho các bộ sản phẩm được chọn
• Chiến lược duy trì: Mã quay lại trong quy trình ngăn ngừa rời bỏ
• Chiến dịch theo mùa: Khuyến mãi theo dịp lễ hoặc sự kiện

​

Ví dụ tích hợp

​

Tạo mã giảm giá 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 mã giảm giá trong Phiên Thanh Toán

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

​

Áp dụng mã giảm giá khi thay đổi gói

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

​

Kích hoạt mục nhập mã giảm giá mà không cần á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 Hành Tốt Nhất

• Đặt tên rõ ràng: Sử dụng mã dễ nhận biết 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 sự cấp bách và ngăn chặn lạm dụng
• Phạm vi hợp lý: Giới hạn cho các sản phẩm cụ thể để tránh rò rỉ lợi nhuận
• Xác thực sớm: Kiểm tra khả năng áp dụng mã trước khi xác nhận thanh toán
• Giám sát tác động: Theo dõi việc sử dụng và chuyển đổi theo chiến dịch