> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# v1.113.6 (22 tháng 8, 2026)

> Tạm dừng và tiếp tục gói đăng ký thông qua trường trạng thái, thay thế trường tạm dừng đã bị xóa, cùng với Purchasing Power Parity tích hợp sẵn với tỷ lệ phần trăm theo từng quốc gia, Charm Pricing, lưu trữ doanh nghiệp và thương hiệu, trang Milestones và trải nghiệm thiết lập có hướng dẫn.

## Các thay đổi phá vỡ tương thích

**Trường boolean `pause` trên `PATCH /subscriptions/{subscription_id}` đã bị xóa.** Trường này giờ luôn trả về lỗi `422` thay vì âm thầm không thực hiện thao tác nào, vì vậy một integration vẫn gửi trường này sẽ nhận được lỗi rõ ràng thay vì một subscription không bao giờ được tạm dừng.

Thao tác tạm dừng và tiếp tục đã được chuyển sang trường `status`: gửi `{"status": "paused"}` để tạm dừng và `{"status": "active"}` để tiếp tục. Không có endpoint tạm dừng riêng. Mỗi giá trị phải được gửi riêng — kết hợp giá trị đó với bất kỳ trường nào khác cũng sẽ bị từ chối với lỗi `422`.

Nếu bạn đã tích hợp với API tạm dừng theo tài liệu trước đây, hãy cập nhật các lệnh gọi đó trước khi nâng cấp.

