DOCS

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/updateMerchantOrderId

Yêu cầu HTTPS

Trường↕Ghi chú↕
Phương thức HTTPPOST
URL điểm cuốihttps://api.iglobalstores.com/v1/updateMerchantOrderId
Giao thứcHTTPS
Định dạng tin nhắnJSON
Tiêu đề HTTP AcceptAccept: application/json
Tiêu đề HTTP Content-TypeContent-Type: application/json

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ỘCTham 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ỘCID đơ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ỘCGUID bí mật API được cung cấp bởi Zonos.string
store BẮT BUỘCID 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 AcceptableThực thể HTML. Tiêu đề HTTP "Accept" không hợp lệ.
415 - Unsupported media typeThự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↕
errorTham 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
successTham số này sẽ chứa tóm tắt bản cập nhật.string

Trang này có hữu ích không?