Document Tree
Document Properties
Kbid
2997K4
Last Modified
18-Feb-2022
Added to KB
06-Oct-2021
Public Access
Everyone
Status
Online
Doc Type
Release Notes
Product
  • ICM 7.10
  • Computop
Public Release Note - Computop Service Connector 5

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

Version Information and Dependencies

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

IntershopComputop Service Connector
7.10.31.x + (Tomcat 9)5.0.0

Computop Connector version 5.0.0 features the same functionality as Computop Connector 4.7.2 to facilitate migration from ICM 7.10.30 - to 7.10.31+.

The next table provides information about the cartridges included in the package. Not all of these cartridges are required.

Cartridge

Description

Required

ac_payment_computopIncludes all base functionality and business logic which is used.(tick)
as_responsive_computop

Enables the COMPUTOP payment connector for the following application types:

  • intershop.B2CResponsive
  • intershop.SMBResponsive

The cartridge is optional, can be downloaded separately from Intershop Product Calendar and may be included if the project uses the responsive starter store. Unzip the file to your multi-project folder next to your responsive source files. It could be skipped if the custom project does not support these application types or COMPUTOP is not required in these application types.

(error)
app_sf_responsive_computop

Includes some additional functionality which is relevant for the responsive storefront reference application only, e.g., the integration of the hosted payment pages of the credit card.

The cartridge is optional, can be downloaded separately from Intershop Product Calendar and may be included in case the project is based on the responsive storefront reference application. Unzip the file to your multi-project folder next to your responsive source files. The referenced cartridge app_sf_responsive may be renamed in the project and has to be referenced in the build.gradle file with the customized naming again.

(error)

The Computop Service Connector 5.+ is based on the Payment API introduced in IS 7.6.

The sources for as_responsive_computop and app_sf_responsive_computop are available here

...YOUR_REPOSITORY.../releases/com.intershop.public.source/s_payment_computop/5.0.0/zips/s_payment_computop-zip-src-5.0.0.zip


Supported Application Types

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

Application TypeApplication Type IDDescription
B2C WebShopintershop.B2CResponsiveBusiness to Consumer Channel
SMB WebShopintershop.SMBResponsiveBusiness to Business Channel

Setup

This section outlines the basic setup and configuration steps, including

Note

Managing and deploying the Computop Service Connector requires a continuous integration environment being set up and configured as described in Cookbook - Setup CI Infrastructure.

Precondition

The package is available via Intershop's Public Nexus.

Prerequisites are:

  • 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.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, perform the following steps. 

    1. Add the following in the build.gradle file of the assembly:

      build.gradle
              
      ...
       
      cartridges {
              def storefrontCartridges = [
                  'app_sf_responsive',
                  'app_sf_responsive_cm',
                  'app_sf_responsive_b2c',
                  'app_sf_responsive_smb',
                  'as_responsive',
                  'app_sf_responsive_b2b',
                  'app_sf_responsive_costcenter',
                  'as_responsive_b2b',
      // these are the two cartridges, which we delivered in source code and you have to add these files to your responsive source project
                   'as_responsive_computop',
                  'app_sf_responsive_computop'
      
                 ]
              include(*(storefrontCartridges.collect { project(":$it") }), in:[development, test, production])
      
      ...
      
           
              def computopPaymentProvider = [
                  'ac_payment_computop',
      
              ]
              include (*(computopPaymentProvider.collect {"com.intershop.services.payment_computop:$it"}), in: [development, test, production]) 
      ...
              order = listFromAssembly(<yourAssembly>) + computopPaymentProvider
      }
    2. Adapt the app_sf_responsive_computop/build.gradle file in the following way:

      app_sf_responsive_computop/build.gradle file
      apply plugin: 'static-cartridge'
      apply plugin: 'com.intershop.gradle.isml'
      
      intershop
      {
          displayName = 'Adapter Cartridge for Computop Payment'
          packages {
              cartridge {
                  srcDir(isml2classMain)
              }
          }
      }
      
      dependencies 
      {
          //compile project(':ac_payment_computop') --> will be replaced by
           compile group: 'com.intershop.services.payment_computop', name: 'ac_payment_computop'
      }
    3. Adjust the file as_responsive_computop/build.gradle in a similar way:

      as_responsive_computop/build.gradle file
      apply plugin: 'static-cartridge'
      
      intershop 
      {
          displayName = 'As_responsive_computop'
          staticLibs = fileTree(dir: staticCartridgeLibFolder, include: '*.jar')
      }
      
      dependencies {
          //compile project(':ac_payment_computop') --> will be replaced by
           compile group: 'com.intershop.services.payment_computop', name: 'ac_payment_computop'
          compile project(':app_sf_responsive_computop')
      }
    4. Insert the following lines into the file intershopBuild.version:

      intershopBuild.version
      com.intershop.services.payment_computop:ac_payment_computop = 5.0.0
  • Alternatively, you can create a new assembly inheriting from an ICM-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:

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:

