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.
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: 'user@example.com' },
return_url: 'https://yoursite.com/return'
});
| 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 |
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 |
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.
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 |
| 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.
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) |
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'
});
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. 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.
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
