IOSOR Kiến thức

Gửi từ người dùng cuối vẫn tính vào một sổ cái trả trước

Gửi nhúng vẫn trừ tiền từ ví trả trước của ISV. Không tạo ra sổ cái thứ hai mà sản phẩm không cấp vốn — giữ tiền, thử lại và tính đồng nhất giữ đúng thực tế.

Tin nhắn nhúng mang lại cảm giác miễn phí cho người dùng cuối: họ nhấn Gửi bên trong giao diện SaaS và thấy dấu tích xanh. Bên dưới lớp kính, mỗi lần gửi thành công vẫn tính vào một sổ cái trả trước do ISV sở hữu. Không có ví thứ hai nào xuất hiện chỉ vì sản phẩm đã nhúng API. Nếu ISV không nạp tiền cho khoản tạm giữ, việc gửi phải thất bại với lỗi sản phẩm trung thực — không phải trạng thái đã giao giả tạo.

Kế toán hư cấu là nguyên nhân thất bại: bộ đếm tín dụng trong ứng dụng không được đảm bảo bởi ví IOSOR, hoàn tiền SaaS trong khi sổ cái trả trước bị tiêu tốn, hoặc thử lại mà không có tính đồng nhất khiến một mã OTP bị trừ tiền hai lần. Việc nhúng chỉ ẩn bảng điều khiển; ISV vẫn là bên cấp vốn.

Dòng tài liệu kiến trúc: gửi từ người dùng cuối ≡ trừ tiền trả trước của ISV. Mọi bài đánh giá thiết kế đều bắt đầu từ đó.

Một sổ cái, ngay cả khi giao diện hiển thị tín dụng sản phẩm

Các gói tin nhắn bán cho bên thuê là một lớp thương mại của ISV. Chúng phải ánh xạ tới các khoản tạm giữ và trừ tiền trả trước trên một ví IOSOR duy nhất mà ISV cấp vốn. Số dư của bên thuê không bao giờ đối soát với các dòng sổ cái là một quả bom nợ hỗ trợ. Xuất mức sử dụng của bên thuê hàng tuần so với các dòng ví để bộ phận tài chính thấy cùng một mức tiêu tốn như sản phẩm.

Tạm giữ và idempotency vẫn bắt buộc trên các đường dẫn nhúng

Việc gửi từ phía máy chủ phải sử dụng khóa idempotency cho OTP và SMS giao dịch. Việc nhấp đôi trong giao diện SaaS không được tạo ra hai lần trừ tiền cho một hành động của người dùng. Thử lại sau khi hết thời gian chờ phải tuân theo cùng một khóa cho đến khi có DLR cuối cùng hoặc lỗi được ánh xạ. Khi ví không thể tạm giữ, hãy trả về trạng thái không đủ tiền hoặc tạm dừng gửi nguyên bản của sản phẩm.

Ánh xạ lỗi sản phẩm với thực tế sổ cái

Tín hiệu UI SaaS Thực tế sổ cái Bước tiếp theo được phép
Đã gửi / đã giao Trừ tiền + đường dẫn DLR tồn tại Hiển thị mã hóa đơn
Trong hàng đợi Tạm giữ mở hoặc đã chấp nhận Thắc mắc trạng thái
Thất bại / tạm dừng Tạm giữ bị từ.

Bàn giao kênh vẫn nằm trên cùng một ví

Nếu sản phẩm sau đó thêm email hoặc thoại bên cạnh SMS, chi tiêu vẫn tính vào cùng một sổ cái trả trước trừ khi bạn thực hiện bàn giao kênh thứ hai với sự đồng ý của bộ phận tài chính. Việc nhúng không tạo ra một kênh phụ miễn phí. Đọc mục Tương quan ví trước khi bật một ô Live khác trong cài đặt SaaS.

Các đường dẫn vận hành liên quan

Bắt đầu với IOSOR

Mở Bảng điều khiển IOSOR và liên kết trực tiếp hệ thống tín dụng khách thuê của bạn với cái sổ cái ví trả trước chính. Đảm bảo mọi yêu cầu nhúng từ phía máy chủ đều truyền qua một khóa tính bất biến định hình trước khi đặt giữ ví chính. Định cấu hình điểm cuối webhook để xử lý các báo cáo giao hàng đến nhằm giải quyết gọn gàng các khoản giữ mở thành các khoản ghi nợ sổ cái cuối cùng hoặc giải phóng.

Điểm chính IOSOR

Giao diện SaaS nhúng có thể hiển thị các tín dụng tin nhắn tùy chỉnh cho người dùng cuối, nhưng mọi đợt gửi thực tế đều gắn liền với một sổ cái trả trước duy nhất do nhà cung cấp phần mềm độc lập tài trợ. Các lần thử lại, mở rộng kênh và tín hiệu trạng thái người dùng phải đối chiếu trực tiếp với các khoản giữ ví thay vì các dạng trừu tượng giao diện người dùng không được hỗ trợ.

Hãy thực thi các khóa tính bất biến phía máy chủ nghiêm ngặt và liên kết mọi trạng thái giao diện người dùng của khách thuê với các phản hồi báo cáo giao hàng sổ cái thực tế. Không tạo ra các ví phụ không được hỗ trợ hoặc cho phép các lần thử lại giao diện người dùng của khách thuê thực hiện mà không có các khoản giữ sổ cái cụ thể.

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

Hướng dẫn liên quan