DOCS

Update order number

/

Cập nhật số đơn hàng

Tìm hiểu cách hoạt động của điểm cuối để cập nhật số đơn hàng.

Điểm cuối updateMerchantOrderId được sử dụng để cập nhật một đơn hàng trong hệ thống Zonos với mã đơn hàng của cửa hàng bạn để cải thiện việc đối chiếu, giao tiếp và kiểm toán.

Điểm cuối 

POST | https://api.iglobalstores.com/v1/updateMerchantOrderId

Yêu cầu HTTPS

TrườngGhi 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 thân yêu cầu

Ví dụ

1
2
3
4
5
6
{
  "store": "999",
  "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
  "orderId": "999-9999",
  "merchantOrderId": "12-34567"
}

Định nghĩa JSON yêu cầu

TrườngGhi chú
merchantOrderId BẮT BUỘCTham số này được sử dụng để truyền ID đơn hàng nội bộ của cửa hàng bạn vào đơn hàng trong hệ thống Zonos. Điều này được khuyến nghị để cải thiện việc đối chiếu, giao tiếp và kiểm toá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 (Ví dụ: 123-45678 hoặc 45678). Lưu ý: Sau khi hoàn thành đơn hàng và thanh toán, khách hàng sẽ được chuyển hướng đến trang Hoàn thành Đơn hàng / Cảm ơn Đơn hàng được lưu trữ trên 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

Ví dụ phản hồi thành công

1
2
3
{
  "success": "Updated Order: 99999 with new merchantOrderId: 12-34567"
}

Ví dụ phản hồi lỗi

1
2
3
{
  "error": "Could not retrieve order to updateMerchantOrderId for orderId: 99999"
}

Phản hồi lỗi HTTP

Mã lỗiĐịnh nghĩa
406 - Không chấp nhậnThực thể HTML. Tiêu đề HTTP "Accept" không hợp lệ.
415 - Loại phương tiện không được hỗ trợThực thể HTML. Tiêu đề HTTP "Content-Type" không hợp lệ.
200"error": "không thể phân tích đầu vào"
200"error": "Tham số orderId là bắt buộc để xử lý Cập nhật Mã đơn hàng Thương gia"
200"error": "Tham số merchantOrderId là bắt buộc để cập nhật Mã đơn hàng Thương gia."
200"error": "orderId: 999-99999 không phải là orderId hợp lệ"
200"error": "Không thể truy xuất đơn hàng để cập nhật Mã đơn hàng Thương gia cho orderId: 999-99999"
200"error": "Không thể xử lý cập nhật mã đơn hàng thương gia."
200"error": "Thông tin xác thực bảo mật không hợp lệ"

Định nghĩa JSON phản hồi

Thông điệpĐịnh nghĩa
errorTham số này chỉ xuất hiện trong phản hồi khi có lỗi xảy ra và sẽ chứa mô tả nguyên nhân.string
successTham số này sẽ chứa một tóm tắt về cập nhật.string

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