PropertyDescriptionValue
intershop.payment.computop.paygateThe base URL to the Computop paygateDefault value is https://www.computop-paygate.com/
intershop.payment.COMPUTOP_CREDITCARD.currenciesDefines which currencies are configurable for Computop Credit Card. Default: * (all currencies)Comma-separated list, e.g., EUR, USD

intershop.payment.COMPUTOP_CREDITCARD.success_pipeline

A pipeline to be called after a successful payment at the Computop systemComputopCreditCardRedirect-Success

intershop.payment.COMPUTOP_CREDITCARD.success_b2b_pipeline

A pipeline to be called after a successful payment at the Computop system for B2BComputopCreditCardRedirect-SuccessB2B

intershop.payment.COMPUTOP_CREDITCARD.failure_pipeline

A pipeline to be called after some kind of failure occurred during payment at the Computop systemComputopCreditCardRedirect-Failure

intershop.payment.COMPUTOP_CREDITCARD.failure_b2b_pipeline

A pipeline to be called after some kind of failure occurred during payment at the Computop system for B2BComputopCreditCardRedirect-FailureB2B
intershop.payment.COMPUTOP_CREDITCARD.notify_pipelineA pipeline to be called when the notification mechanism is used to communicate with Computop systemComputopCreditCardRedirect-Notify
intershop.payment.COMPUTOP_CREDITCARD.delayed_capture.poolsizeA number of simultaneous unprocessed delayed captures to be supported by the serverA number - default is 100000
intershop.payment.COMPUTOP_ALIPAY.currenciesDefines which currencies are configurable for Computop Alipay. Default: EUR, USD, CNYComma-separated list, e.g., EUR, USD

intershop.payment.COMPUTOP_ALIPAY.success_pipeline

A pipeline to be called after a successful payment at the Computop or Alipay systemsComputopAlipayRedirect-Success
intershop.payment.COMPUTOP_ALIPAY.failure_pipelineA pipeline to be called after some kind of failure occurred during payment at the Computop or Alipay systemsComputopAlipayRedirect-Failure
intershop.payment.COMPUTOP_ALIPAY.notify_pipelineA pipeline to be called when the notification mechanism is used to communicate with Computop or Alipay systemsComputopAlipayRedirect-Notify
intershop.payment.COMPUTOP_PAYPAL.success_pipelineA pipeline to be called after a successful payment at the Computop or PayPal systemsComputopPayPalRedirect-Success
intershop.payment.COMPUTOP_PAYPAL.failure_pipelineA pipeline to be called after some kind of failure occurred during payment at the Computop or PayPal systemsComputopPayPalRedirect-Failure
intershop.payment.COMPUTOP_PAYPAL.notify_pipelineA pipeline to be called when the notification mechanism is used to communicate with Computop or PayPal systems

ComputopPayPalRedirect-Notify

intershop.payment.COMPUTOP_PAYPAL_EXPRESS.success_pipelineA pipeline to be called after a successful payment at the Computop or PayPal systemsComputopPayPalExpressFastCheckout-Success
intershop.payment.COMPUTOP_PAYPAL_EXPRESS.failure_pipelineA pipeline to be called after some kind of failure occurred during payment at the Computop or PayPal systemsComputopPayPalExpressFastCheckout-Failure
intershop.payment.COMPUTOP_PAYPAL_EXPRESS.notify_pipelineA pipeline to be called when the notification mechanism is used to communicate with Computop or PayPal systemsComputopPayPalExpressFastCheckout-Notify
intershop.payment.COMPUTOP_CHINAPAY.currenciesDefines which currencies are configurable for Computop ChinaPay. Default: CNY. For the usage of ChinaPay, CNY is mandatory.Comma-separated list, e.g., CNY

