IPQS
Fraud Reporting

About Fraud Reporting in Custom Integrations

This API allows you to report an order, transaction, or user as fraudulent. It requires you to have previously made a proxy detection API call containing an order.

Request URL

Warning

For security reasons, you should only call this API server-side.

You can use the following URL to report an order, transaction, or user as fraudulent:

https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/report_order

Request Parameters

Parameter Description Example Value / Format
key Required. Your site's domain or the domain that requested this integration. example.com
secret Required. Your user's current secret created during the authentication process. char(128)
request Required. The unique request ID of the original proxy API call containing this order's information. string

Response Parameters

Note

Only JSON responses are available from this API.

Parameter Description Format
message Description of the status of this call. May contain errors if errors exist. text
success Boolean result of if the request was successful or not. boolean
// URL for this request.
$URL = 'https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/report_order';

// Configuration items for this request. NOTE: $secret will be user specific not application specific.
$key = 'example.com';
$secret = 'YOUR_API_KEY_HERE';

// The original request ID from a proxy report.
$request = 'aS4sf23dsfj4dd';
	
// Prepare POST fields.
$fields = array(
	'secret' => $secret,
	'key' => $key,
	'request' => $request
);
	
// Create CURL.
$curl = curl_init();
	
// Configure CURL
curl_setopt($curl, CURLOPT_URL, $URL);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_POST, 1);

// Set POST Parameters
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($fields));

// Fetch URL
$result = curl_exec($curl);

// GET response code.
$response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);

// Close CURL
curl_close($curl);
	
// Handle result.
if((int) $response_code === 200){
	// JSON Decode
	$output = json_decode($result, true);
	
	if($output['success'] === true){
		echo "Order reported successfully.";
	} else {
		echo "Order report failed";
	}
} else {
	echo "There appears to be an unforeseen error. Please contact IPQualityScore support if this persists.";
}

Ready to eliminate fraud?

Start fighting fraud now with 1,000 Free Lookups!

We're happy to answer any questions or concerns.

Chat with our fraud detection experts any day of the week.

Call us at: (800) 713-2618