IOSOR

IOSOR Kiến thức

Webhook trùng lặp không được tạo khoản ghi nợ thứ hai

Đường dẫn lỗi: thử lại và phát lại giữ nguyên tính bất biến trên tiền trả trước và hộp thư đến — một ID sự kiện, một dòng ghi nợ, một dòng hộp thư đến.

Việc giao hàng ít nhất một lần sẽ thử lại. Một webhook trùng lặp đăng khoản ghi nợ thứ hai hoặc dòng hộp thư đến thứ hai là sự cố tiền bạc và vận hành, không phải xác nhận vô hại. Trang này là đường dẫn lỗi: thử lại và phát lại giữ nguyên tính bất biến trên tiền trả trước và hộp thư đến — không phải bài luận về tính bất biến khi gửi API và không phải cẩm nang thử lại SMS đến.

Liên quan: Cổng xác thực chữ ký và cửa sổ phát lại, Hợp đồng webhook trước lần gửi đầu tiên, Dòng debit và trạng thái giao trên cùng ledger.

IOSOR là trả trước nhãn trắng. USD 20 tài trợ cho khói sự kiện trùng lặp trên một người tiêu dùng; đánh giá mềm gần USD 1.000/tháng định giá việc thử lại như một khoản phí mới. Khách hàng chỉ nhìn thấy ID sự kiện nhãn trắng.

Tính bất biến là đường dẫn lỗi, không phải khẩu hiệu

Đường dẫn thành công: một sự kiện được ký, một chấp nhận, một ghi nợ. Đường dẫn lỗi làm mất niềm tin — thời gian chờ, lỗi 5xx, phát lại nhà cung cấp, đẩy lại nhà điều hành. Lưu trữ khóa bất biến từ Hợp đồng webhook trước lần gửi đầu tiên trước các tác dụng phụ gồm sổ cái, hộp thư đến và CRM. Mức USD 1.000/tháng mềm coi ACK sau đó phát minh khóa mới là nợ khối lượng; USD 20 chứng minh việc phát lại cưỡng bức không bao giờ nhân đôi tiền.

Điều gì được tính là trùng lặp

Tín hiệu Coi là trùng lặp khi Kết quả an toàn
ID sự kiện Cùng ID đã được chấp nhận trong cửa sổ ACK; không ghi nợ lần hai
ID tin nhắn Cùng tin nhắn đã liên kết sổ cái Dùng lại dòng; không tính phí mới
Khóa hộp thư đến Cùng MO/MT đã được lưu Không có dòng hộp thư đến thứ hai
Ngoài cửa sổ phát lại Thử lại cũ sau khi từ chối cổng Từ chối; không ghi tiền hoặc trạng thái
Loại không rõ Không có trong danh sách sự kiện hợp đồng Bỏ; không có thành công bịa đặt

Cổng xác thực chữ ký và cửa sổ phát lại quyết định tính xác thực và độ tươi mới. Trang này quản lý những gì xảy ra sau một bản sao hợp lệ: một trạng thái cuối, một dòng tiền và một dòng hộp thư đến.

Tiền không được chuyển động hai lần

Khoản ghi nợ thứ hai cho cùng một ID sự kiện là một lỗi ngay cả khi sản phẩm vẫn hiển thị đã giao. Bộ phận tài chính lọc theo ID sự kiện và thấy một hàng trả trước cho cửa sổ UTC đó. Tác dụng phụ một phần sau ACK — CRM trước, sổ cái sau — tạo ra sự thật kép. Nếu quá trình xử lý thất bại sau khi lưu, hãy thử lại trình làm việc trên cùng một khóa.

Hộp thư đến cũng không được nhân đôi

Tính bất biến không chỉ là tiền bạc. Sự kiện giao hàng hoặc đến được phát lại mở ra luồng hộp thư đến thứ hai sẽ huấn luyện bộ phận hỗ trợ đuổi theo ma và kích hoạt vòng lặp tự động trả lời. Lưu trữ khóa hộp thư đến với cùng ID sự kiện được dùng cho ghi nợ. Sản phẩm và tài chính chia sẻ logic từ chối sạch sẽ.

Danh sách kiểm tra của người mua cho webhook an toàn trùng lặp

Xác thực chữ ký và tiêu đề trước khi chạm vào sổ cái. Khóa ID sự kiện trong cơ sở dữ liệu để chặn tranh chấp luồng. Luôn trả về mã 2xx sau khi xử lý thành công nhưng không bao giờ ghi nợ lần thứ hai. Giám sát phải báo cáo các sự kiện trùng lặp ngay lập tức.

Bắt đầu với IOSOR

Ép một phát lại đã ký trong cửa sổ trên hành lang đã trừ tiền. Xuất event id cạnh id sổ cái và chứng minh một dòng debit cùng một dòng hộp thư. Nếu debit thứ hai xuất hiện, dừng consumer đó và hoàn dòng thừa — đừng bù bằng lưu lượng sau. Cổng này là tiền phát lại, không phải kiểm E.164 hay lời SMS giao hàng.

Điểm chính IOSOR

Phát lại không phải gửi mới. Một event id viết một debit.

Làm: giữ chữ ký và cửa sổ phát lại, rồi chứng một debit sau POST trong cửa sổ. Đừng: trừ mọi POST, hoặc coi thử lại mạng là hóa đơn thứ hai.

Hướng dẫn này có hữu ích không?

Hướng dẫn liên quan