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

​

Tính năng mới

​

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

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'
});

​

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

​

Cải tiến

​

3. Cải tổ trang Payment của Checkout

• Tương tác với trường mượt mà hơn — tự động focus, thứ tự tab thông minh hơn và khả năng điều hướng bằng bàn phím được cải thiện trên biểu mẫu thẻ
• Trạng thái lỗi và tải rõ ràng hơn — validation nội tuyến được hiển thị chính xác tại nơi khách hàng cần thao tác, thay thế kiểu banner lỗi trên toàn bộ form trước đây
• Hiển thị nhanh hơn — skeleton và progressive hydration loại bỏ hiện tượng nhấp nháy trạng thái trống trong thời gian ngắn trên mạng chậm
• Tối ưu trên mobile — vùng chạm, hành vi cuộn và cách xử lý bàn phím được tinh chỉnh riêng cho checkout trên mobile, nơi hiện chiếm phần lớn lưu lượng

​

4. Cải tiến Product Form

• Bản xem trước trực tiếp — xem product của bạn hiển thị như thế nào trên checkout và Customer Portal trong khi chỉnh sửa, hiển thị song song với form
• Tự động lưu — bản nháp được lưu tự động, vì vậy việc rời khỏi trang hoặc mất tab không còn khiến bạn mất công việc đang thực hiện
• Trình chỉnh sửa Markdown — phần mô tả product hiện hỗ trợ trình chỉnh sửa markdown đầy đủ với khả năng hiển thị trực tiếp, xem trước liên kết và các điều khiển định dạng nội tuyến
• Tương đương trong flow duplicate — khi duplicate product, form thống nhất tương tự sẽ mở ra với các trường được điền sẵn, thay vì một dialog rút gọn, để bạn có thể điều chỉnh mọi trường trước khi lưu bản sao

​

5. Thiết kế lại trang Business Settings

​

Cải tiến

• Giá trị override của credits_amount hiện được truyền chính xác đến các route GET checkout session và payment link — khi checkout session hoặc payment link được tạo với override credit_entitlements riêng cho checkout, việc lấy session hoặc link đó qua GET trước đây trả về giá trị mặc định credits_amount ở cấp product thay vì giá trị đã override. Lỗi này hiện đã được khắc phục.
• Vô hiệu hóa thao tác hoàn tiền đối với payment đã được hoàn tiền toàn bộ — nút Refund trên payment hiện bị vô hiệu hóa sau khi payment được hoàn tiền toàn bộ, kèm tooltip giải thích lý do. Trước đây, nút này vẫn hoạt động và chỉ trả về lỗi sau khi gửi.
• Các bản sửa lỗi nhỏ và cải thiện độ ổn định trên toàn platform