Frequently Asked Questions

When ever you set RESULT to GOOD, the transactions will not show up on the LinkPoint Central reports. You will need to change it to LIVE for the transactions to show up in the reports.

Make sure you do not set "threshold" to be more than 5.

The LinkPointTransaction.dll file is located in the bin directory. Remove the reference to the file at the top and add it again.

Make sure you have installed the 2 OpenSSL files in the system32 directory. Also make sure you remove any copies from the bin directory.
libeay32.dll
ssleay32.dll
http://linkpoint.com/support/openssl_download.htm

If the error continues, remove the 2 OpenSSL files from the system32 directory and place them in the bin directory.

This has worked for some merchants, your results may vary.

1. On the web server go into Network Connections
2. Right-click the Local Area Connection and select Properties
3. Click on Internet Protocol (TCP/IP) and then click on Properties
4. Click on the Advanced button
5. Click on the WINS tab and select "Disable NetBIOS over TCP/IP."
6. Click OK

Make sure the correct permissions are setup for LpiCom_6_0.dll

Either the file Lpicom_6_0.dll is missing or was not registered.
Make sure you place the file in the system32 directory.
Run the following command at the dos prompt to register the DLL file.
regsvr32 /u c:\windows\system32\lpicom_6_0.dll

You will also need to restart IIS.
At the dos prompt window type the following command:
iisreset

Make sure you have installed libeay32.dll and ssleay32.dll in the system32 directory
OR
Download Windows COM Object 3.0.17 and install LpiCom_6_0.dll from the included file.
Make sure you unregister the DLL and delete the existing file.
regsvr32 /u c:\windows\system32\lpicom_6_0.dll

You will also need to restart IIS.
At the dos prompt window type the following command:
iisreset

Also make sure the permissions are setup correctly for LpiCom_6_0.dll
The anonymous user named USERS (iuser) should have read & execute permissions to LpiCom_6_0.dll

Make sure the correct host name is entered in the config.inc file.
This could be a DNS issue, you can try replacing the host name with the IP address for secure.linkpt.net

This error is a problem with the COM Object that seems to affect Windows 2003 server.
There is no work around currently available.

Download Windows COM Object 3.0.17 and install LpiCom_6_0.dll from the included file.
Make sure you unregister the DLL and delete the existing file.
At the DOS prompt window type the following command:
regsvr32 /u c:\windows\system32\lpicom_6_0.dll

Delete the existing file and upload LpiCom_6_0.dll
Register the DLL by entering the following command at the DOS prompt:
regsvr32 c:\windows\system32\lpicom_6_0.dll

You will also need to restart IIS.
At the dos prompt window type the following command:
iisreset

If the server is Windows 2003 server you may need to change the application pool.
Go to Start -> Programs -> Administrative Tools -> Internet Information Services (IIS) Manager

Download Windows COM Object 3.0.17 and install LpiCom_6_0.dll from the included file.
Make sure you unregister the DLL and delete the existing file.
At the DOS prompt window type the following command:
regsvr32 /u c:\windows\system32\lpicom_6_0.dll

Delete the existing file and upload LpiCom_6_0.dll
Register the DLL by entering the following command at the DOS prompt:
regsvr32 c:\windows\system32\lpicom_6_0.dll

You will also need to restart IIS.
At the dos prompt window type the following command:
iisreset

If the server is Windows 2003 server you will may to change the application pool.
Go to Start -> Programs -> Administrative Tools -> Internet Information Services (IIS) Manager

The wrong filename entered for the PEM or its not in the directory.
 

• Make sure you include the full path for the PEM including the drive letter. For example:
  Const keyfile = "c:\inetpub\wwwroot\linkpoint\123456.pem"
• Check the permissions of the PEM file. The permissions need to be read and execute for everyone.
• Try placing the PEM in a different directory. For example, in the same directory as the HTML files.

The wrong path for the PEM file, permissions problem, or PEM file is corrupt.

Contact your web host and verify they are not blocking port 1129. Some web hosts like GoDaddy will block this port.

SSLHandshakeException: sun.security.validator.ValidatorException: No trusted certificate found

You will receive this error when using the staging server. You will need to add the certificate on the staging server to your cacerts trusted list file.

