Cập nhật ngày 20/10/2026. Chính sách này áp dụng cho bên kết nối ADSWAR API và người mua để bán lại. Đọc cùng Tài liệu API, điều kiện sản phẩm và Chính sách công ty. Chỉ sử dụng dịch vụ và quyền hệ thống đã mở cho tài khoản của mình.
Trước khi tiếp nhận đơn hàng
- Đọc tài liệu của phiên bản API đang dùng, kiểm tra quyền và giữ API Key trong hệ thống an toàn. Không đặt khóa trong trang web mà khách truy cập có thể đọc.
- Kiểm tra mã sản phẩm, phiên bản, định dạng, giá, số lượng tối thiểu và tồn kho trước khi đặt. Mô tả trên cửa hàng của mình phải đúng với tính năng thực bán.
- Kiểm tra số dư và đặt cảnh báo khi thiếu tiền. Không xác nhận đặt thành công trước khi kiểm tra kết quả thực tế.
- Lưu mã đơn phía cửa hàng và mã ADSWAR trả về để theo dõi cùng một giao dịch.
Các trạng thái cần phân biệt
Nhận mã đơn, thanh toán thành công và giao đủ là các bước khác nhau. Đọc giá trị theo tài liệu API và chỉ đếm bộ dữ liệu thực sự đã giao. Nếu nhận một phần, hiển thị số đã nhận và còn thiếu. Không đổi sang hoàn tất chỉ vì yêu cầu HTTP nhận được phản hồi.
Khi thiếu tiền, hết hàng, dữ liệu yêu cầu không đủ hoặc không giao được, hãy báo ngay cho quản trị hệ thống của mình, đồng thời giữ lý do và mã tham chiếu để xử lý. Nếu vẫn đang xử lý, hiển thị trạng thái đúng thực tế thay vì gửi dữ liệu trống hoặc báo đã nhận đủ.
Ngăn đặt và trừ tiền trùng
Yêu cầu hết thời gian, mất kết nối hoặc không nhận phản hồi chưa đủ để kết luận đặt hàng thất bại. Kiểm tra trạng thái và mã tham chiếu trước khi gửi đơn mới. Tài liệu hiện tại có hướng dẫn dùng Idempotency-Key hoặc client_order_id cho các lệnh hỗ trợ. Hãy áp dụng đúng định dạng và phạm vi của từng endpoint, không giả định mọi lệnh đều hỗ trợ giống nhau.
Hệ thống kết nối nên khóa việc gửi lại cùng giao dịch trong khi chờ kết quả và lưu liên kết giữa các mã đơn. Nếu chưa xác định được giao dịch, hãy liên hệ nhân viên kiểm tra trước khi mua lại. Đổi sang mã mới để gửi lại có thể khiến hệ thống coi đó là đơn mới.
Giao một phần và hoàn tiền
Dùng dữ liệu trạng thái từ order_status.php và delivery_status theo tài liệu, phân biệt chờ, giao một phần, giao đủ, hủy, hoàn tiền hoặc đang kiểm tra. Nếu giao thiếu, giữ số lượng đặt, đã nhận, số tiền bị trừ và tách các bộ đã giao khỏi phần đang kiểm tra. Không đặt thay thế toàn bộ số lượng khi chưa kiểm tra đơn cũ vì có thể mua dư và giao trùng.
Giao bổ sung, hủy hoặc hoàn chênh lệch được xem xét theo trạng thái, bằng chứng và Chính sách hoàn tiền. Không bảo đảm mọi lỗi đều tự động hoàn hoặc nên gửi lại ngay.
Thông tin hiển thị cho khách hàng của mình
Bên bán lại phải mô tả đúng sản phẩm và phạm vi bảo hành đang bán. Không thêm cam kết sử dụng vĩnh viễn, quảng cáo chắc chắn được duyệt hoặc bảo hành mọi trường hợp nếu không có thỏa thuận đó. Giá bán và điều kiện thêm của cửa hàng không tự động thay đổi điều kiện đơn ADSWAR và không được giảm quyền pháp luật bảo vệ khách hàng của mình.
Cách báo vấn đề để kiểm tra được
Liên hệ ADSWAR kèm mã đơn hệ thống, mã tham chiếu cửa hàng, mã sản phẩm, số lượng, thời gian, số tiền thanh toán và thông báo trạng thái đã loại bỏ dữ liệu bí mật. Nếu đính kèm yêu cầu hoặc phản hồi, hãy che API Key, mật khẩu, cookie và token trước. Không gửi khóa qua kênh công khai.
Sử dụng API phải tuân theo Điều khoản và pháp luật, đặc biệt về quyền truy cập dữ liệu khách hàng, lưu dữ liệu đã giao và không truy cập giao dịch mình không có quyền. Phiên bản này áp dụng từ khi công bố ngày 20/10/2026 và không giảm quyền theo điều kiện của đơn trước đó.
Cập nhật lần cuối: 20/10/2026