🌟[WEBHOOK API] - Ghi nhận đơn hàng Cost per Lead (CPL)

Webhook API được sử dụng để ghi nhận và cập nhật thông tin đơn hàng khi có sự thêm mới hoặc thay đổi.

Method: GET

Endpoint (Dev/Test):

http://s2s.dev.masoffer.tech/v1/${offer_id}/postback.json?api_key=${api_key}&offer_type=cpl_one_postback&transaction_id={transaction_id}&click_id={mo_traffic_id}&status_code={transaction status}&sale_amount={sale_amount}&status_message={how transaction was rejected?}

Endpoint (Production)

https://s2s.masoffer.net/v1/${offer_id}/postback.json?api_key=${api_key}&offer_type=cpl_one_postback&transaction_id={transaction_id}&click_id={mo_traffic_id}&status_code={transaction status}&sale_amount={sale_amount}&status_message={how transaction was rejected?}

Response

Thành công

{
    "status_code": 200,
    "message": "Send postback successfully",
    "meta": {}
}

Thất bại

{
    "status_code": 402,
    "meta": {},
    "error": {
        "message": "Message"
    }
}js

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

Tham số	Mô tả	Loại	Bắt buộc
offer_id	Id của đối tác do MasOffer cung cấp.	String
api_key	API Key của đối tác do MasOffer cung cấp	String
transaction_id	Mã đơn hàng của đối tác.	String
click_id	ID của traffic do MasOffer cung cấp qua Tracking Link (đã lưu trong cookie).	String
status_code	Trạng thái xử lý đơn hàng: 0: đang xử lý 1: đã mua thành công -1: đã hủy	Number
payout	Hoa hồng về MasOffer.	Number
sale_amount	Giá trị đơn hàng (sau khuyến mãi nếu có)	Number
status_message	Lý do hủy đơn hàng (nếu có)	String

Trong trường hợp cập nhật trạng thái đơn hàng, đối tác bắn postback lại y nguyên như lúc ghi nhận đơn, tuy nhiên thay đổi giá trị trường status_code.

Một số lưu ý khi cập nhật trạng thái đơn hàng:

• products.price và products.payout sẽ không được cập nhật (chỉ ghi nhận giá trị bắn lần đầu).

• products.status_code chỉ được thay đổi 1 lần. Ví dụ: từ 0 → 1 hoặc từ 0 → -1.

• Các trường thông tin khác được thay đổi chỉ khi products.status_code thay đổi.