DOCS
Checkout•
Trang chủTài liệu tham khảo API Checkout REST API Tạo checkout

Tạo checkout

Khám phá các cặp khóa/giá trị liên quan đến việc tạo checkout.

Điểm cuối API này được sử dụng để gửi thông tin giỏ hàng và các mục từ giỏ hàng của khách hàng đến API Zonos.

Bạn sẽ nhận được một phản hồi JSON chứa tempCartUUID, một mã định danh giỏ hàng duy nhất trong Hệ thống Zonos. Điều này sẽ được sử dụng để chuyển hướng khách hàng đến Zonos Checkout để hoàn tất đơn hàng.

Thuộc tính 

Các cặp khóa/giá trị JSON trong nội dung yêu cầu

POST https://api.iglobalstores.com/v1/createTempCart

field↕notes↕
boxCountGiá trị ví dụ: 22x15x15(1),8x8x4(2),32x22x14(1)
Định dạng: Danh sách các kích thước hộp và số lượng được phân tách bằng dấu phẩy. Trong ví dụ trên, có tổng cộng 4 hộp. Hộp đầu tiên trong danh sách sẽ dài 22 inch, rộng 15 inch, cao 15 inch. Sẽ chỉ có một hộp được sử dụng cho kích thước đó. Sẽ có hai hộp kích thước: 8x8x4 inch. Có thể chuyển cùng một kích thước hộp nhiều lần nếu điều đó dễ dàng cho bạn, như thế này: "22x15x15(1),22x15x15(1)", có nghĩa là 2 hộp kích thước: 22x15x15 inch. Trường này mô tả các hộp sẽ được sử dụng để vận chuyển đơn hàng. Không được dự kiến rằng một thương nhân biết điều này tại thời điểm đặt hàng; tuy nhiên, nếu biết, nó có thể được chuyển theo định dạng string.
contShoppingURLTrường này được sử dụng để chuyển một URL để ghi đè HREF của nút "Tiếp tục mua sắm" bên trong Zonos Checkout. string
domesticShippingChargeTrường này được sử dụng để chuyển một khoản phí vận chuyển nội địa đến Zonos Checkout, và số tiền sẽ được thêm vào vận chuyển. Điều này có thể được cấu hình để thêm tổng vận chuyển hoặc được chia nhỏ thành một mục dòng riêng biệt. positive floating point, two decimal places
externalConfirmationPageURLTrường này được sử dụng để chuyển URL của trang xác nhận đơn hàng / cảm ơn của bạn. Sau khi khách hàng hoàn tất thanh toán bên trong Zonos Checkout, họ sẽ được chuyển hướng đến URL này để xác nhận đơn hàng. URL này thường được sử dụng để kích hoạt lệnh gọi đến điểm cuối dịch vụ API "orderDetail" của Zonos để lấy chi tiết đơn hàng và nhập đơn hàng vào hệ thống. string
footerHTMLTrường này được sử dụng để chuyển một chuỗi HTML được mã hóa URL. Chuỗi HTML này sẽ được giải mã và đặt trước thẻ đóng body trên trang thanh toán. Thường được sử dụng để chuyển mã cho tiếp thị lại, phân tích, v.v. URL encoded string
items

REQUIRED

Trường này là một danh sách các bản đồ mục. JSON string
items[index].countryOfOriginTrường này được sử dụng để chuyển quốc gia xuất xứ của mục. Tham số phải là mã ISO hai chữ cái của quốc gia. string
items[index].description

REQUIRED

Trường này được sử dụng để chuyển mô tả đầy đủ của mục giỏ hàng, bao gồm các tùy chọn mục, màu sắc, v.v. string
items[index].heightTrường này được sử dụng để chuyển chiều cao của mục và được khuyến cáo cao để báo giá vận chuyển chính xác. Đơn vị chiều cao là

REQUIRED

tính bằng inch. string - positive floating point, two decimal places / integer (inches)
items[index].imageURL