intershop.payment.COMPUTOP_CHINAPAY.success_pipeline

A pipeline to be called after a successful payment at the Computop or ChinaPay systemsComputopChinaPayRedirect-Success
intershop.payment.COMPUTOP_CHINAPAY.failure_pipelineA pipeline to be called after some kind of failure occurred during payment at the Computop or ChinaPay systemsComputopChinaPayRedirect-Failure
intershop.payment.COMPUTOP_CHINAPAY.notify_pipelineA pipeline to be called when the notification mechanism is used to communicate with Computop or ChinaPay systemsComputopChinaPayRedirect-Notify
intershop.payment.COMPUTOP_GIROPAY.currenciesDefines which currencies are configurable for Computop giropay. Default: EUR, USD, CNYComma-separated list, e.g., EUR, USD, CNY
intershop.payment.COMPUTOP_Giropay.success_pipelineA pipeline to be called after a successful payment at the Computop or giropay systemsComputopGiropayRedirect-Success
intershop.payment.COMPUTOP_Giropay.failure_pipelineA pipeline to be called after some kind of failure occurred during payment at the Computop or giropay systemsComputopGiropayRedirect-Failure
intershop.payment.COMPUTOP_Giropay.notify_pipelineA pipeline to be called when the notification mechanism is used to communicate with Computop or giropay systemsComputopGiropayRedirect-Notify
intershop.payment.COMPUTOP_DIRECT_DEBIT.currenciesDefines which currencies are configurable for Computop Direct Debit. Default: EURComma-separated list, e.g., EUR

This setting can be overridden within <IS_SHARE>/system/config/cartridges/ac_payment_computop.properties, see Recipe: Change Deployed File Content With Filters.

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).

Note

The Computop Service Connector requires additional post-deployment configuration steps. For details, refer to Configuration.

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 four 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 it will be 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

ExplanationImage

Log in to Organization Management.

1. Navigate to Sales Organizations.

2. Select the name of the organization.

3. Go to the Services tab.

4. Click Payment Services.


5. Select the checkboxes of the new payment methods
you intend to enable for the current sales organization.

6. Click Enable.

Create a Managed Payment Service

ExplanationImage

Log in to Commerce Management.

1. Select the Organization/Channel.

2. Go to Services.

3. Click New.

4. Select the new payment service.

5. Click Next.

6. Enter a Payment Service Name.

7. Enter service ID.

8. Select the checkbox for Active.

9. Select the checkbox for Available.

10. Click Next.

11. Enter all Computop general settings.

12. Enter all logging settings.

13. Enter all monitoring settings.

14. Click Next.

15. Select the Sharing Rule.

(When setting up in the organization area, the service
must necessarily be shared to the channel.)

16. Click Finish.

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

NamePayment ServiceDescription
Merchant IDAllThe merchant account's merchant ID as provided by Computop
Merchant CodeAllThe merchant account's merchant code as provided by Computop
HMAC CodeAllThe merchant account's HMAC code as provided by Computop
Capture

Credit Card,

PayPal Standard

Capture mode (Manual, Auto, Timed). Timed is only available for Credit Card. If you use "Timed", you must set a "Capture Time in Minutes".
Capture Time in MinutesCredit CardWhen using Timed Capture, you may specify a delay in minutes after which the payment is captured.
ZonesCredit CardThis describes the mode to validate clients (permit all, permit selected, forbid selected). If you use "permit selected" or "forbid selected", you must also set "Zone List (ISO 3166 Area Codes)" as a comma-separated list.
IP ZonesCredit CardThis describes the mode to validate client IPs (permit all, permit selected, forbid selected). If you use "permit selected" or "forbid selected", you must also set "IP Zone List (ISO 3166 Area Codes)" as a comma-separated list.
Storefront NameAllThis name is displayed in the storefront.
Order DescriptionAllThis description will be submitted to Computop.
XSLT Template PathCredit CardPath to an XSLT template on the Computop server.
PCNCredit CardStore Pseudo Card Number generated by Computop at customer's profile.

