Configure > Payments > Gateways

CyberSource

The CyberSource® payment gateway has a more complicated configuration process.  You may need assistance from your system administrator to install the required software. To enable CyberSource, you must provide your Merchant Id. You will also need to have your transaction security key file generated from the CyberSource merchant interface.

All AbleCommerce payment gateway integrations offer full support for post-order processing.  This means that after an order is placed, you can authorize, capture, refund, and void transactions from the AbleCommerce order administration area.  

NOTICE:

CyberSource acquired Authorize.Net payment gateway which is documented separately.   

CyberSource Processing Features

AbleCommerce supports all the standard features of the payment gateway.  In addition, there are additional services such as recurring billing and fraud protection which can be added to your account.  For more information on the services and features available, visit CyberSource newwindow.gif

  • Authorize - where the cardholder's funds are verified as available and set aside for the pending transaction.  

  • Authorize Capture - where the cardholder's funds are verified and immediately transferred to the merchant.

  • Capture - a full or partial transfer of funds from the cardholder's pending authorization to the merchant.

  • Void Authorization - when the pending authorization of funds is canceled.  This does not refund a payment.

  • Refund - when funds have been transferred to the merchant, and a full or partial refund is returned to the cardholder.  

  • Recurring Billing - where the recurring billing feature within your gateway is initiated by AbleCommerce.  CyberSource maintains the billing and notifications after the initial order is placed.

At this time, multi-currency is not a supported feature of AbleCommerce's CyberSource integration.  All amounts will be in USD.

NOTE:

There may be additional features within your CyberSource account that have not been tested with  AbleCommerce.  If you enable unsupported features, you are doing so at your own risk.  

CyberSource Requirements

Important Update:  Effective 2/9/09, AbleCommerce 7.0.2 will integrate with CyberSource's SOAP Toolkit API.  This allows for compatibility with 64-bit Windows systems.  Please take special care when following the instructions below as some parts will only apply to older versions of AbleCommerce 7.

To use the CyberSource payment gateway, you must have a server running AbleCommerce software, in addition to the following:

  1. Install Microsoft Web Services Enhancements (WSE) 3.0.  It is a free download newwindow.gif from Microsoft's website.

NOTE:

You should install WSE 3.0 before installing AbleCommerce. However, if you need to install WSE 3.0 after AbleCommerce is installed, then you will need to backup the web.config file and replace it when finished.

  1. This step is only required for AbleCommerce versions prior to 7.0.2:
    Install the CyberSource Simple Order API Client for .NET 2.0. It is a free download newwindow.gif from CyberSource's website.

  2. This step is only required for AbleCommerce versions prior to 7.0.2:
    Obtain your encrypted security key file from CyberSource and place it in the AbleCommerce \App_Data\ folder.

    • The security key file name should be your Merchant Id followed by a .P12 extension. (e.g. abletest.p12)

    • It should be saved in the AbleCommerce \App_Data\ folder.

    • Make sure the file inherits permissions from the parent object.

  3. This step is only applicable to AbleCommerce versions prior to 7.0.2:
    If your key is installed properly, AbleCommerce will detect the presence of it in the \App_Data\ folder.

    cs_keyfound.gif

Enable CyberSource Payment Gateway

Before you begin, make sure that you have your CyberSource Merchant ID and certificate key file installed per instructions above, or have your transaction key ready.

AbleCommerce versions prior to 7.0.2 -> If you do not have an encrypted security key file, you can skip to the section below, "Generating a Key for the Simple Order API", for instructions on generating one from your CyberSource merchant account.

  1. From the Payment Gateways page, click the ADD GATEWAY button.  

  2. From the Add Gateway page, click the CYBERSOURCE button.

    cs_add.gif

  3. You will now be on the Add Gateway configuration page for Cybersource.

  4. In the field named Merchant Id, enter your CyberSource ID.  This value is case-sensitive.

    cs_step1.gif

  5. This step is only applicable to AbleCommerce version 7.0.2.
     Enter the Transaction Key in the field provided.  You can generate this key from the CyberSource merchant interface.  If you need help with this step, please see the section below, "Generating a Transaction Key for SOAP Toolkit API", for instructions.  

  6. Choose the type of Authorization Mode.  

    auth_mode.gif

    • Authorize: to request authorization without capturing funds at the time of purchase. You can capture authorized transactions through the order admin interface.

    • Authorize & Capture: to capture funds immediately at the time of purchase. You should not use this feature unless you are able to ship goods the same day of the sale.

  7. Choose the Gateway Mode.

    gway_mode_std.gif

    • Live Mode - used for processing live transactions with a production merchant account.

    • Test Mode - used for processing transactions with a test merchant account.

  8. Debug Mode is an optional feature and should only be enabled at the direction of AbleCommerce support.

    debug_mode.gif

  9. Scroll down to the bottom of the page and find the section called Payment Methods.

  10. Click the box next to all credit card payment methods that will use the CyberSource gateway.

    pay_methods.gif

  11. At the bottom of the page, click the SAVE button.

