Truy xuất danh sách số đơn hàng hoặc thông tin chi tiết về một đơn hàng.
API endpoint "Truy xuất đơn hàng" này được sử dụng để truy xuất dữ liệu cho một đơn hàng đã hoàn tất bên trong hệ thống Zonos. Phản hồi sẽ chứa một đối tượng JSON, đại diện cho tất cả thông tin có sẵn cho đơn hàng bao gồm địa chỉ thanh toán và giao hàng, phương thức giao hàng, tổng đơn hàng và trạng thái.
(Phần 1 + Phần 2) – Sử dụng trang xác nhận / thành công đơn hàng tùy chỉnh trên miền của bạn để kích hoạt hệ thống của bạn gọi endpoint orderDetail và nhập một đơn hàng đã hoàn tất. Ngoài ra, thường xuyên gọi endpoint orderNumbers để điều hòa bất kỳ đơn hàng nào trong hệ thống Zonos chưa được nhập vào hệ thống của bạn.
(Chỉ Phần 2) – Sử dụng trang xác nhận / thành công đơn hàng cơ bản của Zonos hoặc trang tĩnh trên miền của bạn để chỉ ra hoàn tất đơn hàng cho khách hàng. Lên lịch cho hệ thống của bạn thường xuyên gọi endpoint orderNumbers để xác định khi nào đơn hàng mới sẵn sàng được nhập vào hệ thống của bạn. Khi tìm thấy một đơn hàng chưa được xử lý, gọi endpoint orderDetail để lấy dữ liệu trên các đơn hàng đó.
Phần 1: Trang thành công trên miền của bạn
Mỗi khi một người mua hoàn tất một đơn hàng trong Zonos Checkout, họ sẽ được chuyển hướng ngay tới URL trang thành công đơn hàng. ID đơn hàng đã hoàn tất sẽ được nối vào URL chuyển hướng dưới dạng chuỗi truy vấn. URL của trang thành công đơn hàng nên được cung cấp cho Zonos. URL cũng có thể được chuyển làm tham số trong endpoint createTempCart khi tạo giỏ hàng tạm thời trong hệ thống Zonos.
Khi khách hàng được chuyển hướng tới trang này, hệ thống của bạn sẽ cần phân tích giá trị cho orderId từ URL. Sau đó, bạn sẽ sử dụng orderId để gọi endpoint orderDetail để truy xuất dữ liệu đơn hàng.
Phần 2: Sử dụng một công việc được lên lịch
Ngoài việc gọi chi tiết đơn hàng khi trang thành công được kích hoạt, chúng tôi khuyên bạn nên thiết lập một cuộc gọi được lên lịch cho tất cả đơn hàng và chi tiết của chúng như một biện pháp bảo vệ. Bằng cách này, bạn có thể truy xuất bất kỳ đơn hàng đã hoàn tất nào trong hệ thống Zonos chưa được nhập vào hệ thống của bạn.
Quá trình này nên là một công việc / kịch bản được lên lịch, chẳng hạn như công việc Cron, chạy mỗi giờ / ca làm việc / ngày / v.v. (lên lịch thường xuyên như quy trình kinh doanh của bạn yêu cầu). Kịch bản nên gọi để lấy tất cả đơn hàng và chi tiết của chúng đã xảy ra kể từ cuộc gọi cuối cùng cho đơn hàng. Endpoint orderNumbers cho phép bạn truy xuất đơn hàng sinceOrderId hoặc sinceDate như được trình bày trên GUI kiểm tra API được đặt tại đây. Tất cả các đơn hàng được truy xuất thông qua cuộc gọi được lên lịch này sau đó nên được điều hòa so với các đơn hàng được chèn vào hệ thống của bạn mỗi khi trang thành công được kích hoạt. Bất kỳ đơn hàng nào chưa có trong hệ thống của bạn nên được chèn vào hệ thống của bạn và được coi là các đơn hàng hợp pháp.
Trạng thái đơn hàng ban đầu
IGLOBAL_ORDER_IN_PROCESS hoặc IGLOBAL_FRAUD_REVIEW
Khi gọi endpoint orderDetail, chúng tôi khuyên bạn nên để hệ thống của bạn trước tiên kiểm tra thuộc tính orderStatus của dữ liệu đơn hàng.
Các đơn hàng không yêu cầu xét duyệt gian lận sẽ khởi tạo với orderStatus: IGLOBAL_ORDER_IN_PROCESS. Một đơn hàng ở trạng thái này sẵn sàng được xử lý và giao hàng.
Các đơn hàng yêu cầu xét duyệt gian lận sẽ khởi tạo trong orderStatus: IGLOBAL_FRAUD_REVIEW. Một đơn hàng ở trạng thái này hiện đang được kiểm tra và xem xét để phát hiện gian lận. Chúng tôi khuyên bạn đặt đơn hàng này vào trạng thái xem xét hoặc giữ trong hệ thống của bạn và tiếp tục gọi endpoint orderDetail cho đến khi đơn hàng vượt qua quá trình xét duyệt gian lận của Zonos.
Sau khi quá trình sàng lọc gian lận của Zonos hoàn tất, đơn hàng sẽ chuyển sang một trong các trạng thái sau:
Đơn hàng vượt qua sàng lọc gian lận
Đơn hàng sẽ chuyển sang orderStatus: IGLOBAL_ORDER_IN_PROCESS và có thể tiếp tục hướng tới giao hàng.
Đơn hàng không vượt qua sàng lọc gian lận
Đơn hàng sẽ chuyển sang orderStatus: IGLOBAL_ORDER_CANCELLED và nên được hủy trong hệ thống của bạn.
GUI kiểm tra API
Vui lòng liên hệ hỗ trợ cho thông tin xác thực tài khoản của bạn.
Truy xuất đơn hàng
Truy xuất đơn hàng
Truy xuất danh sách số đơn hàng hoặc thông tin chi tiết về một đơn hàng.
API endpoint "Truy xuất đơn hàng" này được sử dụng để truy xuất dữ liệu cho một đơn hàng đã hoàn tất bên trong hệ thống Zonos. Phản hồi sẽ chứa một đối tượng JSON, đại diện cho tất cả thông tin có sẵn cho đơn hàng bao gồm địa chỉ thanh toán và giao hàng, phương thức giao hàng, tổng đơn hàng và trạng thái.
Endpoints
Số đơn hàng
Truy xuất danh sách các số đơn hàng.
Chi tiết đơn hàng
Truy xuất thông tin chi tiết cho một đơn hàng.
Sử dụng API endpoint Truy xuất đơn hàng
Có hai cách phổ biến để sử dụng các endpoint này.
orderDetailvà nhập một đơn hàng đã hoàn tất. Ngoài ra, thường xuyên gọi endpointorderNumbersđể điều hòa bất kỳ đơn hàng nào trong hệ thống Zonos chưa được nhập vào hệ thống của bạn.orderNumbersđể xác định khi nào đơn hàng mới sẵn sàng được nhập vào hệ thống của bạn. Khi tìm thấy một đơn hàng chưa được xử lý, gọi endpointorderDetailđể lấy dữ liệu trên các đơn hàng đó.Phần 1: Trang thành công trên miền của bạn
Mỗi khi một người mua hoàn tất một đơn hàng trong Zonos Checkout, họ sẽ được chuyển hướng ngay tới URL trang thành công đơn hàng. ID đơn hàng đã hoàn tất sẽ được nối vào URL chuyển hướng dưới dạng chuỗi truy vấn. URL của trang thành công đơn hàng nên được cung cấp cho Zonos. URL cũng có thể được chuyển làm tham số trong endpoint
createTempCartkhi tạo giỏ hàng tạm thời trong hệ thống Zonos.Ví dụ: http://www.examplestore.com/internationalThankYou?orderId=999-99999Khi khách hàng được chuyển hướng tới trang này, hệ thống của bạn sẽ cần phân tích giá trị cho
orderIdtừ URL. Sau đó, bạn sẽ sử dụngorderIdđể gọi endpointorderDetailđể truy xuất dữ liệu đơn hàng.Phần 2: Sử dụng một công việc được lên lịch
Ngoài việc gọi chi tiết đơn hàng khi trang thành công được kích hoạt, chúng tôi khuyên bạn nên thiết lập một cuộc gọi được lên lịch cho tất cả đơn hàng và chi tiết của chúng như một biện pháp bảo vệ. Bằng cách này, bạn có thể truy xuất bất kỳ đơn hàng đã hoàn tất nào trong hệ thống Zonos chưa được nhập vào hệ thống của bạn.
Quá trình này nên là một công việc / kịch bản được lên lịch, chẳng hạn như công việc Cron, chạy mỗi giờ / ca làm việc / ngày / v.v. (lên lịch thường xuyên như quy trình kinh doanh của bạn yêu cầu). Kịch bản nên gọi để lấy tất cả đơn hàng và chi tiết của chúng đã xảy ra kể từ cuộc gọi cuối cùng cho đơn hàng. Endpoint
orderNumberscho phép bạn truy xuất đơn hàngsinceOrderIdhoặcsinceDatenhư được trình bày trên GUI kiểm tra API được đặt tại đây. Tất cả các đơn hàng được truy xuất thông qua cuộc gọi được lên lịch này sau đó nên được điều hòa so với các đơn hàng được chèn vào hệ thống của bạn mỗi khi trang thành công được kích hoạt. Bất kỳ đơn hàng nào chưa có trong hệ thống của bạn nên được chèn vào hệ thống của bạn và được coi là các đơn hàng hợp pháp.Trạng thái đơn hàng ban đầu
IGLOBAL_ORDER_IN_PROCESShoặcIGLOBAL_FRAUD_REVIEWKhi gọi endpoint
orderDetail, chúng tôi khuyên bạn nên để hệ thống của bạn trước tiên kiểm tra thuộc tínhorderStatuscủa dữ liệu đơn hàng.Các đơn hàng không yêu cầu xét duyệt gian lận sẽ khởi tạo với
orderStatus:IGLOBAL_ORDER_IN_PROCESS. Một đơn hàng ở trạng thái này sẵn sàng được xử lý và giao hàng.Các đơn hàng yêu cầu xét duyệt gian lận sẽ khởi tạo trong
orderStatus:IGLOBAL_FRAUD_REVIEW. Một đơn hàng ở trạng thái này hiện đang được kiểm tra và xem xét để phát hiện gian lận. Chúng tôi khuyên bạn đặt đơn hàng này vào trạng thái xem xét hoặc giữ trong hệ thống của bạn và tiếp tục gọi endpointorderDetailcho đến khi đơn hàng vượt qua quá trình xét duyệt gian lận của Zonos.Sau khi quá trình sàng lọc gian lận của Zonos hoàn tất, đơn hàng sẽ chuyển sang một trong các trạng thái sau:
Đơn hàng vượt qua sàng lọc gian lận
orderStatus:IGLOBAL_ORDER_IN_PROCESSvà có thể tiếp tục hướng tới giao hàng.Đơn hàng không vượt qua sàng lọc gian lận
orderStatus:IGLOBAL_ORDER_CANCELLEDvà nên được hủy trong hệ thống của bạn.GUI kiểm tra API
Vui lòng liên hệ hỗ trợ cho thông tin xác thực tài khoản của bạn.
Trang này có hữu ích không?