Chữ ký không khớp
Nguyên nhân phổ biến nhất là ký JSON được phân tích cú pháp thay vì nội dung thô chính xác hoặc sử dụng dấu thời gian khác với tiêu đề yêu cầu.
Kiem tra Webhook
Kiểm thử WebhookĐối chiếu chữ ký
Chỉnh sửa nội dung mẫu, tạo chữ ký HMAC-SHA256 và yêu cầu cURL để kiểm thử logic xác minh.
01
Cấu hình kiểm thử
Nhập địa chỉ, khóa thử nghiệm và dấu thời gian.
Chữ ký được tính trong trình duyệt. Hãy dùng khóa thử nghiệm.
Dấu thời gian Unix tính bằng mili giây, như tiêu đề callback của BoltUtil.
02
Sửa nội dung, tạo chữ ký
Chữ ký và cURL cập nhật khi bạn sửa JSON.
Chu ky
HMAC-SHA256Nhập khóa, dấu thời gian và JSON hợp lệ.
Tính từ dấu thời gian, nội dung gốc và khóa thử nghiệm.
JSON hợp lệ
cURL / POSTYêu cầu thử nghiệm
Nhập địa chỉ, khóa, dấu thời gian và JSON hợp lệ.Callback đơn USDC mô phỏng, có thể đổi sang USDT. Đơn, địa chỉ và mã giao dịch là ví dụ, không phải bằng chứng thanh toán.
Công cụ không tự gửi yêu cầu. Hãy chạy cURL trong môi trường thử nghiệm của bạn.
Xác minh chữ ký
Xác minh trước khi tiếp tục
Xác minh theo cùng quy tắc, lưu sự kiện rồi cập nhật đơn hàng.
Xem hướng dẫn xác minhHMAC_SHA256(timestamp + "." + rawBody, secret)- 01
Xác minh cơ thể thô
Sử dụng dấu thời gian mili giây từ tiêu đề và phần nội dung thô chính xác để tính toán HMAC trước khi phân tích cú pháp JSON. Khoảng trắng, ngắt dòng và thứ tự trường ảnh hưởng đến chữ ký.
- 02
Sử dụng so sánh an toàn về thời gian
So sánh chữ ký nhận được với trình trợ giúp liên tục được cung cấp bởi thời gian chạy ngôn ngữ của bạn.
- 03
Ghi lại an toàn rồi trả lại 2xx
Chỉ trả về thành công sau khi ghi lại sự kiện hoặc đưa nó vào hàng đợi nội bộ lâu dài.
Xu ly su co Webhook
Vi sao Webhook thanh toan co the that bai
Phan lon van de den tu xac minh chu ky, parse body, xu ly retry hoac tra ve thanh cong truoc khi ghi ben vung su kien thanh toan.
Sai bí mật
Sử dụng bí mật webhook được định cấu hình cho điểm cuối của người bán. Khóa API và bí mật webhook phải được coi là thông tin xác thực khác nhau.
Trình phân tích cú pháp nội dung đã thay đổi tải trọng
Phần mềm trung gian JSON có thể sắp xếp lại hoặc định dạng lại tải trọng. Chụp phần thân thô trước khi phân tích cú pháp khi xác minh chữ ký HMAC.
Điểm cuối trả về không phải 2xx
Phản hồi ngoài 2xx là thất bại. Việc thử lại tùy loại callback, trạng thái HTTP và chính sách.
Quá trình xử lý không bình thường
Loại trùng theo mã đơn và trạng thái, hoặc ID sự kiện duy nhất. Một mã giao dịch có thể chứa nhiều chuyển khoản.
Thành công trước sự bền bỉ
Chỉ trả về HTTP 2xx sau khi ghi sự kiện vào cơ sở dữ liệu hoặc hàng đợi của bạn. Nếu không, sự cố có thể làm mất thông báo thanh toán đã hoàn tất.
Câu hỏi thường gặp
Cau hoi debug Webhook
Dung cac kiem tra nay khi thanh toan da hoan tat nhung ung dung cua ban chua cap nhat.
Tại sao xác minh chữ ký webhook của tôi không thành công?
Xác minh nội dung yêu cầu thô chính xác, tiêu đề dấu thời gian và bí mật webhook đã định cấu hình. Việc ký JSON được phân tích cú pháp hoặc nội dung được định dạng lại thường tạo ra một HMAC khác.
Điểm cuối webhook của tôi có nên trả về THÀNH CÔNG trong nội dung phản hồi không?
Không. BoltUtil dùng trạng thái HTTP: 2xx là nhận thành công. Xác minh và lưu sự kiện trước.
Tôi nên xử lý việc gửi webhook trùng lặp như thế nào?
Dùng ràng buộc duy nhất hoặc thao tác nguyên tử theo mã đơn và trạng thái, hoặc ID sự kiện. Không chỉ dùng mã giao dịch.
Khi nào điểm cuối của tôi nên trả về HTTP 2xx?
Trả 2xx sau khi xác minh và lưu sự kiện. Nếu thất bại, trả lỗi phù hợp; việc thử lại tùy loại callback và chính sách.