🌟[CRAWLER] - Ghi nhận đơn hàng qua API đối tác

Đối tác có thể thiết kế API để MasOffer chủ động trong việc lấy dữ liệu với các thông tin như sau

(Ví dụ) https://domain.com/api/transactions/get?aff_id=masoffer&token=abcxyz.

Trong đó:

  • aff_id: là id tài khoản của MasOffer trên hệ thống của đối tác.

  • token: là tham số giúp bảo mật việc lấy dữ liệu (được cung cấp bởi đối tác cho tài khoản của MasOffer).

Body Respond Sample đối tác kết nối Ecommerce (chỉ ví dụ trả dữ liệu thành công)
{
    "success": 1, // Xác nhận lấy dữ liệu từ API thành công
    "message": "OK",
    "data": {
        "transactions": [
            {
                "transaction_id": "12345", // Mã đơn hàng (string)
                "transaction_revenue": 500000, // Tổng giá trị đơn hàng (sau khuyến mãi nếu có) (number)
                "transaction_time":"2020-05-25 10:04:32", // Thời gian phát sinh đơn hàng (string - YYYY-MM-DD HH:MM:SS)
                "products": [
                	{
                		"product_sku": 100, // SKU sản phẩm (string)
                		"product_name": "Conan tập 1", // Tên sản phẩm (string)
                		"product_price": 100000, // Giá trị sản phẩm (sau khuyến mãi nếu có) (number)
                		"category_name": "Tên danh mục sản phẩm", // Tên danh mục sản phẩm (string)
                		"product_quantity": 1, // Số lượng sản phẩm (number)
                		"product_status_code": 1 // Trạng thái đơn hàng (0: đang xử lý - mặc định, -1: hủy, 1: thành công) (number)
                	},
                	{
                		"product_sku": 101, // SKU sản phẩm (string)
                		"product_name": "Conan tập 2", // Tên sản phẩm (string)
                		"product_price": 200000, // Giá trị sản phẩm (sau khuyến mãi nếu có) (number)
                		"category_name": "Tên danh mục sản phẩm", // Tên danh mục sản phẩm (string)
                		"product_quantity": 2, // Số lượng sản phẩm (number)
                		"product_status_code": 1 // Trạng thái đơn hàng (0: đang xử lý - mặc định, -1: hủy, 1: thành công) (number)
                	}
                ]
            }
        ]
    }
}
Body Respond Sample đối tác kết nối Cost per Lead (chỉ ví dụ trả dữ liệu thành công)
{
    "success": 1, // Xác nhận lấy dữ liệu từ API thành công
    "message": "OK",
    "data": {
        "transactions": [
            {
                "transaction_id": "12345", // Mã đơn hàng (string)
                "transaction_revenue": 500000, // Tổng giá trị đơn hàng (sau khuyến mãi nếu có) (number)
                "transaction_status_code": 0 // Trạng thái đơn hàng (0: đang xử lý - mặc định, -1: hủy, 1: thành công) (number)
            }
        ]
    }
}

Lưu ý:

  • Dữ liệu từ API cần cập nhật đơn hàng mới nhất từ trên xuống.

  • Đối tác khi cập nhật trạng thái đơn hàng cần cập nhật giá trị trường product_status_code.

  • Ngoài ra đối tác có thể thiết kế thêm tham số page (limit 100 đơn hàng mỗi trang), date_from & date_end cho API để tránh tình trạng thiếu đơn từ MasOffer.

  • MasOffer sẽ lấy cào dữ liệu từ API mỗi 1 phút 1 lần. Đây là cách làm thông thường khi đối tác hợp tác với các bên Affiliate Marketing Network.

Last updated