Các tính năng mới
1. Thanh toán dựa trên tín dụng
Dodo Payments hiện hỗ trợ Thanh toán dựa trên tín dụng, một hệ thống linh hoạt để phát hành, quản lý và theo dõi quyền lợi tín dụng cho các đăng ký, sản phẩm một lần và thanh toán dựa trên sử dụng. Thay vì tính phí theo từng lần sử dụng hoặc giới hạn quyền truy cập thông qua các cờ tính năng, bạn phân bổ một nhóm tín dụng để khách hàng rút ra khi họ tiêu thụ dịch vụ của bạn.
Bạn có thể làm gì
| Khả năng | Mô tả |
|---|
| Đơn vị tùy chỉnh hoặc tín dụng tiền tệ | Định nghĩa tín dụng theo đơn vị riêng của bạn (lượt gọi API, token, giờ tính toán) hoặc theo giá trị tiền tệ thực (USD, EUR) |
| Tín dụng đăng ký | Phát hành tín dụng mỗi chu kỳ thanh toán với việc cấp lại tự động khi gia hạn |
| Tín dụng một lần | Cấp một số dư tín dụng cố định khi mua, lý tưởng cho gói nạp thêm hoặc bộ khuyến mãi |
| Khấu trừ dựa trên sử dụng | Liên kết tín dụng với bộ đếm để khấu trừ tự động dựa trên sự kiện tiêu thụ theo thời gian thực |
| Chuyển tiếp | Cho phép tín dụng chưa sử dụng được chuyển sang kỳ sau với tỷ lệ % tối đa, khung thời gian và số lần chuyển tiếp có thể tùy chỉnh |
| Kiểm soát vượt hạn mức | Cho phép khách hàng tiếp tục sử dụng dịch vụ dù vượt số dư, với các tùy chọn xoá nợ, tính phí hoặc chuyển khoản số âm |
| Hết hạn | Đặt thời hạn tín dụng từ 7 ngày cho đến không bao giờ, với số ngày tùy chỉnh |
- Tín dụng được cấp - Cấp khi khách hàng mua sản phẩm kèm quyền lợi tín dụng. Với đăng ký, tín dụng được cấp lại mỗi chu kỳ thanh toán.
- Tín dụng được tiêu dùng - Khấu trừ khi khách hàng sử dụng dịch vụ. Bộ đếm tự động khấu trừ dựa trên sự kiện thời gian thực, hoặc bạn có thể khấu trừ thủ công qua bảng điều khiển hoặc API.
- Tín dụng hết hạn hoặc chuyển tiếp - Vào cuối chu kỳ thanh toán (hoặc sau khoảng thời gian hết hạn đã cấu hình), tín dụng chưa dùng sẽ hết hạn hoặc chuyển tiếp dựa trên cài đặt của bạn.
- Xử lý vượt hạn mức - Nếu tín dụng cạn giữa chu kỳ, bạn có thể cho phép tiếp tục sử dụng và chọn cách xử lý vượt hạn mức vào cuối chu kỳ.
Đính kèm tín dụng vào sản phẩm
Tín dụng được đính kèm như các quyền lợi trong quy trình tạo sản phẩm. Bạn có thể đính kèm tối đa 3 tín dụng cho mỗi sản phẩm, và tín dụng hoạt động với cả ba loại giá: đăng ký, thanh toán một lần và thanh toán dựa trên sử dụng.
// Create a checkout session for a product with attached credits
const session = await client.checkoutSessions.create({
product_cart: [
{
product_id: 'prod_ai_pro_plan',
quantity: 1,
}
],
customer: { email: 'customer@example.com' },
return_url: 'https://yourapp.com/success'
});
// Send usage events that deduct credits automatically
await fetch('https://api.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: `gen_${Date.now()}`,
customer_id: 'cus_abc123',
event_name: 'ai.generation',
timestamp: new Date().toISOString(),
metadata: { model: 'gpt-4', tokens: 1500 }
}]
})
});
| Sự kiện | Mô tả |
|---|
credit.added | Tín dụng được cấp cho khách hàng |
credit.deducted | Tín dụng được tiêu thụ qua sử dụng hoặc ghi nợ thủ công |
credit.expired | Tín dụng chưa dùng đã hết hạn |
credit.rolled_over | Tín dụng được chuyển tiếp sang cấp phát mới |
credit.rollover_forfeited | Tín dụng bị tịch thu khi đạt giới hạn chuyển tiếp tối đa |
credit.overage_charged | Áp dụng phí vượt hạn mức |
credit.manual_adjustment | Điều chỉnh tín dụng/ghi nợ thủ công |
credit.balance_low | Số dư giảm xuống dưới ngưỡng cấu hình |
Bắt đầu với các cài đặt đơn giản: không chuyển tiếp, không vượt hạn mức, rồi bổ sung dần khi bạn hiểu cách khách hàng sử dụng tín dụng. Hầu hết cài đặt có thể được cập nhật bất cứ khi nào mà không ảnh hưởng đến các cấp phát hiện có.
2. Tùy chỉnh thiết kế & chủ đề
Giới thiệu trang Thiết kế mới, một trung tâm thống nhất để tùy chỉnh giao diện và cảm nhận của trang thanh toán, cửa hàng và cổng khách hàng từ một nơi duy nhất. Chọn chủ đề có sẵn, cấu hình kiểu chữ và màu sắc, và áp dụng ghi đè theo từng phần, tất cả đều có bản xem trước trực tiếp trước khi lưu.
Điểm nổi bật chính
| Tính năng | Mô tả |
|---|
| Trung tâm thiết kế thống nhất | Cấu hình giao diện trang thanh toán, cửa hàng và cổng khách hàng từ một trang duy nhất |
| Chủ đề có sẵn | Bắt đầu với chủ đề được chọn lọc (Dodo Pulses, Terminal, Bumblebee hoặc Bubblegum) và tùy chỉnh từ đó |
| Chế độ sáng & tối | Định nghĩa bảng màu riêng cho mỗi chế độ |
| Xem trước trực tiếp | Xem trước các thay đổi trên trang thanh toán, cổng khách hàng và cửa hàng trước khi lưu |
| Ghi đè theo từng phần | Tinh chỉnh từng phần mà không ảnh hưởng đến phần khác |
| Điều khiển lập trình | Ghi đè chủ đề khi thanh toán thông qua API hoặc Checkout SDK |
| Tab | Mục đích |
|---|
| Tổng quan | Tên doanh nghiệp, logo, chọn chủ đề và cài đặt nâng cao chung |
| Thanh toán | Ghi đè cài đặt chủ đề riêng cho trang thanh toán |
| Cửa hàng | Ghi đè cài đặt chủ đề và cấu hình bố cục cửa hàng |
| Cổng khách hàng | Ghi đè cài đặt chủ đề cho cổng khách hàng |
- Dodo Pulses - Chủ đề mặc định với điểm nhấn xanh chanh và kiểu chữ sans-serif gọn gàng
- Terminal - Hướng đến nhà phát triển với kiểu chữ monospaced và điểm nhấn xanh hoàng gia
- Bumblebee - Điểm nhấn amber ấm áp và vàng sang trọng với phong cách đậm, cao cấp
- Bubblegum - Điểm nhấn hồng và magenta vui nhộn với các góc bo tròn hoàn toàn
Sau khi chọn chủ đề có sẵn, bạn có thể tùy chỉnh thêm từng thuộc tính trong Cài đặt nâng cao. Bất kỳ thuộc tính nào không được chỉ định sẽ trở về mặc định của chủ đề.
3. Trạng thái hoàn tiền và trạng thái tranh chấp trong API danh sách thanh toán
Đầu cuối danh sách GET /payments giờ bao gồm các trường refund_status và dispute_status trong mỗi mục thanh toán, giúp bạn xem trạng thái hoàn tiền và tranh chấp ngay lập tức mà không cần truy vấn từng thanh toán riêng lẻ.
| Trường | Loại | Mô tả |
|---|
refund_status | partial | full | null | Tóm tắt trạng thái hoàn tiền cho thanh toán này. null nếu không tồn tại hoàn tiền thành công |
dispute_status | string | null | Trạng thái tranh chấp gần nhất cho thanh toán này. null nếu không có tranh chấp |
dispute_status: dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost
Bạn cũng có thể lọc các thanh toán theo trạng thái tranh chấp bằng tham số truy vấn dispute_status:
# List all payments with open disputes
curl -X GET 'https://api.dodopayments.com/payments?dispute_status=dispute_opened' \
-H 'Authorization: Bearer YOUR_API_KEY'
Sử dụng các trường này để xây dựng bảng điều khiển tranh chấp và hoàn tiền, kích hoạt thông báo khi trạng thái tranh chấp thay đổi, hoặc lọc danh sách thanh toán để hiển thị các thanh toán cần chú ý.
4. Bảng hoàn tiền trong cổng khách hàng
Cổng khách hàng hiện bao gồm phần Hoàn tiền riêng, nơi khách hàng có thể xem tất cả khoản hoàn tiền liên quan đến các thanh toán của họ. Mỗi mục hoàn tiền hiển thị số tiền hoàn, trạng thái, ngày và thanh toán gốc mà nó được phát hành, giúp khách hàng nhìn rõ lịch sử hoàn tiền mà không cần liên hệ hỗ trợ.
Bảng hoàn tiền có sẵn tự động trong cổng khách hàng cho mọi doanh nghiệp. Không cần cấu hình.
5. Sao chép sang chế độ trực tiếp cho bộ đếm
Bạn giờ có thể sao chép bộ đếm từ chế độ thử nghiệm sang chế độ trực tiếp trực tiếp từ bảng điều khiển. Sau khi hoàn tất kiểm tra cấu hình bộ đếm ở chế độ thử nghiệm, sử dụng hành động sao chép để tái tạo nó ở chế độ trực tiếp với tất cả cài đặt được giữ nguyên: loại tổng hợp, tên sự kiện, bộ lọc và liên kết tín dụng. Điều này loại bỏ việc phải tạo lại bộ đếm thủ công khi chuyển từ phát triển sang sản xuất.
Xây dựng và xác thực cấu hình bộ đếm ở chế độ thử nghiệm trước, sau đó sao chép sang chế độ trực tiếp khi bạn sẵn sàng ra mắt. Điều này đảm bảo thiết lập thanh toán của bạn được kiểm tra trước khi xử lý lưu lượng khách hàng thực.
