You are here: The ProductCart Encyclopedia » ProductCart User Guide » CyberSource
CyberSource
To use CyberSource with your ProductCart-powered store, you will need to ensure that the Web server that is hosting your store has the necessary software installed. Information on the software that needs to be installed on the server and on the system requirements to run it can be found at the following URL:
http://apps.cybersource.com/cgi-bin/pages/dev_kits.cgi?kit=ASP/All_Platforms
If you are hosting your store with a third-party, contact your Web hosting company and ask them if they support CyberSource, or if they can install the corresponding software on their server. Provide them with the link mentioned above so that they may download the software and documentation.
Once you have ensured that your Web server can support CyberSource, follow these steps to use CyberSource with your ProductCart store.
First, you will need to obtain a special file containing “security keys” from CuberSource. To do so log into the CyberSource Business Center. Select the menu item “ Account Management” and then “Transaction Keys” from the left navigation menu, then you will need to click on Security Keys for the Simple Order API (see image below). You will then need to click on Generate Key” button.
You will be taken to the next screen which uses a Java Applet to generate the key and send it to your local system. You will see a prompt asking if you trust the signed applet, click “yes” to this Note: it may take several minutes before the Applet loads.
Once loaded, click on the “Generate Certificate Request” button. Again, this task might take a little bit of time to complete. Once completed, it will prompt you to save the file to your local system. Save the file to your desktop, and then upload it to the pcadmin folder in your ProductCart installation. Note that you likely renamed this folder when you installed ProductCart, based on the security recommendations mentioned elsewhere in this user User Guide.
The security keys file carries a *.p12 extension. Make sure not to alter the file extension. The CyberSource software installed on your Web server will look for that file extension to automatically locate the security keys file once it has been uploaded to your Web server, in the directory mentioned above.
You can now return to the ProductCart Control Panel and finish configuring your CyberSource settings. Follow the instructions below to do so.
Select: Payment Options – Add New Options – Real-time credit card processing…. To load the Add Real-time Payment Option form. Select CyberSource from the list of available payment gateways, and you will be taken to the section of the page where you can configure the following settings:
- Merchant ID: Enter your Merchant ID that was provided to you when you set up your account.
- Keys Directory: You MUST copy your Security Keys file (*.p12) to the folder listed here. For information on how to obtain a Security Keys file, please see earlier in this section.
- Transaction Type. Can be set as either “Sale” or “Authorize Only”. Choose “Sale” to both authorize and capture funds (the credit card is debited). Choose “Authorize Only” to authorize the credit card, but not capture the funds. When an order is received,
ProductCart considers the order processed when funds have been captured, pending when funds have been authorized, but not captured (payment has not been collected yet).
- Currency: USD only.
- Accepted Credit Cards: Specify the credit card types that are accepted on your store.
- Require CVV: For added security, you can require customers to enter their card’s security code (CVV) on the payment details form.
- Accept Checks: Just added the ability to accept checks with CyberSource.
- All eCheck orders are automatically considered “Processed” by ProductCart, as the order amount is always debited to the customer's bank account. If for any reasons you would like eCheck orders to be considered “Pending”, use this option. Should eCheck orders be considered “Pending”? Yes or No
- Test Mode: Unlike with other payment gateways, you will not see an Enable Test Mode feature when activating CyberSource. This is because your account is automatically set to “test mode” until you specifically ask CyberSource to switch to “live mode”. According to
CyberSource’s documentation: “[…] when you are ready to enable your cybersource_id on the CyberSource production systems, please submit a request through our Knowledge Base at http://cybersource.custhelp.com/. CyberSource will send you a confirmation once your cybersource_id is ready for processing production transactions.”
- Processing Fee: You can choose whether to charge an additional transaction fee using thProcessing Fee field. The fee can be either a flat charge or a percentage of the total order amount.
- Payment Name: You can change the description that is shown to your customers during echeckout. For example, you could change “Credit Card” to “Visa/MasterCard”.
- ProductCart uses the CyberSource Simple Order API 2.0.0 for ASP.
- The name of the DLL’s that need to be installed on the Web server is CybsWSSecurity.dll and CyberSourceWS.dll.
- They can be downloaded together with related documentation from the following URL:
http://apps.cybersource.com/cgi-bin/pages/dev_kits.cgi?kit=ASP/All_Platforms
Trace: » CyberSource


