Chuyển đến nội dung chính
Discount codes overview cover
Mã giảm giá cho phép bạn thực hiện các chương trình khuyến mãi và ưu đãi có mục tiêu. Tạo giảm giá theo phần trăm hoặc số tiền cố định, đặt giới hạn và thời hạn, hạn chế theo sản phẩm và áp dụng chúng một cách liền mạch trong quá trình thanh toán.

Checkout Sessions

Áp dụng mã trong quy trình thanh toán được lưu trữ bằng discount_code và các điều khiển giao diện người dùng.

Validate Discount

Kiểm tra xem mã giảm giá có hợp lệ theo ID không.

Get Discount by Code

Tra cứu và xác thực mã giảm giá bằng tên mã (ví dụ: “SAVE20”).

Create Discount (API)

Tạo mã giảm giá mới theo chương trình.

List & Update Discounts

Duyệt và quản lý các mã giảm giá hiện có; cập nhật hoặc xóa theo nhu cầu.

Plan Change Discounts

Áp dụng mã giảm giá khi nâng cấp hoặc hạ cấp gói đăng ký.

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

Mã giảm giá là token khuyến mãi giúp giảm tổng số tiền thanh toán tại lúc thanh toán. Chúng rất lý tưởng cho:
  • 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á

Tạo mã giảm giá trong bảng điều khiển Dodo Payments, sau đó áp dụng chúng trong thanh toán được lưu trữ hoặc qua API.

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

  • Tên giảm giá (bắt buộc): Tên hiển thị nội bộ và trên bảng điều khiển
  • (bắt buộc): Chuỗi mà khách hàng nhập ở bước thanh toán
  • Loại & Số tiền (bắt buộc): Đặt giá trị theo phần trăm hoặc số tiền cố định, hoặc tạo mã ngẫu nhiên bằng nút có sẵn
  • Ngày hết hạn (tùy chọn): Ngày mà sau đó mã sẽ không còn hiệu lực
  • Giới hạn sử dụng (tùy chọn): Tối đa số lượt đổi mã trên toàn bộ khách hàng
  • Giới hạn sản phẩm (tùy chọn): Giới hạn khả dụng trên các sản phẩm đã chọn
  • Giới hạn chu kỳ đăng ký (tùy chọn): Số chu kỳ thanh toán mà chiết khấu áp dụng
Sử dụng giới hạn chu kỳ cho giá giới thiệu đối với các đăng ký (ví dụ, “50% giảm trong 3 tháng”).

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.
Trong các phiên Thanh toán, truyền discount_code để áp dụng mã trước và đặt feature_flags.allow_discount_code để hiển thị trường nhập liệu.

Quản lý API

Tạo mã giảm giá lập trình với loại và số tiền.

API Reference

Xem API tạo mã giảm giá.
Liệt kê tất cả các mã giảm giá hoặc lấy chi tiết để quản lý và kiểm toán.

API Reference

Duyệt danh sách API liệt kê và truy xuất.
Tra cứu mã giảm giá bằng mã có thể đọc được bởi con người (ví dụ: “SAVE20”) thay vì ID nội bộ.

API Reference

Truy xuất mã giảm giá theo tên mã.
Thay đổi cấu hình của mã giảm giá như số tiền, ngày hết hạn hoặc hạn chế.

API Reference

Tìm hiểu cách cập nhật chi tiết mã giảm giá.
Kiểm tra xem mã giảm giá có hợp lệ và có thể áp dụng trước khi sử dụng.

API Reference

Xác thực việc sử dụng mã giảm giá.
Hủy kích hoạt hoặc loại bỏ các mã giảm giá không còn cần thiết.

API Reference

Xóa mã giảm giá.

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

Áp dụng mã giảm giá trong các phiên thanh toán

Áp dụng mã giảm giá trước và hiển thị giao diện nhập mã.
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

Cung cấp giá khuyến mãi khi khách hàng nâng cấp hoặc hạ cấp gói đăng ký.
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_code: 'UPGRADE20'
});
Nếu gói đăng ký đã có mã giảm giá preserve_on_plan_change=true và bạn không truyền mã mới, mã giảm giá hiện có sẽ tự động được giữ lại khi áp dụng cho sản phẩm mới.

Kích hoạt nhập mã giảm giá mà không áp dụng trước

Cho phép khách hàng nhập mã khi thanh toán mà không cần truyền 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 mã dễ nhận dạng phù hợp với tên chiến dịch
  • Giới hạn thời gian: Thêm hạn để thúc đẩy sự cấp bách và ngăn ngừa lạm dụng
  • Phạm vi khôn ngoan: Giới hạn cho sản phẩm cụ thể để tránh rò rỉ lợi nhuận
  • Xác thực sớm: Kiểm tra khả dụng của mã trước khi xác nhận thanh toán
  • Theo dõi tác động: Theo dõi việc sử dụng và chuyển đổi theo chiến dịch
Mã giảm giá là công cụ mạnh mẽ cho việc thu hút và duy trì khách hàng. Bắt đầu với các ưu đãi đơn giản, dễ nhận biết, xác thực kỹ và điều chỉnh dựa trên hiệu suất.
Last modified on March 24, 2026