DeleteOrder. Deleting / Hiding an Invoice

You can delete the existing order by sending a query to the API service using software methods.

You can delete each order once using the function.

The query is sent by the POST method in the URLencode format to the address:   http://username.justclick.io/api/DeleteOrder.

Where username is the login of the user in the system, as well as their domain of the third level in the JustClick service.

Parameters Transferred in the Query

• bill_id is the number of the order to be deleted (required).

How Does It Work?

You transfer the number of the order to be deleted using the DeleteOrder API function. If the order exists, it is deleted.

Your system will receive the result of the function performing.

The response is coded in JSON format. For more details, see the API Service Responses.

Example of Deleting the Order in PHP

In the example, we delete the order #1111. The login in the system is “username”.

GetHash Function forms the hash to the transferred data.

CheckHash Function checks the hash to the service response.

 // Login to the JustClick system. 
 $user_rs['user_id'] = 'username';
  // The key for forming a hash. See API section (the link in the bottom right corner of the personal account).
 $user_rs['user_rps_key'] = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
 
// Forming the array of bought goods for transferring to the API.
$send_data['bill_id'] = 1111; 

//Forming the hash to the transmitted data. 
$send_data['hash'] = GetHash($send_data, $user_rs);

// Calling the DeleteOrder function and decoding the received data.
$resp = json_decode(Send('http://username.justclick.io/api/DeleteOrder', $send_data));

//Checking the service response.
if(!CheckHash($resp, $user_rs)){
	echo "Error! The response hash is not true!"; print_r($resp);
	exit;
}

if($resp->;error_code == 0)
	echo "The order is deleted.</span> Service response: {$resp->;error_text}";
else
	echo "Error code:{$resp->;error_code} - description: {$resp->;error_text}";

// =========== Functions of sending, receiving and processing a response. ============

// Sending the query to the API service 
function Send($url, $data)
{
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
	curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // outputting the response to the variable.

	$res = curl_exec($ch);

	curl_close($ch);
	return $res;
}

// Forming the transferred to the API data hash.
function GetHash($params, $user_rs) {
	$params = http_build_query($params);
	$user_id = $user_rs['user_id'];
	$secret = $user_rs['user_rps_key'];
	$params = "$params::$user_id::$secret";
	return md5($params);
}

//Checking the received response hash.
function CheckHash($resp, $user_rs) {
	$secret = $user_rs['user_rps_key'];
	$code = $resp->;error_code;
	$text = $resp->;error_text;
	$hash = md5("$code::$text::$secret");
	if($hash == $resp->;hash)
		return true; // the hash is correct
	else
		return false; //  the hash is not correct
}