1. Get the certificate by going to https://staging.linkpt.net:1129 using Internet Explorer. When the security alert box pops up, click on "View Certificate."
2. Then click on the "Details" tab at the top.
3. Then click on "Copy to File..." button.
4. Select the DER encoded binary X.509 (.CER) format. Save the file and remember the location you saved it and its filename.
5. Locate your "cacerts" file, usually in $JAVA_HOME/jre/lib/security/cacerts
6. Type the following command:
   keytool -import -file /path/filename.cer - keystore $JAVA_HOME/jre/lib/security/cacerts
7. It will ask for a password, default password is "changeit"

You are receiving this error becuase you have the wrong path for the PEM file. Also make sure you upload the PEM file in ASCII format for UNIX servers.
On a UNIX server the path for the PEM file should look something like this:
$myorder["keyfile"] = "/home/htdocs/www/linkpoint/123456.pem";

On a WINDOWS server the path should look like this:
$myorder["keyfile"] = "c:\\inetpub\\wwwroot\\linkpoint\\123456.pem";

If you can not determine the path for the PEM file you can use the following code: (make sure the PEM file is in the same directory as your PHP file)
$myorder["keyfile"] = realpath("123456.pem";);

More than likely you have the wrong path for the PEM file.

On a UNIX server the path for the PEM file should look something like this:
$myorder["keyfile"] = "/home/htdocs/www/linkpoint/123456.pem";

On a WINDOWS server the path should look like this:
$myorder["keyfile"] = "c:\\inetpub\\wwwroot\\linkpoint\\123456.pem";

If you can not determine the path for the PEM file you can use the following code: (make sure the PEM file is in the same directory as your PHP file)
$myorder["keyfile"] = realpath("123456.pem";);

More than likely you have the wrong path for the PEM file.

On a UNIX server the path for the PEM file should look something like this:
$myorder["keyfile"] = "/home/htdocs/www/linkpoint/123456.pem";

On a WINDOWS server the path should look like this:
$myorder["keyfile"] = "c:\\inetpub\\wwwroot\\linkpoint\\123456.pem";

If you can not determine the path for the PEM file you can use the following code: (make sure the PEM file is in the same directory as your PHP file)
$myorder["keyfile"] = realpath("123456.pem";);

The gateway may possibly be experiencing problems.

When modifying a periodic bill the credit card information must be included.

You need to contact LinkPoint/Yourpay support to have the credit option enabled on your account.

Make sure you have not exceeded the character limit for any of the fields. The <items><description&gt; field has a limit of 120 characters.

Either no order number or the incorrect one was specified when trying to do a void.

Either no order number or the incorrect one was specified when trying to do a postauth.

There maybe a problem with the credit card entered. Verify the credit card number with the customer.

The LinkPoint gateway will not allow the same order number to be submitted more than once. If a transaction is declined the order number must be changed.

1. Log into LinkPoint Central
2. Click on Admin in the top menu
3. Under Fraud Settings click on "Set Lockout Times"
4. Change "Duplicate Locktout Time" from 10 minutes to something less.

Normally you will receive this error when you enter the wrong order number (OID) when trying to modify or cancel a periodic bill. Make sure the order number is for an active periodic bill.

There are a couple different things that would cause this error. The merchant account may be disabled in one of the databases with your merchat account provider. This is sometimes generated for a declined transaction.

Your merchant account may not be seutp for American Express or Discover. Please contact merchant services to verify this.

Make sure the expiration date has not passed.

Make sure the correct amount of digits was entered for the credit card. Dashes are acceptable using API.

Make sure all the amounts add up correctly. Also make sure you round up to 2 decimal places.

The credit card entered is expired or cancelled.

The gateway is experiencing problems.

At the moment you can only set installments from 1-99 or -1 for an infinite amount of times.

There are a couple different things that will cause this error.

1. Make sure the amount for chargetotal is not blank.
2. Make sure expiration year is only 2 digits
3. Make sure there is no dollar sign for the amount.
4. Make sure there are no symbols like an ampersand, apostrophe, or letters with accents
5. If there is no shipping make sure you pass zero for the amount
6. If there is no tax make sure you pass zero for the amount
7. Make sure there are no commas in the amount for chargetotal

You can use the CDATA tag to pass any symbols. For example:

If you are developing in PHP you can try using HTMLENTITIES instead.

Verify first that the the correct store number is entered. This error normally occurs when contact information is updated with your merchant bank. For example if the business phone number or address was recently updated. You will need to contact LinkPoint/Yourpay support and they will need to generate a new PEM file for your account. You will then need to download the new file and either upload it to your web site or copy/paste it into your shopping cart.

Normally you will receive this error when you are trying to use your live account with the staging server. In order to use the staging server you must first setup a separate test account on the following web site:
https://www.linkpoint.com/support/sup_teststore.asp

Also make sure you entered the correct store number. If you are using Yourpay you must enter the 10 digit store number. This is a common error for the Miva Merchant shopping cart because it asks for "storename." If you are setting up a shopping cart make sure you enter your store number when prompted for "storename."

This is not an error. The transaction was actually declined by the issuing credit card bank. The merchant needs to call for a voice authorization and then manually enter the transaction. Otherwise, the customer will need to contact their credit card issuing bank to have them allow the transaction and submit it again.

NOTE: Your merchant bank may charge a higher fee (percentage rate) for entering a transaction as a "Forced Ticket."

This is not an error. The transaction was actually declined by the issuing credit card bank. You will also receive this message when using a test credit card.

You need to contact either Miva or your web hosting company to obatin an updated LinkPoint module that will fix 2 different issues.
SGS-002301: Charge total must be the sum of subtotal, tax, vallue added tax, and shipping.
SGS-005003: The order already exists in the database.

Once the module has been updated you will notice the order number in the LinkPoint Central reports will be changed to a 28 digit number.
The Miva order number will still be recorded under the "userid" field.

 Most of the time a check is declined due to incorrect information that was entered or Telecheck determines the checking account information to be incorrect.

When you enter a check you will not be provided with a reason if its declined.
You can contact LinkPoint support, (800) 456-5989 x4100, and they can determine if there was a problem with the information entered.
Otherwise the customer must contact Telecheck directly at 1-877-678-5898.
Checks can sometimes be declined due to invlalid information entered.
Make sure you follow these guidelines when entering checks:

1. Check account number and routing can not contain any dashes or symbols.
2. A valid driver's license number must be entered.
3. Do not enter any dashes for driver's license number
4. Phone number can not contain any dashes or parenthesis.
5. Do not enter periods for the city
6. Zip code must be only 5 digits and no dashes.

NOTE: Due to the driver's license requirement, VirtualCheck will not work with checks from international customers.

1. Once you log into LinkPoint Central click on reports at the top.
2. Next click on Transactions
3. Select the option "By Transaction Type And Time"
4. Click the checkbox for "Check"
5. Click on the "Submit Query" button.

 You need to make sure you select the insert HTML option in FrontPage. Below are steps for different version of FrontPage.

Open the HTML page in FrontPage
Place your cursor where you want to insert the HTML code.

FrontPage 1.x/97 or FrontPage Express
Click on the "Insert" menu
Select HTML Markup

FrontPage 98
Click on the "Insert" menu
Select FrontPage Componenet...
Select Insert HTML

FrontPage 2000
Click on the "Insert" menu
Select Advanced
Select HTML

FrontPage 2002
Click on the "Insert" menu
Select Web Component
A window named Insert Web Component will open. On the bottom left click on "Advanced Controls."
Select "HTML" then click on Finish

Hold down the CTRL key and press V
This should paste the HTML code you copied earlier.
Click on OK

Save your changes post the update to your web site.

 First you need to log into LinkPoint Central and verify the Connect settings.

After you login, click on Customization at the top.
Then click on "Configure LinkPoint Connect settings."
Make sure you entered something for the Cofirmation and Failure URL fields. If you do not have a thank you or sorry page you can enter the address for your website. For example:

http://www.yourdomain.com

 You need to create your own thankyou (approved transactions) and sorry (declined transactions) pages.

You also need specify the URL address for these pages on the LinkPoint Central.
After you login, click on Customization at the top and then click on configure Linkpoint Connect settings.
Turn on (enable) the the following option for both Confirmation and Failure Page.

