Boost recurring donations this giving season with the upsell prompt!Learn How >>

Setting up the CyberSource payment processor credentials

updated

In order to use the CyberSource payment processor, you will need input credentials into Soapbox that will be provided in your CyberSource account.

Important: CyberSource stops accepting Merchant ID and Transaction Security Key sign-in on October 7, 2026. Payments are signed with a P12 certificate from that date. If your site processes payments through CyberSource, see Upgrading your CyberSource connection to certificate authentication and contact Soapbox support. Your Transaction Security Key keeps working until your certificate is installed.

To obtain the proper credentials, follow these instructions from CyberSource for generating a security key for the SOAP Toolkit API. They are included here for your convenience as well:

These steps apply until your certificate is installed. They generate the credential CyberSource retires on October 7, 2026.

  1. Login to CyberSource
  2. Click Account Management
  3. Click Transaction Security Keys
  4. Click Security Keys for SOAP Toolkit API
  5. On the Security Keys for the SOAP Toolkit API page, click the Generate Key button
  6. Note the transaction key displayed in the text box. Per CyberSource: 

    "Because you will not see the key again after you leave the page, you must immediately copy or download the key to a safe location on your computer"

  7. You may enter this transaction key into your Soapbox site to use CyberSource

How you enter these credentials in Soapbox is determined by the version of the Soapbox administrator your site has: Soapbox Lightning, Soapbox Engage Classic, or Soapbox CMS Classic.

I have the Soapbox Lightning Administrator with...
  • Contextual menu with App Launcher waffle to the left of the navigation
  • White and blue color scheme with penguin avatar in upper right
  • Soapbox Engage User Account module at the top of the right column of the home page

screenshot-lightining-thumbnail.png
I have the Soapbox Engage Administrator with... I have the Soapbox CMS Administrator with...
  • Main menu with no drop down options
  • Home link in the main menu
  • Soapbox Engage User Account module at the top of the right column of the home page
  • Main menu with many drop down options
  • Extentions link in the main menu
  • Getting Help with Your Soapbox Site module at the top of the right column of the home page

For Soapbox sites using the Soapbox Lightning administrator:

  1. Login to your Soapbox administrator
  2. In the right column, click Payment Processor Settings
  3. For Payment Gateway, select CyberSource
  4. For Merchant ID, enter the information from your CyberSource account
  5. For Transaction Security Key, enter the information from your CyberSource account
  6. For Test Mode, select No, if you are using a CyberSource production account, or Yes, if you are using a CyberSource sandbox account for testing purposes
  7. Click Save Payment Processor Settings

Note: The Certificate Status row in this panel is read-only. When Soapbox support has installed your certificate, it shows the expiration date, the certificate fingerprint, and when the certificate was last verified. Until then it reads "No certificate installed."

For Soapbox sites using the Soapbox Engage Classic administrator:

  1. Login to your Soapbox administrator
  2. In the right column, click Payment Processor Settings
  3. For Payment Gateway, select CyberSource
  4. For Merchant ID, enter the information from your CyberSource account
  5. For Transaction Security Key, enter the information from your CyberSource account
  6. For Test Mode, select No, if you are using a CyberSource production account, or Yes, if you are using a CyberSource sandbox account for testing purposes
  7. Click Save Payment Processor Settings

Note: The Certificate Status row in this panel is read-only. When Soapbox support has installed your certificate, it shows the expiration date, the certificate fingerprint, and when the certificate was last verified. Until then it reads "No certificate installed."

For Soapbox sites using the Soapbox CMS Classic administrator:

  1. Login to your Soapbox administrator
  2. In the main menu, go to Extensions > Plugin Manager
  3. In the Plugin Manager, in the upper right for the drop down that says "- Select Type -", choose "payment-gateway"
  4. In the filtered list of plugins, disable any except Payment Gateway - CyberSource by clicking the icon in the Enabled column
  5. Enable Payment Gateway - CyberSource by clicking the icon in the Enabled column
  6. Click Payment Gateway - CyberSource
  7. In the right column, for Merchant ID, enter the information from your CyberSource account
  8. For Transaction Security Key, enter the information from your CyberSource account
  9. For Test Mode, select No, if you are using a CyberSource production account, or Yes, if you are using a CyberSource sandbox account for testing purposes
  10. Click Save

Note: Certificate Fingerprint, Certificate Expires and Certificate Last Verified are read-only. They are populated when Soapbox support installs your certificate. See Upgrading your CyberSource connection to certificate authentication.

Related: Upgrading your CyberSource connection to certificate authentication

Have more questions? Submit a request
Article is closed for comments.