Backend Integration

To connect the CyberSource plugin to your instance of ep-commerce, add the plugin to Cortex, Integration Server, and Commerce Manager, download any dependencies and start the webapps.

Self-Managed Commerce 8.4 or later

Define the version property

Add the following property definition to the extensions/pom.xml file:

<ep.plugin.payment.cybersource.version>2.0.0.0a1b7f3186</ep.plugin.payment.cybersource.version>

Add the plugin to Cortex

1. In the ep-commerce directory, go to extensions/cortex/ext-cortex-webapp/pom.xml file.

2. Search for the copy-plugin-artifacts execution node at <project> --> <build> --> <plugins> --> <plugin> (maven-dependency-plugin) --> <executions> --> <execution> (copy-plugin-artifacts) and add the following to the list of <configuration> --> <artifactItems>:

   <artifactItem>
       <groupId>com.elasticpath.plugins</groupId>
       <artifactId>cybersource-payment-provider-plugin</artifactId>
       <version>${ep.plugin.payment.cybersource.version}</version>
   </artifactItem>
   

Add the plugin to Commerce Manager

1. In the ep-commerce directory, go to the extensions/cm/ext-cm-modules/ext-cm-webapp/pom.xml file.

2. Search for the copy-plugin-artifacts execution node at <project> --> <build> --> <plugins> --> <plugin> (maven-dependency-plugin) --> <executions> --> <execution> (copy-plugin-artifacts) and add the following to the list of <configuration> --> <artifactItems>:

   <artifactItem>
       <groupId>com.elasticpath.plugins</groupId>
       <artifactId>cybersource-payment-provider-plugin</artifactId>
       <version>${ep.plugin.payment.cybersource.version}</version>
   </artifactItem>
   

Add the plugin to Integration Server

1. In the ep-commerce directory, go to the extensions/integration/ext-integration-webapp/pom.xml file.

2. Search for the copy-plugin-artifacts execution node at <project> --> <build> --> <plugins> --> <plugin> (maven-dependency-plugin) --> <executions> --> <execution> (copy-plugin-artifacts) and add the following to the list of <configuration> --> <artifactItems>:

   <artifactItem>
       <groupId>com.elasticpath.plugins</groupId>
       <artifactId>cybersource-payment-provider-plugin</artifactId>
       <version>${ep.plugin.payment.cybersource.version}</version>
   </artifactItem>
   

Self-Managed Commerce 8.3

Define the version property

Add the following property definition to the extensions/pom.xml file:

<ep.plugin.payment.cybersource.version>2.0.0.0a1b7f3186</ep.plugin.payment.cybersource.version>

Add the plugin to Cortex

1. In the ep-commerce directory, go to extensions/cortex/ext-cortex-webapp/pom.xml file.

2. Add the following maven-dependency-plugin call to <project> --> <build> --> <plugins>:

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-dependency-plugin</artifactId>
       <executions>
           <execution>
               <id>copy-plugin-artifacts</id>
               <phase>prepare-package</phase>
               <goals>
                   <goal>copy</goal>
               </goals>
               <configuration>
               <outputDirectory>${war-plugin-directory}</outputDirectory>
                   <artifactItems>
                       <artifactItem>
                           <groupId>com.elasticpath.plugins</groupId>
                           <artifactId>cybersource-payment-provider-plugin</artifactId>
                           <version>${ep.plugin.payment.cybersource.version}</version>
                       </artifactItem>
                   </artifactItems>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

note

The plugin section above needs to be defined as the last plugin in the plugins section.

Add the plugin to Commerce Manager

1. In the ep-commerce directory, go to the extensions/cm/ext-cm-modules/ext-cm-webapp/pom.xml file.

2. Add the following maven-dependency-plugin call to <project> --> <build> --> <plugins>:

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-dependency-plugin</artifactId>
       <executions>
           <execution>
               <id>copy-plugin-artifacts</id>
               <phase>prepare-package</phase>
               <goals>
                   <goal>copy</goal>
               </goals>
               <configuration>
               <outputDirectory>${plugin-directory}</outputDirectory>
                   <artifactItems>
                       <artifactItem>
                           <groupId>com.elasticpath.plugins</groupId>
                           <artifactId>cybersource-payment-provider-plugin</artifactId>
                           <version>${ep.plugin.payment.cybersource.version}</version>
                       </artifactItem>
                   </artifactItems>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

note

The plugin section above needs to be defined as the last plugin in the plugins section.

Add the plugin to Integration Server

1. In the ep-commerce directory, go to the extensions/integration/ext-integration-webapp/pom.xml file.

2. Add the following maven-dependency-plugin call to <project> --> <build> --> <plugins>:

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-dependency-plugin</artifactId>
       <executions>
           <execution>
               <id>copy-plugin-artifacts</id>
               <phase>prepare-package</phase>
               <goals>
                   <goal>copy</goal>
               </goals>
               <configuration>
               <outputDirectory>${war-plugin-directory}</outputDirectory>
                   <artifactItems>
                       <artifactItem>
                           <groupId>com.elasticpath.plugins</groupId>
                           <artifactId>cybersource-payment-provider-plugin</artifactId>
                           <version>${ep.plugin.payment.cybersource.version}</version>
                       </artifactItem>
                   </artifactItems>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

note

The plugin section above needs to be defined as the last plugin in the plugins section.

Build the project

Build all Self-Managed Commerce modules with the new configuration.

• In the root ep-commerce folder, run the following command:

  mvn clean install -DskipAllTests

Start the webapps

1. Start ActiveMQ:
   • In the extensions/activemq-broker folder, run mvn tomcat8:run-war.
2. Start Cortex:
   • In the extensions/cortex/ext-cortex-webapp folder, run mvn tomcat8:run-war.
3. Start Integration Server:
   • In the extensions/integration/ext-integration-webapp folder, run mvn tomcat8:run-war.
4. Start Commerce Manager:
   • In the extensions/cm/ext-cm-modules/ext-cm-webapp-runner folder, run mvn clean tomcat8:run-war.