Introduction

Welcome to the Intershop Computop Service Connector. The service connector adds Computop payment methods to your Intershop installation.

This document provides important product information, including version information and dependencies. It also outlines the basic setup and configuration steps.

References

• Concept - Payment Framework
• Cookbook - Payment
• Concept - Intershop Reference Payment Services

Version Information and Dependencies

This delivery and the accompanying documentation are valid for the following combinations of software versions:

The package includes the following cartridges:

• ac_payment_computop

The Computop Service Connector 4.5 is based on the new Payment API introduced in IS 7.6.

Supported Application Types

The Computop Service Connector can be used for the following application types:

Setup

This section outlines the basic setup and configuration steps, including

Precondition

The package is available via Intershop's Public Nexus.

• A set up and configured CI environment
  See Cookbook - Setup CI Infrastructure for details.
  See Concept - Continuous Delivery Tools (valid to 7.10) for basic information about Continuous Integration.
• A running Intershop Commerce Management 7.6, 7.7, 7.8, 7.9, 7.10 installation that matches the system requirements
• Knowledge of how to add the delivered artifacts to the continuous integration environment
• Knowledge of how to deploy to a test or production environment

Setting Up the Assembly

To add the Computop Service Connector into your Intershop 7 system, there are two options:

• Incorporating the cartridge into an already existing assembly in the build.gradle file of the assembly. To do so, add:

  cartridges {     
          def computopPaymentProvider = [
              'ac_payment_computop'
          ]
          include (*(computopPaymentProvider.collect {"com.intershop.services.payment_computop:$it:4.7.2"}), in: [development, test, production]) 
  ...
          order = listFromAssembly(<yourAssembly>) + computopPaymentProvider
  }

  For details about adding components to an assembly, see Recipe: Add Cartridges to an Assembly.

• Alternatively, you can create a new assembly inheriting from an Intershop CM based assembly. For details about creating a new assembly, see Recipe: Create a New Assembly Inheriting From an Existing Assembly.

For details about managing assembly artifacts, see:

• Concept - Gradle Assembly Tools
• Reference - Gradle Assembly Tools
• Cookbook - Gradle Assembly Tools (valid to 7.8)

Defining File-Based Configurations

Before deploying the new assembly to a test or production environment, you may have to adjust some file-based configurations required by the Computop Service Connector.

The Computop Service Connector requires the following settings:

According to Recipe: Change Deployed File Content With Filters this setting has to be overridden within <IS_SHARE>/system/config/cartridges/ac_payment_computop.properties.

For details about adding new configuration files, see Recipe: Deploy Custom Files.

Deploying the Assembly

After creating and appropriately configuring the assembly, you must deploy it to the intended target environment.

For details about deploying an assembly, see Recipe: Run the Deployment (Initial Installation / Upgrade / Downgrade).

Customization

Changing the Values of Parameters Sent to Computop

Since version 4.4.1 of the connector it is possible to modify the values of some of the parameters sent to Computop. Those parameters are TransID, RefNr, PayID and ReqID.

To provide custom values of those parameters in one of the payment methods (e.g., Alipay):

1. Create a new class:

   CustomAlipayRequestParamsProvider

   public class CustomAlipayRequestParamsProvider implements Function<RequestParamContext, String>
   {
       @Override
       public String apply(RequestParamContext paramContext)
       {
   		switch(paramContext.getParamName())
           {
               case "RefNr": ...
   			...
   			default: return null;
   		}
       }
   }

   You retrieve the parameter name from the RequestParamContext class. This class also provides the current Payable and PaymentContext objects, which could help you generate a value for the parameter.

   If you wish to provide values only for a subset of the 4 supported parameters, return null for the rest - this way the default to the connector value will be used.
   
   

2. Bind your class in a custom Guice Module. In this case something like this:

   bind(new TypeLiteral<Function<RequestParamContext, String>>()
   {
   }).annotatedWith(AlipayRequestParamsProvidier.class.getAnnotation(Named.class))
                .to(CustomAlipayRequestParamsProvider.class).in(Singleton.class);

3. Define this custom Guice Module as global.overrideModules in the associated resources file as described in Concept - Dependency Injection and ObjectGraphs.

Configuration

This section outlines the required post-deployment configuration steps, including

Adjusting Firewall Settings

Adjust your firewall settings to allow bidirectional HTTP and HTTPS traffic between the Intershop 7 and Computop systems.

Applying UI-Based Configuration

The Computop Service Connector requires some post-deployment configurations in the Organization Management application and in the Commerce Management application.

For details about enabling a payment service, see - Recipe: Enable a Payment Service.

Assign Payment Services to a Sales Organization

Create a Managed Payment Service

The table below lists Computop-specific settings for configuring the payment service.

Configure the Payment Methods

