v1.99.0 (25 tháng 5, 2026)

Mã giảm giá xếp chồng (tối đa 20 mã cho mỗi lần thanh toán, thanh toán hoặc đăng ký), bảy email thông báo khách hàng mới cho các sự kiện hoàn tiền và vòng đời đăng ký, Sunbit BNPL cho khách hàng Mỹ, cải tiến trang thanh toán nâng cao tỷ lệ thành công từ 2–3%, cải tiến biểu mẫu sản phẩm với xem trước trực tiếp và tự động lưu, và thiết kế lại Cài đặt Doanh nghiệp

​

Tính năng mới

​

1. Mã Giảm Giá Xếp Chồng

Các phiên thanh toán, thanh toán, đăng ký và thay đổi gói giờ đây chấp nhận tối đa 20 mã giảm giá trong một yêu cầu duy nhất thông qua mảng discount_codes. Mã được áp dụng theo thứ tự trong mảng — mã đầu tiên đủ điều kiện giảm giá cơ bản, mã thứ hai giảm giá đã được giảm, và cứ tiếp tục như vậy — vì vậy bạn có thể xếp lớp các chiến dịch mà không cần tạo mã kết hợp riêng biệt.

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

Nơi áp dụng

Bề mặt	Trường	Tối đa mã
Phiên thanh toán	discount_codes	20
Thanh toán	discount_codes	20
Đăng ký	discount_codes	20
Thay đổi gói	discount_codes	20

Hành vi thay đổi gói

Giá trị discount_codes	Hiệu quả
Không cung cấp	Giữ các giảm giá hiện có với preserve_on_plan_change=true nếu áp dụng cho sản phẩm mới
[] (mảng rỗng)	Tất cả các giảm giá hiện có bị loại bỏ khỏi đăng ký
['CODE_A', 'CODE_B', ...]	Thay thế bất kỳ giảm giá hiện có bằng bộ xếp chồng này, áp dụng theo thứ tự trong mảng

Dạng phản hồi

Toàn bộ bộ giảm giá được áp dụng được trả về dưới mảng discounts trên các thanh toán và đăng ký — mỗi mục bao gồm discount_id, position, và cycles_remaining (cho đăng ký). Trường discount_id đơn lẻ đời cũ bị bỏ đi nhưng vẫn có mặt để tương thích ngược.

Trường discount_code đơn lẻ bị loại bỏ nhưng vẫn được hỗ trợ hoàn toàn — các tích hợp hiện tại vẫn hoạt động mà không cần thay đổi. Không thể kết hợp với discount_codes trong cùng một yêu cầu. Chúng tôi khuyến nghị chuyển sang discount_codes khi tiện, ngay cả đối với mã đơn, để tận dụng khả năng xếp chồng và dạng phản hồi phong phú hơn.

Tìm hiểu thêm: Mã Giảm Giá | Phiên Thanh Toán | Thay Đổi Gói

​

2. Bảy Email Thông Báo Khách Hàng Mới

Bảy email giao dịch mới hiện được gửi tự động cho khách hàng của bạn, bao gồm xác nhận hoàn tiền, các mốc vòng đời đăng ký và lỗi thanh toán. Mỗi email có thể được tắt riêng từ Cài đặt → Giao tiếp dưới phần Email Khách Hàng.

Tùy chọn (bật theo mặc định)

Email	Khi nào kích hoạt
Hoàn Tiền Thành Công	Hoàn tiền được xử lý thành công và tiền đang quay lại cho khách hàng
Thời Gian Dùng Thử Kết Thúc	~2 ngày trước khi thử nghiệm hết hạn và bắt đầu tính phí đầu tiên
Hủy Đăng Ký Ngay Lập Tức	Đăng ký bị hủy với hiệu lực ngay lập tức
Đặt Hủy Đăng Ký Vào Ngày Thanh Toán Tiếp Theo	Đăng ký được đặt để hủy vào cuối kỳ thanh toán hiện tại

Tùy chọn (tắt theo mặc định)

Email	Khi nào kích hoạt
Thanh Toán Thất Bại	Nỗ lực thanh toán thất bại — bật nếu bạn muốn Dodo Payments thông báo trực tiếp cho khách hàng thay vì xử lý trên hệ thống của bạn
Gia Hạn Đăng Ký Thất Bại	Thanh toán gia hạn đăng ký thất bại; kích hoạt thay cho (không bổ sung vào) email Thanh Toán Thất Bại cho thanh toán gia hạn
Nhắc Gia Hạn Sắp Tới	~2 ngày trước khi gia hạn đăng ký

Nếu bạn tự quản lý giao tiếp khách hàng qua webhooks, hãy để các email tùy chọn tắt để tránh gửi thông báo trùng lặp cho cùng một sự kiện.

Email khách hàng riêng biệt với các email thông báo gửi cho đội ngũ của bạn. Việc tắt một email khách hàng không ảnh hưởng đến thông báo cho đội ngũ của bạn về cùng một sự kiện.

Tìm hiểu thêm: Tùy chọn Giao tiếp

​

3. Sunbit — Tài Chính Trả Góp cho Khách Hàng Mỹ

Sunbit hiện có sẵn như một phương thức thanh toán Mua Ngay, Trả Sau, cho phép khách hàng Mỹ chia các giao dịch thành các khoản trả hàng tháng dễ quản lý tại điểm thanh toán.

