Elastic Path Commerce Plugin 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.

Elastic Path 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>1.2.0.ec8a78c0a4</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>
   

Elastic Path Commerce 8.0 to 8.3

Define the version property

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

<ep.plugin.payment.cybersource.version>1.2.0.ec8a78c0a4</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 Elastic Path 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.