Tìm hiểu thêm: [Tạm dừng và tiếp tục gói đăng ký](/features/subscription#pausing-and-resuming-subscriptions)

## Tính năng mới

### 1. **Tạm dừng và tiếp tục gói đăng ký**

Merchant giờ đây có thể tạm dừng và tiếp tục các gói đăng ký trực tiếp từ trang chi tiết gói đăng ký trong dashboard. Customer có thể tạm dừng từ Customer Portal khi được cho phép trong cài đặt doanh nghiệp của bạn.

**Các tùy chọn dành cho Merchant**

Tạm dừng hoặc tiếp tục một gói đăng ký bằng nút **Tạm dừng gói đăng ký** hoặc **Tiếp tục gói đăng ký** trên trang chi tiết gói đăng ký.

<Frame>
  <img src="https://mintcdn.com/dodopayments/JB6sccx0km6wps_z/images/subscriptions/pause-subscription-dashboard.png?fit=max&auto=format&n=JB6sccx0km6wps_z&q=85&s=c0e9a0f99d941d703f97b8c694f1f8d7" alt="Trang chi tiết gói đăng ký trong dashboard hiển thị nút Tạm dừng gói đăng ký cùng với Cập nhật và Hủy gói đăng ký" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="885" data-path="images/subscriptions/pause-subscription-dashboard.png" />
</Frame>

**Cài đặt doanh nghiệp**

Hai cài đặt mới xuất hiện trong **Cài đặt → Gói đăng ký**:

* **Cho phép tạm dừng gói đăng ký** — "Cho phép customer tạm dừng và tiếp tục gói đăng ký bất kỳ lúc nào từ customer portal"
* **Tính phí mức sử dụng khi tạm dừng** — "Tính phí phần mức sử dụng còn nợ của gói đăng ký dựa trên mức sử dụng ngay khi gói đăng ký được tạm dừng"

**Trải nghiệm của Customer**

Khi customer tạm dừng từ Customer Portal, họ sẽ thấy cảnh báo: quyền truy cập sẽ bị thu hồi ngay lập tức khi tạm dừng. Các tính năng, nội dung tải xuống và license key sẽ ngừng hoạt động cho đến khi gói đăng ký được tiếp tục.

Tìm hiểu thêm: [Gói đăng ký](/features/subscription) | [Customer Portal](/features/customer-portal)

### 2. **Purchasing Power Parity**

PPP tích hợp sẵn thay thế việc phụ thuộc vào các công cụ bên thứ ba. Đặt tỷ lệ phần trăm cho từng quốc gia trên toàn doanh nghiệp từ sheet **Giá theo quốc gia** trong **Cài đặt doanh nghiệp**. Các tỷ lệ phần trăm này áp dụng cho mọi sản phẩm đã bật PPP.

**Cách hoạt động**

* Mỗi sản phẩm được bật riêng thông qua checkbox **Purchasing Power Parity** trong phần định giá của sản phẩm.
* PPP yêu cầu bật Adaptive Currency. Nếu Adaptive Currency bị tắt cho doanh nghiệp, lựa chọn bật PPP cho sản phẩm sẽ bị từ chối.

<Frame>
  <img src="https://mintcdn.com/dodopayments/IwVqFRrixZtmLsQJ/images/ppp/country-percentages.png?fit=max&auto=format&n=IwVqFRrixZtmLsQJ&q=85&s=65667f71738c7853304c7b98de9a8e56" alt="Sheet Giá theo quốc gia hiển thị tỷ lệ phần trăm và mức giá tương ứng cho từng quốc gia" style={{ maxHeight: '500px', width: 'auto' }} width="573" height="992" data-path="images/ppp/country-percentages.png" />
</Frame>

Tìm hiểu thêm: [Purchasing Power Parity](/features/purchasing-power-parity)

### 3. **Charm Pricing**

Làm tròn giá đã chuyển đổi thành các giá trị hấp dẫn về mặt tâm lý, được cấu hình từ sheet **Thiết lập Charm Pricing** trong Cài đặt doanh nghiệp. Một bước làm tròn được đặt cho mỗi khoảng giá (band), vì vậy giá nhỏ và giá lớn sẽ được làm tròn khác nhau.

**Các kiểu làm tròn**

Chọn một trong bốn kiểu làm tròn (Nearest là điểm bắt đầu được khuyến nghị):

* **Nearest** — làm tròn đến bước gần nhất
* **Floor** — làm tròn xuống
* **Ceiling** — làm tròn lên
* **Whole** — làm tròn thành số nguyên

Bản xem trước **Dùng thử** cho biết một số tiền cụ thể sẽ được làm tròn như thế nào trước khi bạn lưu.

<Frame>
  <img src="https://mintcdn.com/dodopayments/Ovz6j1aDoP1Nl_kB/images/charm-pricing/bands.png?fit=max&auto=format&n=Ovz6j1aDoP1Nl_kB&q=85&s=49814c0af4e7d120d4ae64c868943a84" alt="Bảng các band Charm Pricing với một bước làm tròn cho mỗi khoảng giá" style={{ maxHeight: '500px', width: 'auto' }} width="527" height="485" data-path="images/charm-pricing/bands.png" />
</Frame>

Tìm hiểu thêm: [Charm Pricing](/features/charm-pricing)

### 4. **Lưu trữ doanh nghiệp và thương hiệu**

Lưu trữ một doanh nghiệp mà bạn không còn kinh doanh nữa từ **Cài đặt doanh nghiệp → Vùng nguy hiểm → Lưu trữ doanh nghiệp**. Thao tác này chỉ dành cho owner và không thể hoàn tác.

**Danh sách kiểm tra điều kiện**

Tất cả bảy điều kiện phải được đáp ứng trước khi cho phép lưu trữ:

* Không có khoản thanh toán nào trong 180 ngày qua
* Tất cả số dư ví đều bằng 0
* Không có payout nào đang được xử lý
* Không có tranh chấp nào đang mở
* Không có khoản hoàn tiền nào đang chờ xử lý
* Không có gói đăng ký nào đang hoạt động
* Tất cả số dư của customer đều bằng 0

<Frame>
  <img src="https://mintcdn.com/dodopayments/wseRJZn2cgbMg0kW/images/archive-business/danger-zone-checklist.png?fit=max&auto=format&n=wseRJZn2cgbMg0kW&q=85&s=055e362ab0dc06d7a26f0dc7e8b6949b" alt="Danh sách kiểm tra điều kiện trong Vùng nguy hiểm hiển thị bảy điều kiện để lưu trữ" style={{ maxHeight: '500px', width: 'auto' }} width="2429" height="1366" data-path="images/archive-business/danger-zone-checklist.png" />
</Frame>

**Quy trình xác nhận**

Việc xác nhận yêu cầu một mã gồm 6 chữ số được gửi qua email cho owner. Bạn có ba lần thử và mã sẽ hết hạn sau 10 phút.

Thương hiệu có thể được lưu trữ riêng với doanh nghiệp.

Tìm hiểu thêm: [Lưu trữ doanh nghiệp](/features/archive-business)

### 5. **Milestones**

Trang **Milestones** mới tôn vinh sự phát triển của doanh nghiệp bạn, tại **Doanh số → Milestones** trong dashboard. Bốn danh mục theo dõi tiến độ của bạn: **Địa lý**, **Doanh thu**, **Tăng trưởng** và **Customer**.

**Thẻ tiến độ và thành tựu**

* **Sắp đạt được** hiển thị các Milestones đang trong tầm với, mỗi Milestones có phần trăm hoàn thành
* **Hãy nhìn lại chặng đường đã đi** tôn vinh những Milestones bạn đã đạt được

Milestones đã đạt sẽ tạo ra một thẻ có thể chia sẻ. **Chia sẻ** mở bản xem trước với tùy chọn bật/tắt **Bao gồm doanh nghiệp và logo** và nút **Tải xuống** để lưu thẻ dưới dạng hình ảnh.

<Frame>
  <img src="https://mintcdn.com/dodopayments/eKddsSdEn5oeN8uH/images/milestones/milestones-page.png?fit=max&auto=format&n=eKddsSdEn5oeN8uH&q=85&s=59f3274e34825fddf45c92181cace534" alt="Trang Milestones hiển thị các Milestones đang thực hiện trong mục Sắp đạt được và các Milestones đã đạt trong mục Hãy nhìn lại chặng đường đã đi" style={{ maxHeight: '500px', width: 'auto' }} width="3004" height="1724" data-path="images/milestones/milestones-page.png" />
</Frame>

### 6. **Trải nghiệm thiết lập có hướng dẫn**

Mọi quy trình đăng ký giờ đây đều dẫn đến một hộp thoại onboarding duy nhất, có thể truy cập lại sau từ nút **Hướng dẫn thiết lập** trong phần đầu dashboard. Tiến độ được lưu lại, vì vậy hướng dẫn sẽ tiếp tục từ nơi bạn đã dừng. Việc chuyển sang live được đánh dấu bằng một màn hình chúc mừng.

Các sản phẩm được tạo ở test mode có thể được sao chép sang live bằng **Nhập từ Test** trên trang Sản phẩm.