Localization

The Computop Service connector provides English and German localization files for payment-specific input field labels, error messages etc.

You can find the existing localization files here: <IS.INSTANCE.SHARE>/system/cartridges/ac_payment_computop/release/localizations.

For details about localization, see:

• Concept - Localization
• Cookbook - Localization (valid to 7.9)

Feature Overview

Payment Methods

The Computop service connector adds the following payment methods to your Intershop 7 system:

* only available if the corresponding payment method's Capture Mode is set to "manual" or "timed".

** Alipay Cancel is only available to the customer in the storefront and actually executes a full refund.

Payment Management Options

Data Handling

The following table describes transmitted data by the Computop Service Connector from ICM to Computop during the payment process:

Limitations

PayPal with Multiple Shipping Buckets

PayPal is not available for baskets with multiple shipping buckets.

Credit Card with Order Approval Service

Please be aware that Computop Credit Card uses redirect after checkout. Intershop's current demo shop inSPIRED does not support a redirect after checkout if an order approval service in channel type intershop.SMBResponsive is enabled.

Credit Card with IPv6 Addresses

The IP Zones feature requires an IPv4 address on the customer's side. In case the customer has an IPv6 address, the payment method Credit Card will not be displayed on the payment page.

Credit Card Timed Capture When Server Is Shut Down

Scheduled timed captures (with delay), which were not yet processed when the server was shut down for some reason, will not be captured automatically. These payments must be captured manually.

Changelog

Version COMPUTOP/4.7.2

• New Feature: added support for logging mechanism in ICM 7.10

Version COMPUTOP/4.7.1

• New Feature: COMPUTOP-232 Implement 3D Secure 2.0 for Credit Card
• Fix: COMPUTOP-228 Parameters "template" and "language" are transmitted in the unencrypted part of the redirect URL

Version COMPUTOP/4.6.3

• Fix: COMPUTOP-215, COMPUTOP-216 Trim amounts to 2 digits behind the comma as requested by COMPUTOP

Version COMPUTOP/4.6.2

• Fix: COMPUTOP-101 Handover of localization parameter from ICM to PSP
• Fix: COMPUTOP-103 Missing German localization added

Version COMPUTOP/4.6.0

• New Feature: Computop is now available for Intershop Commerce Management 7.8 and 7.9
• New Feature: [ISPAYCON-25] - Integrate giropay and Direct Debit

Version COMPUTOP/4.5.1

• Fix: COMPUTOP-89 - Computop Payment with Giftcards involved transfers wrong amount for authorize - Computop Payment with Giftcards involved transfers wrong amount for authorize
• New underlying 7.7 version: 7.7.4.9

Version COMPUTOP/4.5.0

• New Feature: [COMPUTOP-74] - Take over PayPal Express' invoice address
• New Feature: [COMPUTOP-82] - Provide possibility to easily override parameters sent to COMPUTOP

Version COMPUTOP/4.4.0

• New Feature: [COMPUTOP-43] - Integrate ChinaPay
• New Feature: Computop is now available for Intershop Commerce Management 7.8

Version COMPUTOP/4.3.1

• New Feature: [COMPUTOP-56] - Computop PayPal Express payment method was added

Version COMPUTOP/4.2.0

• New Feature: [COMPUTOP-55] - Computop PayPal Standard payment method was added

Version COMPUTOP/4.1.3

• New Feature: Computop is now available for Intershop Commerce Management 7.7
• New Feature: [COMPUTOP-1] - Add Parameter <EtiId>
• Fix: COMPUTOP-64 - Anonimous checkout not possible with Computop Credit Card - Anonimous checkout not possible with Computop Credit Card

Version COMPUTOP/4.1.1

• New Feature: [COMPUTOP-31] - Fully migrated Computop Credit Card to the new Payment API
• New Feature: [COMPUTOP-32] - Added Computop Alipay as additional payment method
• Fix: COMPUTOP-60 - Incorrect naming of the ISML extension file -  Incorrect naming of the ISML extension file (this bug may influence the an assembly with multiple payment methods installed. If only Computop is installed this is not an issue)

Version COMPUTOP/4.0.2

• Fix: ISPAY-962 - Computop Payment Log messages are missing in B2B application - Computop Payment Log messages are missing in B2B application

Version COMPUTOP/4.0.1

• Fix: ISPAY-934 - Computop: configuration values do not match with documentation - Computop: configuration values do not match with documentation
• Fix:ISPAY-935 - Computop: missing return values in payment history - Computop: missing return values in payment history
• Fix: ISPAY-936 - Computop: Checkout fails with capture option Timed - Computop: Checkout fails with capture option "Timed"

Version COMPUTOP/4.0.0

• [ISPAY-792] - Migrate Computop to IS 7.6