Chuyển đến nội dung chính
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 NameEvent TypeDescription
Payment Succeededpayment.succeededĐược kích hoạt khi một khoản thanh toán được xử lý thành công.
Payment Failedpayment.failedXả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 Processingpayment.processingCho biết một khoản thanh toán đang được xử lý.
Payment Cancelledpayment.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 NameEvent TypeDescription
Refund Succeededrefund.succeededĐược kích hoạt khi hoàn tiền được xử lý thành công.
Refund Failedrefund.failedXả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 NameEvent TypeDescription
Dispute Openeddispute.openedĐược kích hoạt khi khách hàng khởi xướng tranh chấp.
Dispute Expireddispute.expiredCho biết tranh chấp đã hết hạn mà không được giải quyết.
Dispute Accepteddispute.acceptedĐược kích hoạt khi thương nhân chấp nhận tranh chấp.
Dispute Cancelleddispute.cancelledXảy ra khi tranh chấp bị khách hàng hoặc hệ thống hủy bỏ.
Dispute Challengeddispute.challengedĐược kích hoạt khi thương nhân phản bác tranh chấp.
Dispute Wondispute.wonCho biết thương nhân đã thắng tranh chấp.
Dispute Lostdispute.lostXảy ra khi thương nhân thua một tranh chấp.

Sự Kiện Đăng Ký

Event NameEvent TypeDescription
Subscription Activesubscription.activeCho 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 Updatedsubscription.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 Holdsubscription.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 Renewedsubscription.renewedXảy ra khi một đăng ký được gia hạn thành công.
Subscription Plan Changedsubscription.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 Cancelledsubscription.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 Failedsubscription.failedCho 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 Expiredsubscription.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 NameEvent TypeDescription
License Key Createdlicense_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ệnLoại sự kiệnMô tả
Tín dụng được cộngcredit.addedKí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.deductedXả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ạncredit.expiredKí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ếpcredit.rolled_overXả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ấtcredit.rollover_forfeitedKí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ứccredit.overage_chargedXả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ôngcredit.manual_adjustmentKí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ấpcredit.balance_lowKích hoạt khi số dư tín dụng giảm xuống dưới ngưỡng đã cấu hình.
Các sự kiện webhook này được thiết kế để cung cấp cho thương gia các cập nhật quan trọng nhằm quản lý hoạt động một cách hiệu quả. Hãy triển khai các bộ xử lý vững chắc cho từng sự kiện liên quan trong tích hợp webhook của bạn để đảm bảo chức năng diễn ra trơn tru và đáng tin cậy.