Installation Common Issues:
Last updated on: 2/2/2012
1.Port 1129
Make sure PORT 1129 is open on your server. Booklink magento extension for First Data Global Payment Gateway uses XML API which communicates on 1129 port. How to check if port 1129 open. Download file Check Port PHP file on your desktop and unzip. Upload “check_port.php” file on your server’s root directory and then type following on your browser: http://www.booklinksystem.com/check_port.php (replace booklinksystem.com with your domain name). If port 1129 is open on your server you should see result –> Its open (see screenshot below). If not then you will see error message. In that case you must contact your server administrator or webhosting company and request them to open port 1129 so that you can use First Data Global Payment Gateway to accept payment on your website. Most of the webhosting company will open the port on your request. FYI – (one of our client was using GoDaddy economy (shared hosting) plan and Godaddy declined to open port on their Shared hosting plan).
2. PEM File
There is always lot of confusion about PEM file so we hope this explaination clears 99% of them. If you still cannot figure it out then please contact us at info@booklinksystem.com
PEM file is a secure digital file used by First Data Global Payment (FDGP) Gateway to authenticate merchant. If you are testing your payment gateway then you first need to have a account on FDGP test box. If you don’t have a demo account then you can request one by going here: https://www.firstdata.com/gg/apply_test_account.htm
Once you have a demo account, login to your demo account and download PEM file for API. You can download this file by logging into your demo account and then go to “Support->Download Center” and enter Tax ID as 111111111 and click Download for “API“. Save this file on server at following location:/app/code/local/Booklink/Firstdata/Model/
Note: Only for extension version 2.0 or under: Once you uploaded PEM file on your server go to extension configuration in Magento admin and make sure you specify the location of PEM file there. This does not implies to version 3.0, in release 3.0 of this extension you only need to enter filename not the full path.
/app/code/local/Booklink/Firstdata/Model/<file-name>.pem
For windows based hosting you should flip the / to “\”
Windows Server: \app\code\local\Booklink\Firstdata\Model\<file-name>.pem
Common mistakes folks make here is they will enter their web address or absolute path:
Examples of some of the wrong path:
One more piece of key information to note here, if your Magento store is on subdomain or within another folder like for example: www.mysite.com/shop/ then PEM file location should be set as:
/shop/app/code/local/Booklink/Firstdata/Model/1000000111.pem
So once again if your magento store opens as www.mysite.com then you PEM file location would be
/app/code/local/Booklink/Firstdata/Model/1000000111.pem
and if your magento store open as www.mysite.com/shop/
/shop/app/code/local/Booklink/Firstdata/Model/1000000111.pem
NOTE: PEM files are different for Demo account and Live (production) account. You cannot use same PEM file for both. If you are testing your site on FDGP gateway demo account then PEM file should be used from the demo account and once you are ready to go live with your site then you must download new PEM file from production FDGP gateway site and upload on same location as mentioned above.
3. Gateway URL
You can test payment gateway on a demo account from FDGP gateway. If you have a demo account with them then you must use Gateway URL in the configuration as:
https://staging.linkpt.net:1129/lpc/servlet/lppay
Once you are ready to move to production site then for live account use Gateway URL as:
https://secure.linkpt.net:1129/lpc/servlet/lppay
As you can see port 1129 is embedded on to URL. More information about port 1129 is given in point #1.