Linkpoint/Cardservice
Installation guide
This documentation is copyright 2004 Hyperactive Inc. all rights reserved. This document must be included in ANY version of OSCommerce it is distributed in, this includes OSC-MAX and CRE Loaded6. It may not be copied or modified without the express written consent of Hyperactive Inc. It must also be included with any future additions or ammendments to this module that you may upload or contribute to.


*****************************************************************

A Paid installation service is available for this module, as well as any module in the contributions section of oscommerce.com. Hyperactive Inc. Also does custom modifications and templates for OSC, OSC-MAX and CRE Loaded 6, as well as specialize in os commerce hosting.. To find out more or to schedule an installation please CLICK HERE

****************************************************************

 

 

Contents:

 

 



FEATURES:

 


Changes from previous Version

1. Fixed a bug in checkout_process.php. If the customer was in the checkout process on page checkout_payment.php and changed their billing address on this page, the checkout process would submit the customers shipping address and not the customers billing address in the data packet sent to linkpoint. This normally would not be an issue, since most customers never do this. However in those cases where it was done, it would cause a decline from linkpoint due to mis-matched AVS addresses.

 

 

 

Forward:
by T. Nordstrom

A little bit about this contribution. It is basically a modification and slightly improved version on Tim Wasson's "LinkPoint CardService International Payment Module". It has added feautures such as Credit Card Verification value and most all parameters are now transferred to Linkpoint Central. There has also been a change in that now the store owner has an option of choosing wheter or not the sale should be charged right away or after the order has been shipped. See post-authorization vs. immediate authorization. Another thing that another ocCommerce member (sorti) added was the e-mail notification that tells the store owner which values of the post-authorzation matched with the card. This should help prevent fraudalent situations. Sorti was a good help in many parts of the code. He also added the feauture to display both the month name and number in the expiration select box. Chris Thomas (www.Profitability.Net) was kind to remark that when using the Gift card/Credit voucher contribution the values sent for sub-total and total don't match, therefore the linkpoint won't work unless you add his little hack, which is included as: credit_voucher_gift_card_hack.txt. I myself don't want to take any credit at all for this module. My background has nothing to do with programming and therefore a lot of it was just a error-and-trial procedure. I haven't included any terms of use because I don't really know how to write it, but basically this is FREE to use on your own risk. So far a lot of people have asked me to send this module and it has successfully done its job. Please e-mail me any updates or developments you think of. Thanks!

Thomas (t_nordstrom at yahoo.com)



Before you begin:


What you will need:

 


 

Security Warnings:

despite what you may have been told. A Linkpoint PEM file DOES NOT secure your website. This may be verified from linkpoint itself at the following URL, http://www.linkpoint.com/support/sup_lpapi_faq.html#12

The PEM file contains a RSA private key and certificate which only secures transmissions between your website and linkpoints gateway. It DOES NOT secure credit card information between your customers web browser and your store. You will need to purchase a SSL certificate for your store to secure it. Failure to do so will leave you liable for any and all credit card damages resulting from anyone getting those transmitted credit card numbers.

If you need a reliable GEO TRUST single root SSL certificate from a company who owns their own chained root, please visit http://www.hyperactivehosting.com they are available for as low as $69.95 per year. Retail from GEOTRUST is $149.00 So you can take advantage of our reduced prices on those certificates

There are cheaper SSL certificates, namely, Comodo certificates. We however do not recommend them as Comodo leases their root certificate from Geotrust. Geotrust and Comodo are direct competitors and Geotrust is already offering free upgrades from Comodo to their own certificates. You can see how using a competitors root certificate is not a good idea as Geotrust could rescend Comodos right to use it and instantly make all Comodo Certificates invalid.

We sell Certificates from Geotrust, who owns their own root certificate.

 



INSTALLATION

 

Section 1 - Files list, sizes and installation locations:

Take care to copy all these files to their proper paths on your server.

Filenames, sizes and locations
File Name File Size Proper Installation Path
popup_cvs_help.php 717 bytes /catalog/
credit_cards.gif 2,106 bytes /catalog/images/
cvm_help1.jpg 9,641 bytes /catalog/images/
cvm_help2.jpg 9,521 bytes /catalog/images/
cvs_help.php 2,894 bytes /catalog/includes/languages/english/
linkpointms1.php 1,686 bytes /catalog/includes/languages/english/modules/payment/
lpphp.php 26,380 bytes /catalog/includes/linkpoint/
.HTACCESS 194 bytes /catalog/includes/linkpoint/
000000.pem 82 bytes /catalog/includes/linkpoint/
linkpointms1.php 21,930 bytes /catalog/includes/modules/payment/
linkpoint_without_option.php 21,820 bytes /catalog/includes/modules/payment/
phpconfig.php
446 bytes /catalog/
Please note files in red have special instructions and if you do not follow them this contribution will not work. Simply click the file name to view it's instructions or notes.

 


 

Section 2 - Javascript

*If you are using OSC-MAX Click Here
*If you are using OS Commerce MS1 or MS2 do this!

open file /catalog/checkout_payment.php
locate at roughly line 120 the following code:

//--></script>
<?php echo $payment_modules->javascript_validation(); ?>

Just before the //--></script> portion, add this code:

function popupWindow(url) {
window.open(url,'popupWindow','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=450,height=500,screenX=150,screenY=30,top=30,left=150') }

So that it now looks like this

function popupWindow(url) {
window.open(url,'popupWindow','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=450,height=500,screenX=150,screenY=30,top=30,left=150') }

//--></script>
<?php echo $payment_modules->javascript_validation(); ?>


*If you are using OSC-MAX do this

open file /catalog/includes/javascript/checkout_payment.js.php
at roughly line 40 you will see the following code.

//--></script>
<?php echo $payment_modules->javascript_validation(); ?>

Just before the //--></script> portion, add this code:

function popupWindow(url) {
window.open(url,'popupWindow','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=450,height=500,screenX=150,screenY=30,top=30,left=150') }

So that it now looks like this

function popupWindow(url) {
window.open(url,'popupWindow','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=450,height=500,screenX=150,screenY=30,top=30,left=150') }

//--></script>
<?php echo $payment_modules->javascript_validation(); ?>


Section 3 - Defines

open file /catalog/includes/application_top.php
locate the last line and look for this code:

?>

Add this code just before the ?>

define('FILENAME_POPUP_CVS_HELP', 'popup_cvs_help.php');
define('FILENAME_CVS_HELP', 'cvs_help.php');

So that it now looks like this:

define('FILENAME_POPUP_CVS_HELP', 'popup_cvs_help.php');
define('FILENAME_CVS_HELP', 'cvs_help.php');
?>

 


Section 4 - Images

 

Three images are included in this contribution and are designed to be used as popup help for your customers. They show in detail the location of the CVS/CVV code on each of the credit cards (visa/mastercard/american express).

Copy the images to your server to the proper path as described in Section 1


Section 5 - PEM FILE

Included with this contribution is a blank PEM file titled 000000.pem. The pem file will contain your RSA private key and certificate from linkpoint and would have been given to you in your welcome email when you signed up for their service. You will need both your store number, and your welcome email to complete this step. Have them ready!

Section 6 - Linkpointms1_without_option.php

This file is optional, and is designed to completely REPLACE the linkpointms1.php located in /catalog/includes/modules/payment/

What this file does:
This file removes the checkbox titled "My cvv code is missing or unreadable" from checkout_payment.php.

Why you would want to do this:
Credit card thieves will frequently not have the CVV/CVS code. If you do not want your customers to have the option of saying they can't read or dont have a CVV/CVS code, you would use this file. It theoretically would lower the chances of a thief buying from your store.

How do i use it:
Rename this file to linkpointms1.php and upload it as described in section 1 being sure to overwrite the linkpointms1.php already in /catalog/includes/modules/payment/ if you have already uploaded it.


Section 7 - Store Administration Setup

 

Login to your stores administration panel.
Click "Modules"
Click "Payment"
Turn off all payment methods you will not be using.
Click "linkpoint"
Click "Edit"

Enter your store number (number assigned by linkpoint)
Leave the linkpoint server address as is.
Enter the email address to send processing verification emails to (your address to get receipts)
Set store to LIVE mode, even for testing. Make sure linkpoint is in live mode on their end too. Use credit card number 4111111111111111 , Use CVV Code 599 and any expiration date after today when you do your test. If all was successfull, you will get a "There has been an error processing your card XxDeclinedxX" in your store. This is what you should get and congratulations on a good install!

*Developers
You may want to permanently write these values into the catalog/includes/modules/payment/linkpointms1.php file. The reason being: If and when the store owner ever unactivates the module the store number will be re-set to 000000 and he won't understand why the payment is not working. That's what I did. You can change the e-mail address to your store owner's default too... The way you would do it is by performing a find and replace on 000000. You will find the configuration values at the bottom. Change this number to your store number and the value will always be there no matter if the module has been de-activated or not. You can find the e-mail field by searching for: someone@yourdomain.com

**Please note: the default of this module is set to: Pre-authorization which basically means that you will have to post-authorize the payment after it's been shipped out. You will do this in Linkpoint Central. If you are only selling downloadable products or want the card charged instantly you can change this option into "Immediate authorization".


 

Credits:

 

Original Author: Tim Wasson (core code)
Revisions to original code: T. Nordstrom (core code)
Current Version: Clifton Murphy (popups, documentation, cvv/cvs updates, Support, Bug Fixes)
Gift Voucher Hack: Chris Thomas
Expiration box, code help: Sorti


Support Contact Information

 

Clifton Murphy support@hyperactivehosting.com Is currently providing free email and phone support for this contribution. If you require telephone support please call 1-(910)298-6381.

A simple installation service is available, with two prices depending on whether you host with us or not. If you are a hosting customer we install any module including this one for $29.95. If you are not a hosting customer we charge $49.95 to install any and all mods including this one.

If you wish us to install this module we can do a preinstallation test to make sure your host is compatible with this module. The cost for this service is $9.95 and is designed to save you the installation charge if your host does not support the requirements for this contribution. If your host is found to be compatible, the $9.95 will be deducted from the installation charge. To get us to install this, or any other module for you, simply Visit our online order processing wizard here Module installations


**All module contributions that www.Hyperactivehosting.com installs, are charged an installation fee with 20% of that fee going to the original module author! We do not charge for modules themselves, they are free and should remain as such. We only charge for the actual installation.