Tính năng	Chi tiết
Khả dụng	Hoa Kỳ
Tiền tệ	USD
Số tiền tối thiểu	$60.00
Số tiền tối đa	$19,999.00
Đăng ký	Không hỗ trợ (chỉ thanh toán một lần)

Truyền sunbit trong allowed_payment_method_types để kích hoạt trên một phiên thanh toán:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['sunbit', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Khách hàng hoàn thành đơn đăng ký tài chính ngắn trong Sunbit modal tại điểm thanh toán; một khi được chấp thuận, thanh toán xác nhận và bạn nhận được tiền như bình thường.

Luôn bao gồm credit và debit như các phương án dự phòng. Không phải tất cả khách hàng sẽ đủ điều kiện cho tài chính Sunbit, và các giao dịch ngoài khoảng $60.00–$19,999.00 sẽ không hiển thị tùy chọn.

Tìm hiểu thêm: Phương thức Thanh Toán BNPL

​

Cải tiến

​

4. Cải Tiến Trang Thanh Toán

Trang thanh toán tại điểm thanh toán đã được cải tiến đáng kể từ đầu đến cuối — bố cục chặt chẽ hơn, tải nhanh hơn, trạng thái xác thực rõ ràng hơn và trải nghiệm nhập thẻ tinh chỉnh hơn. Tổng thể, những thay đổi này đã nâng tỷ lệ thành công tại điểm thanh toán lên khoảng 2–3% trên toàn cầu.

Before

After

Những thay đổi:

• Tương tác trường mượt mà hơn — tự động lấy nét, thứ tự tab thông minh hơn và cải thiện điều hướng bàn phím trên biểu mẫu thẻ
• Trạng thái lỗi và tải sạch hơn — xác thực trực tuyến xuất hiện chính xác nơi khách hàng cần thực hiện, thay cho mẫu lỗi toàn biểu mẫu trước đây
• Tải nhanh hơn — khung xương và làm tươi dần loại bỏ hiện tượng nhấp nháy trạng thái trống thoáng qua trên mạng chậm
• Cải tiến di động — mục tiêu nhấp, hành vi cuộn và xử lý bàn phím được tinh chỉnh cụ thể cho điểm thanh toán di động, nơi nhận lượng truy cập lớn

Không cần thay đổi tích hợp. Các phiên thanh toán hiện có tự động áp dụng trang thanh toán mới.

​

5. Cải Tiến Biểu Mẫu Sản Phẩm

Các luồng tạo, chỉnh sửa và sao chép sản phẩm đã được xây dựng lại từ đầu quanh trải nghiệm biểu mẫu nhất quán.

Điểm nổi bật:

• Xem trước trực tiếp — xem cách sản phẩm của bạn hiển thị trên thanh toán và cổng khách hàng khi bạn chỉnh sửa, song song với biểu mẫu
• Tự động lưu — bản nháp được lưu tự động, vì vậy rời khỏi hoặc mất tab của bạn không đồng nghĩa với việc công việc của bạn bị mất
• Trình chỉnh sửa Markdown — mô tả sản phẩm hiện hỗ trợ trình chỉnh sửa markdown đầy đủ với khả năng kết xuất trực tiếp, xem trước liên kết và điều khiển định dạng nội tuyến
• Sao chép tương đương — sao chép một sản phẩm mở cùng một biểu mẫu hợp nhất đã điền sẵn, thay vì một hộp thoại rút gọn, để bạn có thể chỉnh sửa mọi trường trước khi lưu bản sao

Sử dụng Duplicate để tạo các biến thể vùng hoặc mức giá của một sản phẩm hiện có mà không cần nhập lại mô tả, siêu dữ liệu hoặc cấu hình thực hiện.

​

6. Thiết Kế Lại Trang Cài Đặt Doanh Nghiệp

Trang Cài đặt → Doanh nghiệp đã được thiết kế lại để việc cấu hình dễ dàng quét và cập nhật nhanh hơn. Cài đặt giờ được nhóm thành các phần rõ ràng hơn với nội dung giải thích mô tả tác động của từng công tắc trước khi bạn bật.

Không có thay đổi hành vi với các cài đặt hiện tại — chỉ có bố cục, phân nhóm, và phần giải thích xung quanh đã được cải thiện.

​

Cải tiến

• credits_amount override hiện được truyền đúng cách qua các tuyến GET phiên thanh toán và liên kết thanh toán — khi một phiên thanh toán hoặc liên kết thanh toán được tạo với một override credit_entitlements theo phiên thanh toán, việc lấy lại phiên đó hoặc liên kết qua GET trả về giá trị mặc định credits_amount ở mức sản phẩm thay vì giá trị đã bị override. Đây là giờ đã được sửa.
• Hành động hoàn tiền bị vô hiệu cho thanh toán đã được hoàn trả đầy đủ — nút Hoàn Tiền trên một thanh toán giờ bị vô hiệu sau khi thanh toán đã được hoàn trả đầy đủ, với một hướng dẫn lý do. Trước đây nút vẫn hoạt động và chỉ trả về lỗi sau khi gửi.
• Sửa lỗi nhỏ và cải thiện ổn định trên toàn bộ nền tảng