Tính năng mới
1. Reports
Một tab Reports mới trong Settings tập hợp báo cáo về số dư, phí và đối soát tại một nơi. Theo dõi dòng tiền Hai chế độ xem luôn được cập nhật, với mô tả là “Hiểu cách hoạt động, phí và các khoản payout ảnh hưởng đến số dư của bạn”:- Tóm tắt số dư và payout — số dư đầu kỳ, phân tích hoạt động và chi tiết theo từng payout trong cùng một chế độ xem
- Tất cả phí — phân tích đầy đủ, theo từng mục, về mọi khoản phí được tính trong kỳ
2. Subscription Grace Period
Một subscription có lần gia hạn thất bại giờ đây có thể tiếp tục hoạt động trong một khoảng thời gian có thể cấu hình, thay vì ngay lập tức chuyển sang trạng thái tạm giữ. Bật Subscription Grace Period trong Settings → Subscriptions và đặt Number of days of grace period — từ 1 đến 30 ngày. Grace period mặc định được tắt. Trong khoảng thời gian này, subscription chuyển sang trạng tháipast_due mới: quyền truy cập được duy trì và mức sử dụng tiếp tục được ghi nhận, vì vậy customer có thẻ vừa hết hạn sẽ không bị ngắt dịch vụ trong lúc khắc phục. Một webhook subscription.past_due mới được kích hoạt khi khoảng thời gian này bắt đầu.
Chọn điều xảy ra nếu khoảng thời gian kết thúc mà chưa thanh toán trong Status of subscription after grace period — On Hold, tương ứng với hành vi hiện tại, hoặc Cancel Subscription.
3. Customer Blocklist
Chặn một customer không được phép mua hàng của bạn lần nữa, theo customer ID hoặc địa chỉ email. Việc chặn sẽ hủy các subscription đang hoạt động của customer, dừng các checkout session và direct payment trong tương lai, đồng thời chuyển Customer Portal của họ sang chế độ chỉ đọc. Vì các mục được đối chiếu theo địa chỉ email, customer đăng ký lại bằng cùng email vẫn sẽ bị chặn. Các mục trong blocklist có ghi chú, để bạn có thể lưu lại lý do chặn một người.
4. Manual Payment Retry
Tự mình thử lại lần gia hạn subscription thất bại thay vì chờ lịch automatic retry, bằng cách sử dụng Retry Payment Manually trên trang chi tiết payment. Khoản charge được gửi đến payment method đã lưu trên subscription, nên customer không cần thực hiện thao tác nào và thao tác này không sử dụng một lần thử trong lịch automatic retry. Mỗi renewal invoice cho phép tối đa ba lần manual retry, với thời gian chờ giữa các lần — một giờ trước lần thứ hai và ba giờ trước lần thứ ba — để các lần bị từ chối liên tiếp không làm ảnh hưởng đến authorization rate của bạn.
5. Activity Log trên Payment
Mọi trang chi tiết payment giờ đây đều có Activity Log — “Lịch sử các thao tác trên transaction này trong 90 ngày qua”. Nhật ký theo dõi toàn bộ vòng đời theo thứ tự, từ Payment initiated, qua authentication và capture, đến Payment succeeded, rồi tiếp tục với refund và dispute, để một payment bị tranh chấp được thể hiện như một câu chuyện thống nhất thay vì nhiều bản ghi rời rạc.
6. Biểu mẫu Discount được xây dựng lại
Việc tạo discount code giờ đây hiển thị cho bạn nội dung đang xây dựng ngay trong quá trình tạo. Một bảng bên cạnh chuyển đổi giữa Summary, phần mô tả discount bằng ngôn ngữ dễ hiểu, và Preview, hiển thị discount theo cách customer sẽ thấy tại checkout. Currency options cho phép bạn đặt số tiền discount cho từng currency mà bạn bán. Eligibility & restrictions tập hợp các quy tắc về product và customer tại một nơi. Giới hạn redemption, giới hạn billing cycle và Require a minimum order value — số tiền tối thiểu của giỏ hàng được áp dụng theo từng currency — giờ đây nằm trong Advanced.
7. Các tùy chọn hủy được tách riêng
Trước đây, việc hủy self-service chỉ có một công tắc. Giờ đây có hai cài đặt độc lập trong Settings → Subscriptions:- Allow Immediate Cancellation — “Cho phép customer kết thúc subscription và mất quyền truy cập ngay lập tức.”
- Allow Cancellation at Next Billing Date — “Cho phép customer hủy vào cuối kỳ mà họ đã thanh toán.”
8. Plan Changes được thanh toán trên Checkout Page
Bật Collect Plan Change Payments by Payment Link trong Settings → Subscriptions để customer nâng cấp trong Customer Portal thanh toán cho thay đổi trên hosted checkout page thay vì sử dụng mandate đã lưu. Nút xác nhận hiển thị số tiền phải trả, và khi checkout mở, customer sẽ thấy thông báo: “Hoàn tất payment trong tab mới. Plan hiện tại của bạn vẫn hoạt động cho đến khi payment thành công.” Subscription vẫn giữ plan cũ cho đến khi payment thành công, và payment bị từ chối có thể được thử lại trên cùng link. Customer Portal giờ đây cũng biết bạn có cho phép hủy plan change đã lên lịch hay không, nên sẽ hiển thị hoặc ẩn tùy chọn đó thay vì cung cấp một thao tác sẽ bị từ chối.
9. Ngân sách thử lại KYC
Một lần identity verification thất bại giờ đây cho biết lý do thất bại và số lần thử còn lại, thay vì chỉ thông báo thất bại. Mỗi user có ba lần thử, và thông báo hiển thị “Attempts remaining: 2/3” cùng lý do thực tế từ verification provider. Nút chuyển thành Try again khi vẫn còn lượt thử. Nếu đã sử dụng cả ba lần, thông báo giải thích rằng support có thể mở lại quy trình verification. Tìm hiểu thêm: Account Verification10. Georgian Checkout
Checkout giờ đây có sẵn bằng tiếng Georgian, nâng tổng số ngôn ngữ lên 22. Georgian được phát hiện từ browser của customer như mọi ngôn ngữ được hỗ trợ khác, hoặc bạn có thể buộc sử dụng ngôn ngữ này bằng parameterforce_language.
Tìm hiểu thêm: Supported Languages
11. Không bắt buộc thẻ khi giá là $0
Subscription giờ đây có thể bắt đầu mà không cần payment method bất cứ khi nào hôm nay không phát sinh khoản phải trả. Bật checkbox Card-Optional at $0 Price trong phần pricing của product, bên cạnh Trial Period (Days) và Default Discount (%). Có hai trường hợp không phát sinh khoản phải trả hôm nay và một checkbox này áp dụng cho cả hai:- Free trial — trial period không có trial amount, nên khoản charge đầu tiên là
0trong thời gian trial. - Recurring price $0 — price là
0ngay từ đầu, hoặc discount đưa price về mức đó, dù là Default Discount (%) của product hay các discount code được cộng dồn thành mức giảm 100% tại checkout.
payment_method_required: false. Sau đó, một email nhắc nhở sẽ được gửi trước khi billing thực tế bắt đầu — thời gian gửi trước bao lâu được thiết lập bằng Payment Method Reminder trong Settings → Subscriptions, từ 1 đến 30 ngày, mặc định là 3 ngày. Nếu thẻ không được thêm, subscription sẽ chuyển sang on_hold khi đến hạn charge thực tế đầu tiên, và việc thêm payment method sẽ kích hoạt lại subscription. Hai email customer bao quát trường hợp này, đều được bật mặc định: Add Payment Method Reminder và Subscription On Hold, No Payment Method.
Thông qua API, checkbox duy nhất này ánh xạ tới hai price field độc lập, trial_payment_method_optional và zero_amount_payment_method_optional, vì vậy bạn có thể tự bật từng trường hợp nếu quản lý product trực tiếp.
12. Tax ID bắt buộc tại Checkout
Checkout session chấp nhận một feature flagrequire_tax_id mới dành cho các doanh nghiệp chỉ bán cho doanh nghiệp đã đăng ký. Flag này mặc định là false, vì vậy không có gì thay đổi trừ khi bạn yêu cầu.
Khi flag được bật, Purchasing as a business được chọn sẵn và khóa trên checkout page, cả Business Name và Tax ID Number đều trở thành bắt buộc, đồng thời Continue to Payment vẫn bị làm mờ khi một trong hai trường còn trống hoặc Tax ID bị từ chối. Tax ID validation vẫn fail-open, nên sự cố khi tra cứu sẽ không hoàn toàn chặn customer.
allow_tax_id cũng phải là true, nếu không request sẽ bị từ chối với một 400; session được tạo bằng confirm: true phải mang theo tax_id vì nó bỏ qua checkout page hoàn toàn.
Yêu cầu này được áp dụng trên checkout page thay vì phía server — một confirmation được gửi trực tiếp đến API vẫn có thể bỏ qua tax_id, vì vậy hãy xem flag này là một tùy chọn kiểm soát trải nghiệm checkout, không phải một bảo đảm.
Tìm hiểu thêm: Making the Tax ID Mandatory