📌[SCRIPT-VI] ghi nhận đơn hàng Ecommerce

Đối tác cần đặt script trên vào trang phù hợp (ví dụ: trang đặt hàng thành công) để có thể ghi nhận đúng mã đơn hàng và giá trị đơn hàng.

Ở đây MasOffer đang để các dữ liệu mẫu, đối tác vui lòng chỉnh sửa thông tin phù hợp.

<script type="text/javascript">
masoffer_order_info = {
  "offer_id": {{offer_id}},
  "signature": {{signature}},
  "transaction_id": "ABC123",
  "transaction_time": 1557388224436,
  "transaction_discount": 0,
  "traffic_id": {{mo_traffic_id}},
  "products": [
    {
      "sku": "SKU001",
      "url": "https://test.com/...",
      "price": 10000,
      "name": "ten san pham",
      "category": "ten category",
      "category_id": "123",
      "status_code": 0,
      "quantity": 1,
      "shop_id": "SHOP1"
    },
    {
      "sku": "SKU002",
      "url": "https://test.com/...",
      "price": 10000,
      "name": "ten san pham",
      "category": "ten category",
      "category_id": "456",
      "status_code": 0,
      "quantity": 2,
      "shop_id": "SHOP2"
    }
  ]
};
</script>
<script type="text/javascript" src="https://static.masoffer.net/php/tracking_js.php?type=dev" async></script>

Để đưa lên môi trường production, đối tác vui lòng thay script cuối thành:

<script type="text/javascript" src="https://static.masoffer.net/php/tracking_js.php?type=cps" async></script>

Giải thích ý nghĩa các tham số

Tham số	Mô tả	Loại	Bắt buộc
offer_id	Id của đối tác do MasOffer cung cấp.	String
signature	Signature của đối tác do MasOffer cung cấp.	String
transaction_id	Mã đơn hàng của đối tác.	String
transaction_time	Thời gian phát sinh đơn hàng - milliseconds. Đối tác có thể xem cách convert thời gian sang milliseconds tại đây: https://currentmillis.com/	Number
transaction_discount	Số tiền được giảm khi có khuyến mãi.	Number
traffic_id	ID của traffic do MasOffer cung cấp qua Tracking Link (đã lưu trong cookie)	String
products.sku	Sku của sản phẩm.	String
products.url	URL trang sản phẩm	String
products.price	Giá (sau khuyến mãi nếu có) của sản phẩm.	Number
products.name	Tên sản phẩm.	String
products.category	Danh mục sản phẩm.	String
products.category_id	ID danh mục sản phẩm: Để “1” nếu đối tác không chia hoa hồng theo danh mục sản phẩm. Để theo thỏa thuận giữa 2 bên nếu đối tác chia hoa hồng theo danh mục sản phẩm.	String
products.status_code	Trạng thái xử lý đơn hàng: 0: đang xử lý 1: đã mua thành công -1: đã hủy Ở đây MasOffer đang để mặc định là 0.	Number
products.quantity	Số lượng sản phẩm	Number
products.shop_id	ID của đơn vị bán hàng (trong trường hợp đối tác có nhiều đơn vị phân phối - shop/cửa hàng/…)	String

Trong trường hợp cập nhật trạng thái đơn hàng, đối tác bắn postback như cách https://app.gitbook.com/s/qtj4PNLH8KFAqZbV8NM3/~/changes/NmgVd056sLZD65lTma6d/webhook-api-ghi-nhan-don-hang-ecommerce , tuy nhiên thay đổi giá trị trường status_code.

Response

Thành công

{
  "meta": {
    "status_code": 1,
    "status": "success",
    "external_message": "Success",
    "internal_message": "Success"
  }
}

Thất bại

{
  "meta": {
    "status_code": -1,
    "status": "failed",
    "external_message": "Message",
    "internal_message": "Message",
    "trace_id": "${trace_id}"
  }
}

Giải thích ý nghĩa response

Trường dữ liệu	Mô tả
status/status_code	Trạng thái request: success/1: Thành công failed/-1: Lỗi
external_message/ internal_message	Thông báo thành công hoặc thông tin về lỗi
trace_id	ID của lỗi dùng để kiểm tra chi tiết lỗi phát sinh khi cần thiết (Khi có lỗi cần kiểm tra hãy gửi kèm trace_id)