Using Cardservice

ecBuilder Pro can use Cardservice International as a payment processing company. In order to take advantage of the credit card processing capabilities provided by Cardservice, you must set up an API Merchant Account. For more information, visit http://www.cardservice.com to learn more about how their system works.

 Click here to find out how your Web site visitor sees a Cardservice transaction.

The Cardservice Payment Gateway allows for the pre-authorization, post-authorization, and credit of funds to and from the consumer’s credit card.

Using Cardservice as your credit card transaction processing company, you receive an e-mail file attachment that may also contain credit card pre-authorization information generated from your Web site. The consumer’s e-mail message will contain confirmation information from the merchant indicating the order has been received.

In addition to allowing merchants to view the order information received as an e-mail attachment, the ecOrderDesk component provides a direct interface to the Cardservice payment processing server which enables the merchants to directly perform a pre-authorization, and after the order has been shipped, perform a post-authorization and credit request to the Cardservice Processing server.

You can manage your Cardservice account at the Cardservice Merchant Reports and Tools and the Virtual LinkPoint Web sites.


Cardservice Settings Dialog Box

Use this dialog box to enter your Cardservice payment processing information. You must have a Cardservice API merchant account to proceed. The required Gateway information is provided to the merchant via a “Welcome to LinkPoint API” e-mail which is sent after the account has been approved and the “store” provisioned.

 Click here to read more about using Cardservice as your payment processing gateway.

Storename

Enter your Cardservice store name (usually 6-digits).

Key File

Enter the complete, absolute path to the folder where your .PEM file resides. This .PEM file is sent to you from Cardservice and consists of an RSA Private Key and a Digital Certificate.

Host

Enter the secure host name for the Cardservice Payment Gateway (i.e. secure.linkpt.net).

Port

Enter the port number (usually 1139) through which communications between your web host and the Cardservice Payment Gateway will be established. If your web host has a firewall in place, make sure that this port number is open to the outside.

TX Type

Select “Sale” if you wish to perform an immediate transfer of funds to the merchant’s account when the customer places an order. These types of transactions usually do not involve shipping.

Select “PreAuth” if you wish to perform a pre-authorization of payment when the customer orders an item. This selection allows you to verify that the customer has sufficient funds for merchandise when an order takes place. At a later time, you can perform a "Complete Pre-authorized Purchase" transaction from ecOrderDesk to complete the transfer of funds.

Mode

Select “Test” if you wish to test your shopping cart before processing real credit card transactions. Transactions of this type will always return APPROVED unless there is some context error associated with the transaction data, or some fraudulent activity is detected.

Select “Live” when you are ready to move your shopping cart to production and perform live credit card transactions.


Cardservice from the Web Site Visitor's Perspective

If you set up your online catalog to use Cardservice for credit card transaction processing, the result is a seamless integration of the credit card transaction into the visitor's Web experience. At the time that the visitor places an order, ecBuilder Pro collects the visitor's credit card information after the visitor enters his or her name and address.

ecBuilder Pro processes the order "behind the scenes". By importing the .mec file which is attached to the order confirmation e-mail, the order information is automatically placed in the ecOrderDesk window and marked with the result of the credit card transaction—Payment Received, Payment Declined, Payment Preauthorized, etc..

The Visitor's Point of View

Knowing what your customers will experience when the make an order is important as you design your ecBuilder Pro catalog site. If you use Cardservice for processing credit card transactions, here's what an average user will experience:

1.	The visitor enters the catalog and adds an item to his/her basket.

2.	When the visitor is ready to order, he/she clicks the link to the shopping basket.

3.	In the Shopping Basket page, the visitor reviews the items and clicks "Order Now". The order page appears.

4.	The visitor reviews the order and the information on server encryption and clicks "Continue".

5.	Your ecBuilder site collects the visitor's name and address.

6.	The visitor selects the option to pay by credit card and enters his/her card information on the same page.

7.	The visitor clicks Continue and ecBuilder Pro notifies the visitor that the transaction is complete.

Behind the Scenes

Behind the scenes, the ecBuilder Pro order page sends via a secure SSL connection, the visitor's credit card information to Cardservice, which responds by sending the transaction record back to the server. The order and the results of the credit card transaction are automatically e-mailed to you (the merchant) for import into ecOrderDesk. As well, ecBuilder Pro generates a notification e-mail, which it sends to the customer.

For more information on Cardservice and obtaining a Cardservice account, see http://www.cardservice.com.


Working with the Cardservice Web site
Working with the Cardservice Web Sites

Cardservice is one of the Transaction Payment Gateway Providers directly supported by ecBuilder Pro. The company specializes in real-time credit card processing system for Internet Merchants. The system is easy to use, scalable, and available on numerous different platforms. With Member Accounts you can view detailed activities of your Merchant accounts on the Web using the ecOrderDesk’s Point-of-Sale functionality.

In addition to ecOrderDesk, Cardservice provides two web site tools which allow it’s merchant’s to monitor transaction activity and also perform Point-of-Sale transactions.  These are Merchant Reports and Tools and Virtual LinkPoint (VLP), respectively.

Cardservice Merchant Reports and Tools

The Cardservice Merchant Reports and Tools web site is where all ecBuilder Pro users who are using Cardservice International as their online credit card transaction processing company go to maintain their merchant accounts. Using an Internet browser to access this area, you, as a merchant, can query the Cardservice Transaction server database to access all of their online transaction information.

Logging Into the Merchant Reports and Tools

The Merchant Reports and Tools web site is accessed by going to the URL specified in the “Welcome to LinkPoint API” e-mail which is sent to the merchant after their application has been approved and their “store” has been provisioned. The merchant will be required to enter their Username and Password. The Username is also provided to them via the “Welcome to LinkPoint API” e-mail, but the merchant will have to call the 800 number provided to retrieve their Password. The site uses the Secure HTTP protocol to secure the Web pages and keep the account information private.

After Logging In

After a user has successfully logged in, the administration area is fully available to the merchant. The on-line help is available to assist in navigating and using the site.

Cardservice Virtual LinkPoint (VLP)

The Cardservice Virtual LinkPoint web site is where all ecBuilder Pro users who are using Cardservice International as their online credit card transaction processing company go to perform Point-of-Sale transactions

Logging Into the Virtual Linkpoint

The Virtual LinkPoint web site is accessed by going to the URL specified in the “Welcome to Virtual LinkPoint” e-mail which is sent to the merchant after their application has been approved and their “store” has been provisioned. The merchant will be required to enter their Username and Password. The Username is provided to them via the “Welcome the Virtual LinkPoint” and the “Welcome to LinkPoint API” e-mail, but the merchant will have to call the 800 number provided to retrieve their Password. The site uses the Secure HTTP protocol to secure the Web pages and keep the account information private.

After Logging In

After a user has successfully logged in, the VLP area is fully available to the merchant. The on-line help is available to assist in navigating and using the site. The merchant can also access the Reports and Tools site from VLP. In the “Welcome to Virtual LinkPoint” e-mail there is also a URL to a web-based VLP User’s Manual.