Setting Up Cybersource for FoxyCart

  1. Set up your CyberSource account - http://www.cybersource.com/register/
  2. Login to 'Test Business Center' https://ebctest.cybersource.com/
  3. On the left nav click Account Management → Transaction Security Keys. Then click on the “Security Keys for the SOAP Toolkit API” link.
  4. Generate a new key by clicking the “Generate Key” button.
    1. If you don't see this option, there may be two options (one for SOAP, one for something else). Try the other setting.
  5. Copy the key that appears (and download it for safekeeping if desired).
  6. Login to your FoxyCart admin. Click the “payment” link under “STORE”. Set your payment method to Cybersource.com.
  7. Flip to the Live Server radio button. If it's disabled you'll need to “Start your FoxyCart subscription today!”.
  8. Enter your Merchant ID (which you use when you login to CyberSource) and the Transaction Key that you just copied.
  9. Click the “Update Payment Gateway” button.
  10. Get back to your CyberSource account. Click “Account Management” → “SmartAuth Settings”. Set your checkboxes to look like this:
    CyberSource CVN settings
    • UK users skip the above step. CVN is not available and is covered by the Decision Manager settings.
      Decision Manager Settings
    • Cybersource by default has already put in place basic fraud screening via the Decision Manager even in the basic set up package.
    • Don't worry. FoxyCart always sends the CVN unless the customer is using a saved card (or it's processing a subscription). This is very common; the first transaction between your store and your customer validates using the CVN, but subsequent transactions validate using other serives (like address verification).
  11. TEST. Your account may already be in test mode. Contact CyberSource support to make sure everything's ready to go.
  12. TEST MORE. Test with a real credit card and make sure everything (all the way up to the money actually getting deposited into your merchat account) works as expected.
    1. NOTE: Using a test card on a live account will generate account configuration errors. We're noting that here because this is unusual behavior. (Typically the cards would just be rejected with a normal “declined”-style error message.)

Payment Tokenization

In order to have an ability to charge a customer again you need to create a customer profile at CyberSource.

You will get the subscription ID as paySubscriptionCreateReply__subscriptionID in your data feed application. The customer profile will be created at CyberSource so you can access it using CyberSource Business Center.


Version 1.1

  1. Choose Cybersource.com (Payment Tokenization) as your payment gateway.
  2. Activate the option “Payment Token Required”.

Version 2.0+

  1. Choose Cybersource.com as your payment gateway.
  2. Activate the option “Payment Token Required”.


Obtaining a Test Account

Test Card Numbers

Important Notes and Caveats

User Notes and Experiences

If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We at FoxyCart reserve the right to edit or remove comments that don't add value to this page.

Site Tools