> ## 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.105.0 (22 tháng 6, 2026)
> Mang Bộ Xử Lý Riêng (BYOP), phát hành SDK Rust chính thức, các phương thức thanh toán Hàn Quốc (Kakao Pay, Naver Pay, PAYCO) và Przelewy24, brand_id trên mỗi payload webhook, xử lý tiền tệ theo thập phân, giới hạn quyền lợi cao hơn, cùng các cải tiến checkout, phân tích và bảng điều khiển.
## Tính Năng Mới
### 1. **Mang Bộ Xử Lý Riêng (BYOP)**
Bây giờ bạn có thể kết nối bộ xử lý thanh toán riêng của mình — **Stripe** hoặc **Adyen** — và định tuyến thanh toán qua từng quốc gia khách hàng, trong khi Dodo Payments tiếp tục hỗ trợ mọi thứ trên đỉnh của giao dịch: sản phẩm, đăng ký, khóa giấy phép và quyền lợi, hóa đơn, cổng khách hàng, và phân tích. Các quốc gia bạn không định tuyến rõ ràng sẽ quay trở lại Dodo làm Đơn Vị Bán Hàng Đầy Đủ Dịch Vụ.
Thiết lập từ **Cài Đặt → BYOP** trong bảng điều khiển: chọn bộ xử lý, kết nối tài khoản của bạn, xác định quy tắc định tuyến theo quốc gia và thêm chi tiết phát hành hóa đơn của bạn.
**Điều gì thay đổi trên BYOP**
* **Bạn là Đơn Vị Bán Hàng.** Dodo **không** tính toán hoặc tính thuế trên các giao dịch BYOP — chi tiết phát hành hóa đơn của riêng bạn (tên doanh nghiệp, mã số thuế và địa chỉ) thay thế cho Dodo trên hóa đơn và biên lai hoàn tiền.
* **Tranh chấp và hoàn tiền được xử lý trong bộ xử lý của bạn.** Tranh chấp BYOP chỉ đọc trong bảng điều khiển của Dodo, vì chấp nhận/thách thức xảy ra trong Stripe hoặc Adyen.
* Thanh toán định tuyến qua Hyperswitch và hiện hỗ trợ **thẻ tín dụng và thẻ ghi nợ chỉ**.
**Dành cho nhà phát triển**
Phản hồi thanh toán và tranh chấp giờ đây bao gồm `is_byop` và một phân biệt `payment_provider` (`stripe`, `adyen`, hoặc `dodo`) để bạn có thể xác định cách từng giao dịch được định tuyến. Các trường này là bổ sung — lưu lượng Đơn Vị Bán Hàng tiếp tục báo cáo `payment_provider: dodo`.
Tìm hiểu thêm: [Mang Bộ Xử Lý Riêng](/features/byop) | [BYOP với Stripe](/features/byop/stripe) | [BYOP với Adyen](/features/byop/adyen)
### 2. **Phát Hành SDK Rust Chính Thức**
SDK Rust chính thức **Dodo Payments** hiện đã có sẵn dưới dạng crate `dodopayments` trên crates.io. Dòng phát hành này khớp với dòng phiên bản API Dodo Payments, với `v1.105.0` là phiên bản phát hành API công khai đầu tiên và `v1.106.0` đã được phát hành với tái tạo OpenAPI mới nhất.
Cài đặt nó với Cargo:
```bash theme={null}
cargo add dodopayments
```
SDK yêu cầu **Rust 1.75+** và được xây dựng cho các ứng dụng Rust không đồng bộ với Tokio và reqwest. Nó bao gồm:
* Các mô hình yêu cầu và phản hồi kiểu mạnh trên toàn bộ bề mặt API Dodo Payments.
* `Client::from_env()` cho việc đọc `DODO_PAYMENTS_API_KEY` từ môi trường.
* Trợ giúp phân trang kiểu, bao gồm `get_next_page()` và `into_stream()` cho các điểm cuối danh sách.
* Môi trường và thời gian chờ có thể cấu hình, bao gồm hỗ trợ chế độ thử nghiệm.
* Giải mã phản hồi kiểu nhị phân cho các phản hồi kiểu PDF như hóa đơn, hóa đơn thanh toán và hóa đơn hoàn tiền.
* API xây dựng chuỗi tài nguyên lưu loát cho các điểm gọi Rust tiện lợi.
Tìm hiểu thêm: [Rust SDK](/developer-resources/sdks/rust) | [Crates.io](https://crates.io/crates/dodopayments) | [GitHub](https://github.com/dodopayments/dodopayments-rust)
### 3. **Phương Thức Thanh Toán Mới: Ví Hàn Quốc & Przelewy24**
Bốn phương thức thanh toán địa phương mới hiện có sẵn, mở rộng phạm vi tại Hàn Quốc và Ba Lan.
**Hàn Quốc (KRW)** — ba ví Hàn Quốc hiển thị trên checkouts KRW:
| Phương Thức | Loại API | Đăng Ký |
| ------------- | ----------- | ------------------- |
| **Kakao Pay** | `kakao_pay` | Có |
| **Naver Pay** | `naver_pay` | Có |
| **PAYCO** | `payco` | Không (chỉ một lần) |
Ví Hàn Quốc yêu cầu một quốc gia thanh toán là `KR` và thanh toán `KRW` — nếu sản phẩm của bạn được định giá bằng đơn vị tiền tệ khác, kích hoạt Tiền tệ Thích ứng để khách hàng được tính bằng KRW.
**Ba Lan (PLN)** — **Przelewy24 (P24)**, phương thức thanh toán trực tuyến hàng đầu của Ba Lan, hiện được thanh toán bằng `PLN` (không phải EUR) và hỗ trợ thanh toán một lần. Truyền `przelewy24` trong `allowed_payment_method_types`.
Tìm hiểu thêm: [Phương Thức Thanh Toán Hàn Quốc](/features/payment-methods/south-korea) | [Phương Thức Thanh Toán Châu Âu](/features/payment-methods/europe) | [Tổng Quan Về Phương Thức Thanh Toán](/features/payment-methods)
### 4. **`brand_id` trên Mỗi Payload Webhook**
Mỗi payload sự kiện webhook giờ bao gồm `brand_id`, để bạn có thể gán thanh toán, đăng ký, hoàn tiền, tranh chấp, khóa giấy phép, mục nhập sổ cái tín dụng, quyền cấp quyền lợi, các lần thử dunning, và các lần checkout bị bỏ rơi cho một thương hiệu cụ thể. Khi một thực thể không có thương hiệu riêng, `brand_id` sẽ quay trở lại thương hiệu chính của doanh nghiệp.
Không cần thay đổi tích hợp — trường này là bổ sung và xuất hiện tự động trên các điểm cuối webhook hiện có.
Tìm hiểu thêm: [Nhiều Thương Hiệu](/features/multi-brands) | [Các Sự Kiện Webhook](/developer-resources/webhooks/intents/webhook-events-guide)
### 5. **Xử Lý Tiền Tệ Nhận Biết Thập Phân**
Xử lý tiền tệ đã được làm lại để số tiền được tính toán và hiển thị với độ chính xác cho từng loại tiền tệ, thay vì giả định hai chữ số thập phân ở mọi nơi. **16 loại tiền tệ không có chữ số thập phân** — bao gồm **JPY**, **KRW**, **VND**, **CLP**, **XAF**, và **XOF** — giờ đây được xử lý chính xác trên các khoản thanh toán, hóa đơn, phiếu thanh toán, email, phân tích, và chuyển đổi theo trình diễn (Tiền tệ Thích ứng) có nhận biết độ chính xác từ đầu đến cuối.
Điều này loại bỏ một loại lỗi làm tròn và hiển thị cho các loại tiền tệ không có chữ số thập phân và đặt nền tảng cho các độ chính xác bổ sung trong tương lai.
## Cải Tiến
### 6. **Giới Hạn Quyền Lợi Sản Phẩm & Tín Dụng Cao Hơn**
* **Quyền lợi sản phẩm** trên mỗi sản phẩm tăng từ **20 lên 50**.
* **Quyền lợi tín dụng** (tín dụng gắn với một sản phẩm) tăng từ **3 lên 5**.
Tìm hiểu thêm: [Quyền Lợi](/features/entitlements/introduction) | [Thanh Toán Dựa Trên Tín Dụng](/features/credit-based-billing)
### 7. **Tín Dụng Khách Hàng Có Chữ Ký Trong Đổi Kế Hoạch Dự Kiến**
Bản xem trước đổi kế hoạch giờ trả về `customer_credits` dưới dạng giá trị **có chữ ký**: **âm** khi tín dụng bị khấu trừ để bù đắp một khoản phí (thường xảy ra khi nâng cấp) và **dương** khi tín dụng được thêm vào (từ hoàn trả tỷ lệ giảm cấp hoặc nạp tiền ví), làm rõ liệu tín dụng có đang được sử dụng hay được cấp.
Tìm hiểu thêm: [Nâng cấp & Giảm cấp Đăng ký](/developer-resources/subscription-upgrade-downgrade)
### 8. **`card_last_four` và `card_network` trên Danh Sách Thanh Toán**
Phản hồi **Danh Sách Thanh Toán** giờ bao gồm `card_last_four` và `card_network` trên mỗi khoản thanh toán, để bạn có thể hiển thị chi tiết thẻ trong danh sách mà không cần lấy từng khoản thanh toán riêng lẻ.
Tìm hiểu thêm: [Danh Sách Thanh Toán](/api-reference/payments/get-payments)
### 9. **Email ACR & Dunning Được Thương Hiệu Hóa**
Email phục hồi giỏ hàng bị bỏ rơi (ACR) và phục hồi dunning đăng ký giờ sử dụng tên và logo của **thương hiệu** liên quan thay vì bộ mặc định của doanh nghiệp, để trải nghiệm phục hồi phù hợp với thương hiệu mà khách hàng đã mua.
Tìm hiểu thêm: [Phục Hồi Dunning Đăng Ký](/features/recovery/subscription-dunning) | [Phục Hồi Giỏ Hàng Bị Bỏ Rơi](/features/recovery/abandoned-cart-recovery)
### 10. **Cải Thiện Xác Thực Mã Số Thuế**
Xác thực mã số thuế tại checkout đã được mở rộng với **phát hiện ký hiệu và tra cứu trong sổ đăng ký** (thông qua tích hợp Tax ID Pro), giảm các từ chối mã số thuế hợp lệ sai. Biểu mẫu xác minh doanh nghiệp giờ đây bao gồm một **bộ chọn quốc gia** để ngăn chặn lỗi xác thực mã số thuế, và file tải lên trở nên đáng tin cậy hơn với **chỉ báo tiến trình** và một thông báo lỗi hợp nhất duy nhất.
### 11. **Cải Tiến Phân Tích**
Phân tích bảng điều khiển giờ bao gồm MRR đăng ký được chỉnh sửa, số lượng đăng ký hoạt động và tính toán giữ/churn.
* **Phân tích từng trang** — các ô mới hiển thị hiệu suất doanh thu và giảm giá theo mỗi trang checkout.
* Tùy chọn chuyển đổi **doanh thu tổng/thực** và phân chia **MRR** trên chế độ xem doanh thu.
* Tooltip biểu đồ giờ hiển thị đơn vị tiền tệ và phần trăm, bao gồm cả điểm không có giá trị.
### 12. **Đánh Bóng Bảng Điều Khiển & Giao Diện Storefront**
* **Bộ lọc thương hiệu** được thêm vào danh sách sản phẩm, với các bộ lọc được kết hợp thành một nút duy nhất và các thương hiệu được tải lười.
* **Bộ sưu tập sản phẩm, tiện ích bổ sung, và biểu mẫu tín dụng** được làm lại với luồng tạo / chỉnh sửa / sao chép.
* **Trang cài đặt thanh toán** được thiết kế lại, với khả năng phục hồi một lần thanh toán thất bại thành thành công.
* **Phù hiệu nhà cung cấp thanh toán** (Stripe / Adyen / Dodo) được hiển thị trên các bảng giao dịch và tranh chấp.
* **Storefront** nội dung biên tập cửa hàng được tinh chỉnh.
### Các Sửa Chữa & Cải Tiến Khác
* Các loại tiền Hàn Quốc và một số loại tiền khác (VND, PYG, XOF, XAF) giờ mặc định là tiền địa phương tại checkout.
* Các sửa lỗi nhỏ và cải tiến ổn định trên toàn nền tảng.