Preparing to Generate a Key using the Business Center

If you have an account through the Enterprise Business Center, skip to the next section "Preparing to Generate a Key using the Enterprise Business Center".

  1. Go to CyberSource's website and login to the Business Center.

  2. From the left column menu, go to the Settings > Account Info page.

  3. This step is only applicable to AbleCommerce versions prior to 7.0.2.
    In the Process Payment Transactions section, select Simple Order API.

  4. In the Process Payment Transactions section, select SOAP Toolkit API.

  5. In the Shopping Cart section, select Other.

  6. Scroll to the bottom of the page and click Update.

  7. From the left column menu, to the Transaction Security Keys page.

  8. Skip to the version applicable instructions below for "Generating a Key for...".

Preparing to Generate a Key using the Enterprise Business Center

  1. Go to CyberSource's website and login to the Enterprise Business Center.

  2. From the left column menu, go to the Account Management > Transaction Security Keys page.

  3. Proceed to the version applicable instructions below for "Generating a Key for...".

Generating a Transaction Key for SOAP Toolkit API

This section is only applicable to AbleCommerce version 7.0.2.

  1. You should be on the Account Management > Transaction Security Keys page.

    cs_keypage_soap.gif

  2. Click the link "Security Keys for the SOAP Toolkit API".

  3. Click the Generate Key button.  The next page will take a moment to load.

  4. Your new key appears in the box below. Because you will not see the key again after you leave this page, you must immediately copy or download the key to a safe location on your computer.

  5. To return to the list of keys, click Transaction Security Keys in the navigation pane.

  6. This key needs to be copied into the Transaction Key field of the AbleCommerce CyberSource configure gateway page.

Generating a Key for the Simple Order API

This section is only applicable to AbleCommerce versions prior to 7.0.2.

  1. You should be on the Account Management > Transaction Security Keys page.

    cs_keypage.gif

  2. Click the link "Security Keys for the Simple Order API".

  3. Click the Generate Key button.  The next page will take a moment to load.

    NOTE:

    The security applet requires version 1.4.1 (or later) of Sun's Java plugin and will not run properly on earlier versions. If the applet fails to run, visit SUN Microsystems to download the latest version of the Java Runtime Environment for your browser.

  4. In the lower right corner, below the empty field, click the Generate Certificate Request button.

    cs_generate.gif

  5. Wait a few moments for the request to be generated.  When it's finished, you can select a location on your local disk to save the P12 file.  

  6. If no errors occur, your browser will prompt you to save your new key. Be sure to store your key in a safe place. If you do not protect your security key, the security of your CyberSource account may be compromised.   

  7. To return to the list of keys, click Transaction Security Keys in the navigation pane.

  8. This key needs to be placed in the AbleCommerce \App_Data\ folder.

Testing with CyberSource

  1. Edit the CyberSource gateway configuration page in AbleCommerce.

  2. Change the Gateway Mode to Test.

  3. At the bottom of the page, click the SAVE button.

  4. You can use a Visa card number of "4111111111111111" to run a test transaction.

  5. Be sure to change the Gateway Mode to Live before processing real credit card transactions.

 

 
Related Topics

Configure > Payment Methods
Create your own payment methods that you accept.

Manage > Orders > Payments (Credit Card Transactions)
Process credit card payments and refunds online.

Manage > Orders > Payments (Offline Payments)
Record other types of payments.