"Automatically display URL after the LinkPoint HTML receipt page."

  You are receiving this message because the logo is not located on a secure server. You need to contact your web host to see if you have a secure server (SSL certificate). Some web hosts provide a shared secure server. You will need to upload (ftp) the logo to the secure server. Here is an example of what the URL address will look like:

 At the moment there is no option to customize the fields on the payment form. You can only make the following changes:

Add header and footer text to the LinkPoint confirmation page
Add a logo
Add a background image

You can make these changes on LinkPoint Central under Customization by clicking on Payment Form.

 You need to make a change on LinkPoint Central.

1. After you login, click on Customization at the top
2. Click on configure Linkpoint Connect settings
3. Turn on (enable) the option "URL is a CGI script"

Even though you are not be using CGI you still need to enable this. This option tells LinkPoint to post data back to your page.

 You need to add the following hidden field to the page on your web site.

<input type="hidden" name="shippingbypass"; value="true">

 You need to add the following hidden fields to the page on your web site.

<input type="hidden" name="responseSuccessURL&quot; value="http://www.yourdomain.com/thankyou.html">;

<input type="hidden" name="responseFailURL&quot; value="http://www.yourdomain.com/sorry.html">

You can apply for a test account on the following web site.

https://www.linkpoint.com/support/sup_teststore.asp

 Make sure you enter the store number and not your business name. For example:

<input type="hidden" name="storename" value="123456">

If the store number is correct then take a look at the opening FORM tag. Remove the following code: enctype="mulipart/form-data"

<form action="https://www.linkpointcentral.com/lpc/servlet/lppay" method="post" enctype="mulipart/form-data" >

 Error 1002 is due to either the wrong URL (http) address entered on the LinkPoint Connect settings or the URL address has additional arguments (question mark). LinkPoint Connect does not support dynamic URLs. You can access the settings for LinkPoint Connect by logging into LinkPoint Central.

Once you login you will click on Customization at the top.
Then click on "Configure your LinkPoint Connect."
Look for the field, "Order submission form URL," and verify you have the correct address for your order page.
If you have more than one page make sure you separate them with a space.
You have to make sure you upload (ftp) the file to your web site first before you try to test it.
The following example will not work with Connect because the query string at the end of the URL will always change.
http://www.yourdomain.com/order.asp?id=1002&product=cd&amp;total=12.00

If your web site or shopping cart has a dynamic URL that changes like the example above you will need to program it so that it does not add the string. If you are not able to change the URL address then you might want to consider getting a secure server (SSL certificate) and using LinkPoint API.

 You need to log into LinkPoint Central and enter the same URL address two times.

This may cause a problem if you have a lot pages becuase the field only allows about 250 characters.
You can access the settings for LinkPoint Connect by logging into LinkPoint Central.
Click on Customization at the top.
Then click on "Configure your Linkpoint Connect" settings.
Look for the field, Order submission form URL.
Enter the same address twice and separate them with a space.
NOTE: One address will have www and the other won't.
For Example:
http://www.yourwebsite.com/order.html
http://yourwebsite.com/order.html

You may also need to enter it a third time with a slash at the end of the URL.
http://www.yourwebsite.com/order.html/

If you have 2 different domains that point to the same web site you will also need to enter the HTTP address for both domains.
For example:
http://www.error1002.com/order.html

http://www.1002error.com/order.html

 At the moment it is not possible to print a receipt again. You can print the details of the order and use that as a receipt. Unfortunately the order details will not look like the receipt you are accustomed to.

1. Log into LinkPoint Central
2. Click on Orders or View orders
3. Select the date range and at the bottom click on the submit query button
4. Locate the order and click on the order number
5. Right-click on the page and select print

 This is not a feature of LinkPoint. The information is being saved by your Internet browser. If you are using Firefox or Netscape you can click here for steps on how to clear the form.

1.  Enter the transaction under POS (point of sale) on LinkPoint Central.
2. You will enter it like a regular transaction except for 2 fields that will be different.
3. Look for "transaction type" and change it from "Sale" to "Forced Ticket."
4. Next look for "Reference Number" and enter the 6 digit authorization code you received over the phone.
5. You will also need to enter the credit card number and expiration date.

