Dodo Payments cung cấp thông báo webhook theo thời gian thực để giữ cho bạn được thông báo về các sự kiện quan trọng liên quan đến giao dịch, đăng ký, hoàn tiền, tranh chấp và quản lý khóa bản quyền. Dưới đây là hướng dẫn chi tiết về các sự kiện này, được phân loại để dễ hiểu, cùng với các mẹo và cân nhắc khi triển khai.
Sự Kiện Thanh Toán
| Event Name | Event Type | Description |
|---|
| Payment Succeeded | payment.succeeded | Được kích hoạt khi một khoản thanh toán được xử lý thành công. |
| Payment Failed | payment.failed | Xảy ra khi một lần thử thanh toán thất bại do lỗi, thẻ bị từ chối hoặc các vấn đề khác. |
| Payment Processing | payment.processing | Cho biết một khoản thanh toán đang được xử lý. |
| Payment Cancelled | payment.cancelled | Được kích hoạt khi một khoản thanh toán bị hủy trước khi hoàn tất. |
Sự Kiện Hoàn Tiền
| Event Name | Event Type | Description |
|---|
| Refund Succeeded | refund.succeeded | Được kích hoạt khi hoàn tiền được xử lý thành công. |
| Refund Failed | refund.failed | Xảy ra khi một lần thử hoàn tiền thất bại do lỗi xử lý hoặc các vấn đề khác. |
Sự Kiện Tranh Chấp
| Event Name | Event Type | Description |
|---|
| Dispute Opened | dispute.opened | Được kích hoạt khi khách hàng khởi xướng tranh chấp. |
| Dispute Expired | dispute.expired | Cho biết tranh chấp đã hết hạn mà không được giải quyết. |
| Dispute Accepted | dispute.accepted | Được kích hoạt khi thương nhân chấp nhận tranh chấp. |
| Dispute Cancelled | dispute.cancelled | Xảy ra khi tranh chấp bị khách hàng hoặc hệ thống hủy bỏ. |
| Dispute Challenged | dispute.challenged | Được kích hoạt khi thương nhân phản bác tranh chấp. |
| Dispute Won | dispute.won | Cho biết thương nhân đã thắng tranh chấp. |
| Dispute Lost | dispute.lost | Xảy ra khi thương nhân thua một tranh chấp. |
Sự Kiện Đăng Ký
| Event Name | Event Type | Description |
|---|
| Subscription Active | subscription.active | Cho biết một đăng ký hiện đang hoạt động và các khoản phí định kỳ đã được lên lịch. |
| Subscription Updated | subscription.updated | Được kích hoạt khi bất kỳ trường đăng ký nào được cập nhật (đồng bộ thời gian thực mà không cần kiểm tra). |
| Subscription On Hold | subscription.on_hold | Được kích hoạt khi một đăng ký tạm thời bị tạm dừng do việc gia hạn thất bại. |
| Subscription Renewed | subscription.renewed | Xảy ra khi một đăng ký được gia hạn thành công. |
| Subscription Plan Changed | subscription.plan_changed | Được kích hoạt khi một đăng ký được nâng cấp, hạ cấp hoặc chỉnh sửa với các phần bổ trợ khác nhau. |
| Subscription Cancelled | subscription.cancelled | Được kích hoạt khi một đăng ký bị hủy bởi thương nhân hoặc khách hàng. |
| Subscription Failed | subscription.failed | Cho biết đăng ký thất bại. Điều này có nghĩa là chúng tôi không thể tạo một ủy quyền. |
| Subscription Expired | subscription.expired | Được kích hoạt khi một đăng ký đạt đến cuối hạn và hết hạn. |
Sự Kiện Khóa Bản Quyền
| Event Name | Event Type | Description |
|---|
| License Key Created | license_key.created | Được kích hoạt khi một khóa cấp phép mới được tạo cho sản phẩm. |
Sự kiện liên quan đến tín dụng
| Tên sự kiện | Loại sự kiện | Mô tả |
|---|
| Tín dụng được cộng | credit.added | Kích hoạt khi tín dụng được cấp cho khách hàng (gói đăng ký, một lần, bổ sung hoặc API). |
| Tín dụng bị trừ | credit.deducted | Xảy ra khi tín dụng được tiêu thụ thông qua việc sử dụng hoặc trừ thủ công. |
| Tín dụng hết hạn | credit.expired | Kích hoạt khi tín dụng chưa sử dụng hết hết hạn sau khoảng thời gian đã cấu hình. |
| Tín dụng được chuyển tiếp | credit.rolled_over | Xảy ra khi tín dụng chưa sử dụng được chuyển sang cấp phát mới vào cuối chu kỳ. |
| Tín dụng chuyển tiếp bị mất | credit.rollover_forfeited | Kích hoạt khi tín dụng bị mất vì đã đạt số lần chuyển tối đa. |
| Tính phí vượt định mức | credit.overage_charged | Xảy ra khi áp dụng phí vượt định mức cho việc sử dụng vượt quá số dư bằng 0. |
| Điều chỉnh thủ công | credit.manual_adjustment | Kích hoạt khi thực hiện điều chỉnh tín dụng hoặc trừ thủ công. |
| Số dư thấp | credit.balance_low | Kích hoạt khi số dư tín dụng giảm xuống dưới ngưỡng đã cấu hình. |
Last modified on March 2, 2026
