Đối chiếu sự kiện Webhook giao hàng Email với Ví trả trước

Đối chiếu sự kiện Webhook giao hàng Email với Ví trả trước.

Cơ chế tính phí email dựa trên sự kiện

Khi xử lý truyền thông giao dịch như gửi email cùng với các kênh ưu tiên cao như SMS hoặc tin nhắn OTP, việc giữ cho các tài khoản tài chính đồng bộ là rất quan trọng. Môi trường CPaaS trả trước mạnh mẽ dựa vào việc xác minh số dư ngay lập tức. Mỗi đợt gửi đi sẽ khởi chạy một lệnh giữ tiền trên số dư tài khoản trước khi yêu cầu giao hàng rời khỏi hàng đợi. IOSOR hoạt động với mức sàn trả trước bắt buộc là USD 20 để đảm bảo rằng các bên thuê hệ thống duy trì đủ thanh khoản cho các tin nhắn đang chờ. Nếu không có kiến trúc giữ tiền theo thời gian thực, lưu lượng tăng đột biến có thể làm cạn kiệt số dư.

Webhook giao hàng bất đồng bộ và trạng thái sổ cái

Việc gửi email bản chất là bất đồng bộ. Khi cơ sở hạ tầng của bạn gửi một payload, phản hồi tức thì chỉ xác nhận đã tiếp nhận chứ không phải việc phân phối cuối cùng vào hộp thư đến. Khi tin nhắn chuyển qua các giai đoạn gửi, webhook sẽ báo cáo các sự kiện chi tiết như delivered, bounced, dropped hoặc deferred. Nếu email được chuyển giao thành công cho đại lý chuyển thư nhận, khoản giữ số dư ban đầu sẽ chuyển thành khoản ghi nợ vĩnh viễn trên sổ cái. Ngược lại, nếu xảy ra hard bounce, khoản giữ phải được giải phóng hoặc hoàn tiền ngay lập tức, ngăn ngừa xói mòn số dư đối với tin nhắn không giao được.

Ngăn chặn tính phí hai lần đối với sự kiện bounce và drop

Ngăn chặn tính phí hai lần đòi hỏi phải ánh xạ vòng đời nghiêm ngặt giữa mã định danh tin nhắn và hồ sơ giao dịch tài chính. Trong các thiết lập khối lượng lớn xử lý lưu lượng hỗn hợp bao gồm SMS đích E.164, cập nhật trạng thái DLR và thông báo email, cơ chế thử lại có thể kích hoạt các payload webhook trùng lặp. Để bảo vệ bên thuê không bị tính phí hai lần cho một lần thử lại email, công cụ tính phí phải tương quan ID sự kiện webhook nhận được với khoản giữ ủy quyền ban đầu. Nếu sự kiện dropped theo sau trạng thái deferred, hệ thống sẽ đánh giá xem khoản giữ tạm thời đã được xử lý chưa.

Đối chiếu khóa idempotency trên các hàng đợi gửi

Khóa idempotency đảm bảo các hoạt động tài chính nguyên tử trên các đường ống xử lý bất đồng bộ. Khi một ứng dụng gửi yêu cầu email với một token idempotency duy nhất, hệ thống tính phí sẽ ghi lại ý định payload cùng với khoản giữ giao dịch. Nếu thời gian chờ mạng buộc khách hàng phải thử lại, hệ thống phía sau sẽ khớp token, ngăn chặn các mục nhập trùng lặp trong sổ cái. Khi lưu lượng tin nhắn của bên thuê mở rộng và mức tiêu thụ tài khoản tiến gần đến ngưỡng USD 1,000/tháng, việc thực thi nghiêm ngặt idempotency sẽ ngăn các vòng lặp thử lại nhỏ gây ra chênh lệch không đáng có.

Thực hành tốt nhất cho đối chiếu ví trả trước

Để duy trì sự nhất quán hoàn toàn giữa số liệu giao hàng và số dư của bên thuê, hãy triển khai quy trình đối chiếu dựa trên sự kiện để kiểm toán các khoản giữ chưa hoàn tất mỗi giờ. Đảm bảo nhật ký kiểm toán của bạn ghi lại tất cả các lệnh gọi lại webhook cùng với UUID sổ cái tương ứng. Để biết thêm chi tiết kỹ thuật, hãy xem lại hướng dẫn của chúng tôi về email trên cùng sổ prepaid, email giao dịch trong một ví và .

Bài liên quan: email trên cùng sổ prepaid · email giao dịch trong một ví · idempotency, thử lại và tiền.

Bắt đầu với IOSOR

Đăng ký webhook inbound cho accepted, bounced, deferred và complained. Khóa mỗi sự kiện vào cùng message-id với dòng debit prepaid trên ledger. Retry webhook phải idempotent — không debit lần hai. Chỉ hoàn sau bounce đã xác nhận; accepted muộn hoặc deferral không đẩy tiền về.

Điểm chính IOSOR

Webhook là sự thật sự kiện của ledger.