First Data, Linkpoint, Global Gateway¶
This is a quick guide to implementing First Data, Aka. Linkpoint or Global Gateway as your payment processor in CiviCRM, unlike Authorize.net and Paypal, using First Data is slightly more complicated.
You will need to place a .pem certificate in your file system and correctly point your CiviCRM to it, you will have to open port 1129 on your rever and/or firewall, enter your store number, and finally make sure that the url to the payment processor is correct.
.pem Placement and implementation¶
First Data requires the placement of a .pem Certificate within your server file structure.
While the .pem Certificate may resemble an SSL Certificate, it has nothing to do with your standard SSL implementation. The .pem only serves as a handshake authentication between your server and the payment processor.
You should place it in a folder where your standard php user has read access, but preferably somewhere outside your web directory (not visible to the outside word). The filename is usually a ten digit integer with a .pem extension, and should be in ASCII format to be Linux readable.
certificate path
Once the .pem certificate is placed in the directory, make sure you insert the full certificate path into your CiviCRM payment processor configuration, starting from server root all the way out to the file location and including the file name.
Bad:
/linkpoint
/linkpoint/1234567890`.pem`
/home/site/public_html/linkpoint
Good:
/home/site/public_html/linkpoint/1234567890`.pem`
Ports¶
First Data requires TCP port 1129 to be opened bidirectionally.
If you are not running a firewall you do not need to take this step!
On a Linux server you will likely have to modify your IP Tables, if you have root access to your server you can do this by using some of the quickguides.
CentOS/ RedHat
http://wiki.centos.org/HowTos/Network/IPTables
Ubuntu
https://help.ubuntu.com/community/IptablesHowTo
If you don't have root access to your server you will need host modify the IP Tables for you.
Store Number¶
When configuring the payment processor, you will be asked for your "store name" - you should enter the store number for your account (by default, it's the same as the .pem filename generated for you).
Server URL¶
by default the First Data payment processor will reside at https://secure.linkpt.net, make sure you have nothing after the .net (example of bad: https://secure.linkpt.net/)