Tìm hiểu cách điểm cuối cập nhật số đơn hàng hoạt động.
Điểm cuối updateMerchantOrderId được sử dụng để cập nhật đơn hàng trong hệ thống Zonos bằng ID đơn hàng của cửa hàng của bạn để có sự đối chiếu, giao tiếp và kiểm toán tốt hơn.
Các cặp khóa/giá trị JSON trong phần nội dung yêu cầu
1{
2"store":"999",
3"secret":"f5bde245-f55e-414d-b722-80b25161c12c",
4"orderId":"999-9999",
5"merchantOrderId":"12-34567"
6}
Định nghĩa JSON yêu cầu
Trường↕
Ghi chú↕
merchantOrderId BẮT BUỘC
Tham số này được sử dụng để chuyển ID đơn hàng nội bộ của cửa hàng của bạn sang đơn hàng trong hệ thống Zonos. Điều này được khuyến nghị để có sự đối chiếu, giao tiếp và kiểm toán tốt hơn.string
orderId BẮT BUỘC
ID đơn hàng Zonos - có thể được truyền với hoặc không có ID cửa hàng và dấu gạch ngang của bạn (Ví dụ: 123-45678 hoặc 45678).Lưu ý: Sau khi hoàn tất đơn hàng và thanh toán, khách hàng sẽ được chuyển hướng đến trang Hoàn tất Đơn hàng / Trang Cảm ơn Đơn hàng được lưu trữ trong miền của bạn. URL sẽ chứa tham số chuỗi truy vấn "orderId" sẽ chứa giá trị này.integer / string
secret BẮT BUỘC
GUID bí mật API được cung cấp bởi Zonos.string
store BẮT BUỘC
ID cửa hàng được cung cấp bởi Zonosinteger
Phản hồi HTTPS
1{
2"success":"Updated Order: 99999 with new merchantOrderId: 12-34567"
3}
Phản hồi lỗi HTTPS
Mã lỗi↕
Định nghĩa↕
406 - Not Acceptable
Thực thể HTML. Tiêu đề HTTP "Accept" không hợp lệ.
415 - Unsupported media type
Thực thể HTML. Tiêu đề HTTP "Content-Type" không hợp lệ.
200
"error":"could not parse input"
200
"error":"Parameter orderId is required to processUpdateMerchantOrderId"
200
"error":"Parameter merchantOrderId is required to updateMerchantOrderId."
200
"error":"orderId: 999-99999 is not a valid orderId"
200
"error":"Could not retrieve order to updateMerchantOrderId for orderId: 999-99999"
200
"error":"Could not process update merchant order id."
200
"error":"Invalid security credentials"
Định nghĩa JSON phản hồi
Tin nhắn↕
Định nghĩa↕
error
Tham số này sẽ chỉ có trong phản hồi khi đã xảy ra lỗi và sẽ chứa mô tả nguyên nhân.string
Cập nhật số đơn hàng
Cập nhật số đơn hàng
Tìm hiểu cách điểm cuối cập nhật số đơn hàng hoạt động.Điểm cuối
updateMerchantOrderIdđược sử dụng để cập nhật đơn hàng trong hệ thống Zonos bằng ID đơn hàng của cửa hàng của bạn để có sự đối chiếu, giao tiếp và kiểm toán tốt hơn.Điểm cuối
POST |
https://api.iglobalstores.com/v1/updateMerchantOrderIdYêu cầu HTTPS
https://api.iglobalstores.com/v1/updateMerchantOrderIdCác cặp khóa/giá trị JSON trong phần nội dung yêu cầu
{"store": "999","secret": "f5bde245-f55e-414d-b722-80b25161c12c","orderId": "999-9999","merchantOrderId": "12-34567"}Định nghĩa JSON yêu cầu
merchantOrderIdBẮT BUỘCstringorderIdBẮT BUỘCinteger / stringsecretBẮT BUỘCstringstoreBẮT BUỘCintegerPhản hồi HTTPS
{"success": "Updated Order: 99999 with new merchantOrderId: 12-34567"}Phản hồi lỗi HTTPS
Định nghĩa JSON phản hồi
errorstringsuccessstringTrang này có hữu ích không?