Configure the Payment Methods

Note

Configuring payment methods in a sales channel requires the access privilege Payment Manager for this channel.

ExplanationImage

Enable the payment method for the channel.

Log in to Commerce Management.

1. Select the context selection box.

2. Select the sales channel.

3. Go to Orders.

4. Go to Payment Methods.

5. Click New.

6. Enter Payment Method ID.

7. Select the Configuration Type.

(This was created in the section Create a Managed Payment Service.)

8. Click Apply.

9. Go to the Applications tab.

10. Select the checkboxes of all applications
for which the payment method should be enabled.

11. Click Enable.

12. Go to the Payment Costs tab.

13. Define taxation class, currency, minimum order value, amount
and/or threshold for the payment method if desired, and click Add.

14. Click Apply.

15. Go to the Customer Segments tab.

16. Enable the target customer segments.

17. Click Apply.


18. Go to the Preferences tab.

19. Select the currency-dependent availability and the payment currency.

20. Click Apply.


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:

Feature Overview

Payment Methods

The Computop Service Connector adds the following payment methods to your Intershop 7 system:

NameDescriptionPayment Management Options


Alipay


Payment with Alipay via Computop

Capturing Authorization

Cancel**

Refund


Credit Card


Payment with credit card via Computop

Capture*

Cancel*

Refund

ChinaPay

Payment with ChinaPay via Computop

Capturing Authorization

Direct DebitPayment with Direct Debit via Computop

Authorize

Capture*

Cancel*

Refund

giropayPayment with giropay via Computop

Capturing Authorization

Refund


PayPal Standard


Payment with PayPal via Computop

Capture*

Cancel*

Refund

PayPal ExpressPayment with PayPal Express via Computop

Capture*

Cancel*

Refund

* 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

OperationDescription
CaptureRequest for settling the payment
CancelRequest for abandoning a payment settlement
RefundOption to return (parts of) the captured amount

Data Handling

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



DescriptionComputop Payment Methods


Paypal StandardPaypal ExpressGiropayCredit CardDirect DebitAlipayChinapay
AmountThe amount for the transaction

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

Currency Currency code, e.g. EUR/USD

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

Order NumberOrder reference generated by merchant

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

Order DescOrder description

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

AddressInvoice and shipping address details provided by the user (value is optional and configurable at back office)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

Order IDOrder reference generated by the merchant ICM

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

Customer Info

Buyer-related data

B2C: firstname, lastname and e-mail

B2B: company name and e-mail

(error)

(error)

(error)

(tick)

(error)

(error)

(error)

Credit Card details

Credit card brand, credit card expiry

Sensitive data is handled via PayGate iframes only and is never stored at the merchant.

(error)

(error)

(error)

(tick)

(error)

(error)

(error)

Language (locale code)Language indicator to specify the language that should be presented to the customer

(error)

(error)

(error)

(tick)

(error)

(error)

(error)

IBANInternational bank account number

(error)

(error)

(tick)

(error)

(tick)

(error)

(error)

BICBank identifier code to be used for payment

(error)

(error)

(tick)

(error)

(tick)

(error)

(error)

accOwnerAccount owner

(error)

(error)

(tick)

(error)

(tick)

(error)

(error)

accBankAccount bank

(error)

(error)

(tick)

(error)

(tick)

(error)

(error)

refNrReference number for direct debit transaction

(error)

(error)

(tick)

(error)

(tick)

(error)

(error)

dtOfSgntrDate of signature

(error)

(error)

(tick)

(error)

(tick)

(error)

(error)

 SymbolDescription

(tick)

Transmitted

(error)

Not Transmitted

(question)

Optional - Back Office Configurable

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/5.0.0

  • User Story 64005 - Upgrade Computop Connector to Tomcat-9-based ICM (≥7.10.31)
  • User Story 69769 - Separate responsive content from connector cartridge
Disclaimer
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
Home
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.