Webhook Payloads
Webhook Thanh toán dựa trên credit
Payload được gửi đến webhook endpoint của bạn khi các sự kiện thanh toán dựa trên credit xảy ra — credit ảo được cấp, sử dụng, hết hạn, chuyển sang kỳ tiếp theo hoặc có cảnh báo số dư.
Sự kiện Webhook thanh toán dựa trên tín dụng
Các sự kiện webhook sau đây có sẵn để theo dõi các thay đổi vòng đời thanh toán dựa trên tín dụng. Những sự kiện này áp dụng cho quyền lợi tín dụng ảo (lần gọi API, token, giờ tính toán), không áp dụng cho Ví Khách hàng (số dư tiền tệ).Sự kiện Sổ cái
Tất cả các sự kiện sổ cái (credit.added đến credit.manual_adjustment) dùng chung payload CreditLedgerEntryResponse được mô tả trong sơ đồ dưới đây.
Payload bao gồm một trường metadata được giải quyết từ nguồn của khoản tín dụng — đăng ký hoặc thanh toán được tạo khi thanh toán. Điều này cho phép bạn khóa tín dụng ví của mình khi thanh toán metadata (ví dụ, một orgId) thay vì customer_id do Dodo phát hành: các khoản tín dụng có nguồn từ đăng ký hiển thị metadata của đăng ký và các khoản tín dụng có nguồn từ thanh toán hiển thị metadata của thanh toán. Trường này trống khi khoản tín dụng không có nguồn có thể giải quyết (ví dụ, tín dụng cấp trực tiếp qua API).
Sự kiện Số dư Thấp (credit.balance_low)
Sự kiệncredit.balance_low sử dụng payload khác (CreditBalanceLowPayload) tập trung vào cảnh báo ngưỡng:
Sử dụng credit.balance_low cho Proactive Alerts
Sử dụng webhook credit.balance_low để thông báo cho khách hàng trước khi họ sử dụng hết credit:
Get Customer Balance
Kiểm tra số dư hiện tại của khách hàng qua API.
Create Ledger Entry
Cộng hoặc trừ credit khỏi số dư của khách hàng theo cách thủ công.
Lược đồ Payload của Webhook
Response for a ledger entry
Lần sửa đổi cuối 26 tháng 9, 2026