Support avatar
Written by Support
Updated over a week ago

February 24, 2016

UPDATED March 1, 2020

To configure  PinPoint into your Platform instance, you will go to Settings>Providers and  under ACTIONS select Add New Provider Profile.Select the type = Risk Management and select PinPoint from the drop down.Fill out the required parameters which are outlined below and click “Save”.

For more information on this Gateway click here

These parameters are briefly described here for your reference:

API Username: This will be provided to you by Pinpoint.

API Key: This will be provided to you by Pinpoint.

Merchant Id: This will be provided to you by Pinpoint.

Site: This is a user defined unique identifier that we relay to Pinpoint.

There are 2 ways in which your Pinpoint profile can be configured.

Decline Review/Decline Escalate: This allows the user to define how the system will react to the review/escalate status that we may receive from Pinpoint. If “YES”, the system will decline any records associated to those status’ and suppress the post to the gateway.

Custom Threshold: Alternatively, you can configure your profile with a hardcoded threshold score. When a value is specified, this will cause any record over the defined score to decline regardless of status. This will override the decline review/ decline escalate flags

Test Mode: Select if you want to use Pinpoint in Test Mode.

Alias: For internal purposes only; it helps you identify a specific profile among several others in your Platform.

After you have configured your Risk Management Provider account into your Platform, you will assign it at the campaign level. This means that it will not be automatically enabled on all your campaigns; instead, you will assign it to those campaigns that you choose to assign the risk mitigation protection to.

Additional Information

Pinpoint's technology uses a pixel post to gather device and consumer information on the pre-sale page.  The pixel HTML listed below is provided with our web form technology, and it does not need any modification; however, in order for Pinpoint's Katpcha code to work, you must re-download the web forms.  

NOTE: The campaign_id in the pixel can be hard-coded to a single campaign if unknown at the time the pixel fires, so long as this campaign has a Pinpoint profile configured within it.

Using Pinpoint with the API

If you are using our API technology, please pass a uniquely generated alphanumeric "session id" that you generate on your server side script, and pass another (sessionId) parameter to the pixel.php handler.    When you send a request to the API methods, please pass the same session ID to the request exactly as you did with the PIXEL IFRAME.  Example: sessionId=1234567890

If you want to assign it to an existing campaign, you will go to Campaigns>Manage Campaigns and go to the campaign that you want to assign the anti-fraud provider to. Click on “Edit” to open up the campaign form, scroll down to Anti-Fraud Providers field and select Pinpoint from the drop down menu. When finished, click on “Save” at the bottom of the page to save the changes applied to the campaign.

Did this answer your question?