REQUIRED

Trường này được sử dụng để chuyển URL đến hình ảnh sản phẩm mục. URL phải là HTTPS để hiển thị bên trong Zonos Checkout. string / HTTPS URL
items[index]itemBrandTrường này được sử dụng để chuyển thương hiệu mụcstring
items[index]itemCategoryTrường này được sử dụng để chuyển danh mục mục và có thể được chuyển phân tách bằng đường ống nếu mục có nhiều hơn một danh mục.
Giá trị ví dụ: "shoes" hoặc "shoes|sport-shoes|discount-shoes"string
items[index]itemCustomizationTrường này được sử dụng để chuyển thông tin chi tiết bổ sung về mục không được hiển thị trong Zonos Checkout; tuy nhiên, điều này có thể được lấy thông qua điểm cuối dịch vụ API "orderDetail".
items[index]itemHSCodeTrường này được sử dụng để chuyển mã HS của mục và có thể có hoặc không có dấu chấm.
Giá trị ví dụ: "3926901000" hoặc "3926.90.1000"string
items[index].itemURLTrường này được sử dụng để chuyển URL đến trang sản phẩm mục. string / URL
items[index].lengthTrường này được sử dụng để chuyển chiều dài của mục và được khuyến cáo cao để báo giá vận chuyển chính xác. Đơn vị chiều dài là

REQUIRED

tính bằng inch. string - positive floating point, two decimal places / integer (inches)
items[index].nonShippableTrường này được sử dụng để cho biết liệu mục có nên được bao gồm trong các tính toán vận chuyển, thuế và phí hay không. Các bản tải kỹ thuật số, mã giảm giá, phí xử lý, v.v. nên được chuyển với giá trị "true". boolean: true or false
items[index].productIdTrường này được sử dụng để chuyển số lượng mục dòng. string
items[index].quantity

REQUIRED

Trường này được sử dụng để chuyển số lượng mục dòng. string
items[index].skuTrường này được sử dụng để chuyển SKU / UPC / v.v. của mục. string
items[index].unitPrice

REQUIRED

Trường này được sử dụng để chuyển giá đơn vị của mục dòng. positive floating point, two decimal places / integer
items[index].weightTrường này được sử dụng để chuyển trọng lượng của mục và được khuyến cáo cao để báo giá vận chuyển chính xác. Đơn vị trọng lượng được mặc định là "LBS" trừ khi một đơn vị trọng lượng khác được chuyển trong items[index].itemWeightUnits``string - positive floating point, two decimal places / integer
items[index].weightUnitsTrường này được sử dụng để ghi đè các đơn vị trọng lượng mục mặc định. Đơn vị trọng lượng mục được mặc định là "LBS" trừ khi một đơn vị trọng lượng khác được chuyển trong trường này. string - "LB", "OZ", "KG", or "G”
items[index].widthTrường này được sử dụng để chuyển chiều rộng của mục và được khuyến cáo cao để báo giá vận chuyển chính xác. Đơn vị chiều rộng là

REQUIRED

tính bằng inch. string - positive floating point, two decimal places / integer (inches)
misc1 - misc6Trường này được sử dụng để chuyển dữ liệu linh tinh liên quan đến đơn hàng thông qua API Zonos để được lấy cùng với dữ liệu đơn hàng được trả về từ điểm cuối dịch vụ API "orderDetail" của Zonos. string
referenceIdTrường này được sử dụng để chuyển giá trị định danh tham chiếu duy nhất cho giỏ hàng / phiên / v.v. trong hệ thống của bạn. Điều này có thể được sử dụng để tìm kiếm ID đơn hàng Zonos thông qua điểm cuối dịch vụ API "orderDetail" của Zonos. string
storeId

REQUIRED

ID cửa hàng được cung cấp bởi Zonos. integer

