Store Orders API

Tài liệu chi tiết về API quản lý đơn hàng dành cho cửa hàng (Storefront/Client). Các API này được sử dụng trên các trang bán hàng công khai (selling pages) hoặc widget app.

---

HTTP Endpoints

Phương thức	Đường dẫn	Mô tả
POST	/public/create_order	Tạo mới đơn hàng công khai từ giỏ hàng
GET	/public/get_order	Truy vấn danh sách/chi tiết đơn hàng công khai

---

Schema Reference

Create Order (Storefront)

POST /public/create_order
Token-Business: <business_access_token>
Content-Type: application/json

Request Body Schema

Thuộc tính	Kiểu dữ liệu	Yêu cầu	Mô tả
products	array	Bắt buộc	Mảng chứa các sản phẩm khách đặt. Mỗi item gồm: product_id, variant_id, quantity, price.
contact_name	string	Bắt buộc	Tên người nhận hàng.
contact_phone	string	Bắt buộc	Số điện thoại nhận hàng.
address_receipt	string	Bắt buộc	Địa chỉ giao hàng chi tiết.
chatbox_user_id	string	Tùy chọn	ID người dùng chatbox nếu đơn hàng tạo từ chat widget.

Request Body Example

{
  "products": [
    {
      "product_id": "prod_882918",
      "variant_id": "var_992124",
      "quantity": 1,
      "price": 250000
    }
  ],
  "contact_name": "Tran Thi B",
  "contact_phone": "0912345678",
  "address_receipt": "456 Đường XYZ, Quận 3, TP. HCM",
  "payment_method": "COD"
}