Lịch sử gửi webhook
Mở endpoint trong Webhooks và chọn delivery liên quan. Xem HTTP status, lỗi và số lần thử. Một PDF có thể thành công nhưng thông báo tới hệ thống của bạn thất bại; hai kết quả không đồng nghĩa nhau.
Kiểm tra endpoint
- URL còn đúng và HTTPS có certificate hợp lệ không?
- Endpoint có truy cập công khai được, hay chỉ mở trong mạng công ty?
- Backend có đọc raw body trước khi kiểm tra chữ ký không?
- Secret đã decode đúng cách và timestamp có được kiểm tra không?
- Server có trả lỗi hoặc xử lý quá chậm không?
Cơ chế gửi lại
Hệ thống có tối đa 10 lần thử giao theo luồng hiện tại; khoảng nghỉ giữa các lần lỗi khoảng 15 giây, có chênh lệch nhỏ. Khi hàng chờ hoặc giới hạn xử lý theo project bận, thời gian tổng có thể lâu hơn. Đừng coi đây là cam kết giao xong trong một thời gian cố định.
Không coi retry là một sự kiện nghiệp vụ mới. Backend cần nhận biết thông báo lặp để không gửi email hoặc ghi dữ liệu hai lần.
Khi cần hỗ trợ
Gửi render ID, delivery ID, thời điểm, HTTP status và thông báo lỗi đã che thông tin nhạy cảm. Không gửi API key, signing secret hoặc toàn bộ payload khách hàng thật. Nếu cần thử lại thao tác trong app, dùng test với dữ liệu demo.