Các kiểu dữ liệu chuỗi bổ sung

  • items[index].itemDescriptionLong
  • items[index].itemDescriptionDetailed
  • items[index].itemFabricContent
  • items[index].itemColor
  • items[index].itemLtlClass
  • items[index].status
  • items[index].itemMaterial

Giảm giá, phiếu giảm giá và mã khuyến mãi 

Để gửi giảm giá, phiếu giảm giá và mã khuyến mãi đến Zonos thông qua bài đăng máy chủ, chúng phải được chuyển dưới dạng mục riêng biệt với giá trị âm cho các tham số: “unitPrice” và “nonShippable”:true.

1{
2 "description": "Discount (10OFF) - 10% OFF",
3 "unitPrice": -15.5,
4 "quantity": 1,
5 "nonShippable": true
6}

Phản hồi HTTPS

Phản hồi HTTP thành công

Định dạng thông báo: JSON

1{
2 "tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"
3}

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

field↕notes↕
tempCartUUIDTham số này sẽ chứa một GUID được gán cho giỏ hàng quốc tế của khách hàng và được tạo trong hệ thống Zonos. Trường này sẽ được chuyển thông qua tham số truy vấn URL string trong khi chuyển hướng trình duyệt của người dùng đến Zonos Checkout.

Phản hồi HTTP lỗi

Error code↕meaning↕
400Ký tự không mong muốn trong nội dung yêu cầu.
406Không chấp nhận. Tiêu đề HTTP cho "Chấp nhận" không hợp lệ.
415Loại phương tiện không được hỗ trợ. Tiêu đề HTTP cho "Loại nội dung" không hợp lệ.
422Thực thể không thể xử lý được.
500"storeId" không chính xác hoặc phần nội dung JSON không thể được phân tích cú pháp.
1
2 
3
4 
5
6 
7Error 422 Unprocessable Entity
8 
9
10 
11
12 
13

HTTP ERROR 422

14 
15

16 Problem accessing /v2/createTempCart. Reason:
17 
Unprocessable Entity
18 
19

20 
21

The request entity had the following errors:

22 
23
24 
25
  • items may not be empty (was null)
    • 26 
    27
  • items may not be null (was null)
    • 28 
    29
    30 
    31
    32 
    33

    Chuyển hướng đến Zonos Checkout 

    Sau khi nhận được phản hồi thành công chứa tempCartUUID, máy chủ của bạn sẽ gửi một chuyển hướng từ trình duyệt của khách hàng đến Zonos Checkout với các tham số chuỗi truy vấn URL thích hợp được bao gồm dưới đây.

    URL chuyển hướng ví dụ: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

    Lưu ý: [yourassignedsubdomain] - Liên hệ với thành viên nhóm triển khai Zonos của bạn để nhận tên miền phụ Zonos.com của bạn.

    Các tham số yêu cầu URL

    field↕notes↕
    tempCartUUID

    REQUIRED

    		Giá trị này được lấy bằng cách gọi điểm cuối dịch vụ API createTempCart của Zonos. string / GUID
    countryMã ISO hai chữ cái của quốc gia đích. Chúng tôi thực sự khuyến cáo chuyển tham số này để cải thiện trải nghiệm người dùng. Tham số country sẽ chọn trước quốc gia đích bên trong Zonos Checkout. Khi sử dụng Zonos Hello JS (JavaScript) trên trang web, bạn có thể lấy giá trị này bằng cách gọi phương thức JavaScript: zonos.country(). string (Độ dài: 2)

    Các kiểu dữ liệu chuỗi bổ sung

    • customerName
    • customerCompany
    • customerEmail
    • customerPhone
    • customerAltPhone
    • customerAddress1
    • customerAddress2
    • customerCity
    • customerState
    • customerZip

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

    Nhận hỗ trợ·Tài liệu pháp lý·© 2026 Zonos
    Trên trang này:
  • Tạo checkout
  • Thuộc tính
  • Giảm giá, phiếu giảm giá và mã khuyến mãi
  • Chuyển hướng đến Zonos Checkout