BroadleafCommerce currently offers credit card payment services through our implementation of the CyberSource SOAP payment API. Secure communication to the vendor's remote API is negotiated internally by BroadleafCommerce according to CyberSource's specifications. Please review the following prerequisites before proceeding
Note - This integration method requires a high level of PCI compliance because it is necessary for credit card information to be passed through your servers which are then relayed to CyberSource via the SOAP API. If you are looking to avoid most PCI concerns, consider looking into the [[CyberSource Silent Post Module]]
Note - the steps for establishing an account and setting up your pom.xml's are the same as Secure Acceptance SOP. You do not need to repeat them twice if you are using CyberSource for both Secure Acceptance SOP and SOAP API. However, the key generation and added properties are different between the two methods.
Once you have established an account with CyberSource, you should begin to setup your environment to work with Broadleaf Commerce CyberSource support. The first step is to make Broadleaf Commerce aware of your CyberSource account credentials. This is accomplished through environment configuration (see [[Runtime Environment Configuration]]).
Note: If you have already setup Secure Acceptance SOP, you do not need to make any pom changes
Once you have established an account with CyberSource and configured your settings in the Business Center so that you have an active account,
begin by including the CyberSource Module dependency to your Broadleaf application's parent pom.xml.
<dependency> <groupId>com.broadleafcommerce</groupId> <artifactId>broadleaf-cybersource-payment</artifactId> <version>1.0.0-GA</version> <type>jar</type> <scope>compile</scope> </dependency>
Make sure to include the dependency in your CORE pom.xml as well:
<dependency> <groupId>com.broadleafcommerce</groupId> <artifactId>broadleaf-cybersource-payment</artifactId> </dependency>
The next step is to make Broadleaf Commerce aware of your CyberSource account credentials.
This is accomplished through environment configuration (see [[Runtime Environment Configuration]]).
Broadleaf allows you to create your own property files per environment (e.g. common.properties, local.properties, development.properties, integrationdev.properties, integrationqa.properties, staging.properties, and production.properties)
You will need to enter the following key/value pairs in the appropriate locations and replace the "?" with your Cybersource account details:
You can also store these configs in the Database by utilizing the
blSystemPropertiesService. See the java docs for more details.