NOTE: Your merchant bank may charge a higher fee for entering a transaction as a "Forced Ticket."

 You can only obtain an authorization over the phone. This is a 2 step process. After you obtain the authorization over the phone you still need to enter it on LinkPoint Central in order to capture the funds. You can contact your merchant bank/provider to obtain the voice authorization phone number. If the transaction is approved over the phone you will receive an authorization code (Reference Number). Make sure you write this down. Once you get back home you will need to enter the transaction on LinkPoint Central as a "Forced Ticket" using the authorization code you received over the phone.

NOTE: Your merchant bank may charge a higher fee for entering a transaction as a "Forced Ticket."

 The credit card company is requesting you, the merchant, to call the voice authorization phone number for an approval. This is a 2 step process. After you obtain the authorization over the phone you still need to enter it on LinkPoint Central in order to capture the funds. You can contact your merchant bank/provider to obtain the voice authorization phone number. If the transaction is approved over the phone you will receive an authorization code (Reference Number). Make sure you write this down. You will need to enter the transaction on LinkPoint Central under POS as a "Forced Ticket." There are different reasons credit card issuing banks request this. The customer may have done several purchases on a single day or the credit card company needs to verify some additional information.

NOTE: Your merchant bank may charge a higher fee for entering a transaction as a "Forced Ticket."

1.  Log intoLinkPoint Central and verify each individual order.
2. Click on Reports at the top and then click on Orders
3. Scroll to the bottom and click on "Submit Query."
4. Under the shipped column, the orders will be marked N.
5. Click on the order number to view the details of the order
6. Scroll down and look for the approval code, it is a long string of numbers and letters.

You want to verify that the billing address and zip code match.
In the middle of the approval code there will be a 4 letter combination. Here are some examples.
In the middle of the approval code there will be a 4 letter combination. Here are some examples.
YYY      Both address and zip code matched
NNN      Both address and zip code did not match
NYZ      Only zip code matched
YNA      Only Address matched
XXGU    No system available to verify address, possibly an international credit card

CVV2 response is the fourth letter
M    CVV2 (security code) is correct
N    CVV2 (security code) did not match
P    CVV2 (security code) was not entered

To learn what the codes mean you can do a search for AVS on the LinkPoint Central Help section.
You may also want to verify that the order is not being shipped to a different address.

1. Log into LinkPoint Central
2. Click on Reports at the top and then click on Orders
3. Select a date range if it was done more than a month ago.
4. Click on submit query button at the bottom
5. Locate the order and click on the order number
6. Scroll down and on the left you should see a return order button
7. To the left of the button you will type in the amount you want to refund, it can not be more than the original transaction
8. Finally click on the return order button

 You can only void a transaction the same day an order is placed before the batches close. If the transaction is a preauth/authorization you will need to mark it shipped first and then void it immediately.

1. Log into LinkPoint Central
2. Click on Reports at the top and then click on credit card batches
3. Click on the word, "current batch"
4. Once you locate the transaction, click on the select box in front of it
5. Finally click on the void selected transaction button

You need to log into LinkPoint Central and mark the order shipped. Even if your type of business does not ship a product you still need to do this.

1. Log into LinkPoint Central
2. Click on Reports at the top and then click on Orders
3. Click on the submit query button, this willl bring up the orders for the current month
4. Look under the shipped column, if it has a "N" then it hasn't been processed.
5. Click the select box in front of the order
6. Next click on the button at the bottom that reads, "work with selected orders"
7. On the next screen select confirm shipment
8. Finally click on the submit query button.

 Yes, LinkPoint is CISP (PCI) compliant. You can find LinkPoint on the list of compliant service providers (PDF, 134k) found on the Visa web site. For more information on CISP compliance you can visit the Visa web site.

 LinkPoint Connect is easier to setup and does not require a secure server (SSL certificate) on your web site. You will need to copy and paste some HTML code to your web site. This code will create a buy now button. Your customer will click on the button and they will be redirected to a secure payment form on LinkPoint.

To enable the open/save prompt for .csv files, follow these steps:

1. Click on the Start button and place your mouse over
2. Settings then click on Control Panel
3. Click on the Tools menu then click on Folder Options
4. Click on the File Types tab
5. Under extensions scroll down and look for XLS
6. Click on "XLS Microsoft Excel Worksheet" to highlight it
7. Click on the Advanced button
8. Enable the option "Confirm open after download"
9. Click the OK button
10. Click the OK button
11. Close the Control Panel window