1. How to Push Orders

1. What is Order Push

Linkbest supports pushing publisher promotion effect orders to publisher platforms actively.

2. Fill in the Pushing Address

After publishers access Linkbest, fill in "Pushing Address" on the Linkbest website.

Log in to Linkbest, go to "My Tools" -> "postback". Enter the push address to receive the order in the push address input box of the corresponding media, and click "Submit".

When submitted, Linkbest will make a test push to verify the interface. The pushing interface needs to return 1, 0 to indicate that the test data has been received, and -1 means that the test data has not been received.More Details

3. Review the push address

After submitting the review, please wait patiently for the staff review, and contact customer service staff if necessary. Linkbest will do a test push to verify the interface during the review.

4.Precautions

Linkbest will regularly verify addresses. If an address responds abnormally more than 3 times in a row, users will be notified via email to check the address. If the target address does not respond normally within 7 days, the push status will change to Stopped.

The Status of orders actively pushed by Linkbest includes: created, confirmed settlement, settled, invalidated. Publisher platforms will be actively pushed when the above states occur.

The confirmed settlement, settled, invalidated Statuses of Linkbest orders are currently marked as confirmed settlements, settlements, and invalidations when the settlement process is completed in Linkbest.

If publishers need the original order Status of the e-commerce platform (created, paid, returned, etc.), please use the Linkbest order details inquiry API. Currently, only online merchants that support real-time order Status updates will have Status updates, such as JD, Taobao.

2. Push Data

Linkbest will initiate a POST request to the push address and send the order data in JSON Body format. Each push will contain 1 order, and a push verification parameter, sign, will be included in the parameters. For details, please refer to the description below.

1. Push parameter description

The parameters are all lowercase characters, and the parameter value is UTF8 encoding.

2.Receiving request safety verification instructions

The data in the data body varies based on the event type, while other parameters remain fixed. For receivers, we recommend verifying the sign value. The verification logic and code example are as follows:

md5($token . $eventType .$pushId. $crateTime)

PHP code example:

$requestSign = $body['Sign'];

// Postback token
$computedSign = md5($token.$body['EventType'].$body['PushId'].$body['CrateTime']);


//If $computedSign == $requestSign is a legal push

3.Order push data return mechanism

If the push address passes testing, Linkbest will push order data in real-time after generating promotional effect orders. (Note: Some special merchants do not support real-time order returns, such as next-day returns or hourly returns.)

Default push timeout is 10 seconds. If the push fails, Linkbest will retry with the following intervals: 60s, 300s, 600s, 1800s.

Order pushes do not include product details. To obtain order item details, you may initiate an "Order Details Query" request.

3.response requirements after receiving the request

If the push is successful, please output the following value from the receiver: 1 means that the push is successful and the order has been successfully placed in the warehouse. 0 means the push was successful, but the order already exists. -1 means push failed.

If the recipient does not feedback any data, we also consider the push to fail.

4.review the test push of the push address

In order to review the validity of the filled-in interface, we will construct a test push during the review. The pushed data is as follows:

After receiving the above information, please output 0 or 1 through the interface. By default, the interface does not receive data. For direct access, please output -1 or no output.