Docs
CyberSource is a payment gateway solution that allows you to safely accept payments across multiple sales channels, worldwide. You can integrate and use CyberSource as a payment gateway in Chargebee to effectively process your payments.
CyberSource is available for companies based in North America, Europe, Australia, and New Zealand. Contact the CyberSource team to confirm availability in your preferred countries.
Chargebee supports card payments and direct debit (ACH) payments made with CyberSource.
Due to recent world events, you may experience failures for payments originating from Russian financial institutions or instruments. We recommend reviewing guidelines issued by respective payment gateways for additional information.
CyberSource has two types of accounts - Sandbox and Live account. The CyberSource sandbox and live account can be integrated with the Chargebee test and live account respectively.
Listed below are the integration options available between Chargebee and CyberSource:
| # | Methodology | Description | PCI Requirements | 3DS supported? |
|---|---|---|---|---|
| 1 | Chargebee Checkout + CyberSource Gateway | Card information of the customers are collected by Chargebee's checkout and passed on to CyberSource. | Low (Your PCI compliance requirements are greatly reduced because of Chargebee's checkout. As a merchant using Chargebee's checkout, all you have to do is submit a Self Assessment Questionnaire to stay compliant.) |
Yes |
| 2 | Chargebee JS + Chargebee API + CyberSource Gateway | The card details are captured and tokenized on your side by CyberSource's javascript library and the token is sent to Chargebee. | Low (card details are tokenized by CyberSource) |
Yes |
| 3 | Chargebee JS | Chargebee's Hosted Card Components You will use Chargebee's Components to collect card details and Chargebee's temporary token. | Low |
Yes |
| 4 | Chargebee API + CyberSource Gateway | Collection of card information should be handled at your end and passed on to Chargebee via the API. Chargebee will route this card information to CyberSource. | High (card information will be collected by you directly, you will have to take care of PCI Compliance requirements) |
No For more info, contact support |
Following are the prerequisites for configuring the CyberSource gateway in your Chargebee site:
Refer to these steps for the information to be retrieved from your CyberSource account.
As explained in the prerequisites, certain key details are required to be entered in Chargebee as part of configuring the integration. Follow these steps to retrieve these details from your CyberSource account:
Merchant id: To get the merchant ID from your CyberSource account, log in to your CyberSource business account, and you can get the Merchant ID from the home page as shown in the below screenshot:
Shared Secret Key & Key: You need to generate the shared secret key from your CyberSource account, and you will retrieve the key as a part of the process.
Follow these steps to generate the shared secret key:
Log in to your CyberSource account, click Payment Configuration > Key Management.
On the Key Management page, click +Generate Key.
Make sure REST - Shared Secret is selected and click Generate key.
Both Key and Shared Secret are generated. Copy both the keys as you have to enter them in your Chargebee site.
Profile id: To get the profile id for your CyberSource account, you need to send an email to CyberSource support or the Account manager. Make sure you mention the id of a profile containing user-specific TMS configuration. This profile id is used to tokenize a payment method. Note: if you don't see any of the above options in your business account kindly contact the CyberSource team to enable it for your merchant ID.
For 3DS, you need to send an email to Cybersource support or the Account manager to get Payer Authentication / 3DS enabled in your account. After 3DS is enabled, follow these steps to get the 3DS credentials:
Log in to your CyberSource account, click Payment Configuration > Payer Authentication Configuration.
Copy the Org Unit ID, API identifier, and API Key and save them to be used in Chargebee.
Before starting with configuring CyberSource in Chargebee, follow these steps to enable mandatory fields under Checkout settings:
In your Chargebee site, go to Settings > Configure Chargebee > Checkout & Self-Serve Portal > Fields > Payments and enable the following fields as they are mandatory for card payments:
a. First Name
b. Last Name
c. All Address Fields
To enable these fields via Chargebee JS, learn more in this section.
To configure CyberSource in Chargebee, follow the below steps:
Step 1. Click Settings > Configure Chargebee > Payment Gateway > Add payment Gateway.
Step 2. Click CyberSource.
Step 3. Enter the Merchant ID, Key, Shared Key, Webhook Key, and Profile ID of your CyberSource account.
Step 4. Enter 3-D Secure credentials.
Step 5. Click Connect.
The Configure CyberSource page appears:
To update the Cards Settings for CyberSource, follow these steps:
Click the Manage link in the Cards section. The Cards Settings page is displayed. Configure the following settings based on your business requirements:
Allow Prepaid cards: Enabling this option allows your customers to use a prepaid card for their transactions.
Cards verification: This option is enabled by default to validate your customers' cards by doing a test authorization. An amount of $0 is deducted from the customers' card to collect mandatory information from Cybersource and for the integration to work properly. This amount will be refunded immediately. Cards that do not pass this validation, will not be added.
Always retain card information in CyberSource when the customer updates it: If you have configured multiple payment gateways in Chargebee, enabling this option stores the updated card information in CyberSource rather than the default gateway.
Enable 3D Secure: Check with your gateway whether Payment Authentication for 3DS is enabled for your account. If not, enable it at your gateway and then in Chargebee. Also, make sure you complete the SCA checklist in Chargebee before accepting 3DS payments. This is to ensure that you can recover failed payments easily, without compromising your revenue. Learn more about PSD2 and Strong Customer Authentication.
Display Card Logo for: Click the drop-down, and select the card brands for which you want to display logos, on your Checkout and Self-serve Portal pages. (This setting is only applicable for Single Page Checkout and Self-serve portal).
Click Save > Apply.
Sample card details to test various 3DS workflows in Chargebee Test Site
To test 3DS 2.0 Friction-flow:
To test 3DS 1.0 Friction-flow:
To test non-3DS/Frictionless-flow:
ACH transactions will not be supported if you are using Telecheck as the payment processor with Cybersource.
To enable ACH payments via CyberSource, follow these steps:
Cybersource and Chargebee support 100+ different currencies for charging customers across different geographical locations. If you intend to use Cybersource+Chargebee for your business, ensure that your transactional currencies are supported by both. Find the complete list of currencies supported by:
Integrating CyberSource with Chargebee using Chargebee.js opens up a seamless pathway to enhance your online payment processing capabilities. Through this integration, you can leverage the security and flexibility of CyberSource's payment services while harnessing the simplicity and customization options provided by Chargebee.js, resulting in a comprehensive solution for efficiently handling transactions and subscriptions.
CyberSource is supported through direct integration and via Spreedly while using Chargebee JS.
Using Chargebee Card Components , you can build a PCI-compliant payment collection component for your CyberSource payment gateway without compromising your application's theme and style. Learn more about how Card Components can be integrated for your CyberSource payment gateway using Chargebee JS.
