Installing and configuring Computop

Last updated:
Edit on GitHub

This topic describes how to integrate Computop into a Spryker project by installing and configuring the Computop module.

The spryker-eco/computop bundle provides integration of the Computop industry partner with Spryker Commerce OS. It requires the spryker-eco/computopapi bundle that provides the REST Client for making API calls to the Computop Payment Provider.

The SprykerEco.Computop module includes the integrations:

  • Checkout process—payment forms with all the necessary fields that are required to make payment requests, save order information and so on.
  • OMS (Order Management System)—state machines, all necessary commands for making modification requests and conditions for changing order statuses accordingly.

The SprykerEco.Computop module provides the following payment methods:

Installation

Install the Computop module:

composer require spryker-eco/computop

To use PayPal Express, also install the Computop Shipment module:

composer require spryker-eco/computop-shipment

Configuration

You can check all the necessary configurations in vendor/spryker-eco/computop/config/config.dist.php.

The following example shows the Computop module configuration:

config/Shared/config_default.php 
>// Spryker security configuration
$config[KernelConstants::DOMAIN_WHITELIST] = [
	...
    'www.computop-paygate.com', // A trusted Computop domain, required for redirects to third-party services.
];
$config[SessionConstants::YVES_SESSION_COOKIE_SAMESITE] = Cookie::SAMESITE_NONE; // Allows to redirect customers from Computop back to the shop via a `POST` request. (https://developer.computop.com/display/EN/Third-party-cookies+-+Browser+cookies+and+session+handling)

// Credantials
$config[ComputopApiConstants::MERCHANT_ID] = 'Computop merchant identifier';
$config[ComputopApiConstants::BLOWFISH_PASSWORD] = 'Password for blowfish hashing';
$config[ComputopApiConstants::HMAC_PASSWORD] = 'Password for hmac hashing';
$config[ComputopConstants::IDEAL_ISSUER_ID] = 'IDeal issuer identifier';
$config[ComputopConstants::PAYDIREKT_SHOP_KEY] = 'Paydirekt shop key';
$config[ComputopConstants::PAY_PAL_CLIENT_ID] = 'Paypal Client ID';

// Init API call endpoints
$config[ComputopConstants::PAY_NOW_INIT_ACTION] = 'https://www.computop-paygate.com/paynow.aspx';
$config[ComputopConstants::CREDIT_CARD_INIT_ACTION] = 'https://www.computop-paygate.com/payssl.aspx';
$config[ComputopConstants::PAYPAL_INIT_ACTION] = 'https://www.computop-paygate.com/paypal.aspx';
$config[ComputopConstants::DIRECT_DEBIT_INIT_ACTION] = 'https://www.computop-paygate.com/paysdd.aspx';
$config[ComputopConstants::SOFORT_INIT_ACTION] = 'https://www.computop-paygate.com/sofort.aspx';
$config[ComputopConstants::PAYDIREKT_INIT_ACTION] = 'https://www.computop-paygate.com/paydirekt.aspx';
$config[ComputopConstants::IDEAL_INIT_ACTION] = 'https://www.computop-paygate.com/ideal.aspx';
$config[ComputopConstants::EASY_CREDIT_INIT_ACTION] = 'https://www.computop-paygate.com/easyCredit.aspx';
$config[ComputopConstants::PAYU_CEE_SINGLE_INIT_ACTION] = 'https://www.computop-paygate.com/payu.aspx';

// Post order place API calls endpoints
$config[ComputopApiConstants::PAYPAL_EXPRESS_PREPARE_ACTION] = 'https://www.computop-paygate.com/ExternalServices/paypalorders.aspx';
$config[ComputopApiConstants::PAYPAL_EXPRESS_COMPLETE_ACTION] = 'https://www.computop-paygate.com/paypalComplete.aspx';
$config[ComputopApiConstants::EASY_CREDIT_STATUS_ACTION] = 'https://www.computop-paygate.com/easyCreditDirect.aspx';
$config[ComputopApiConstants::EASY_CREDIT_AUTHORIZE_ACTION] = 'https://www.computop-paygate.com/easyCreditDirect.aspx';
$config[ComputopApiConstants::AUTHORIZE_ACTION] = 'https://www.computop-paygate.com/authorize.aspx';
$config[ComputopApiConstants::CAPTURE_ACTION] = 'https://www.computop-paygate.com/capture.aspx';
$config[ComputopApiConstants::REVERSE_ACTION] = 'https://www.computop-paygate.com/reverse.aspx';
$config[ComputopApiConstants::INQUIRE_ACTION] = 'https://www.computop-paygate.com/inquire.aspx';
$config[ComputopApiConstants::REFUND_ACTION] = 'https://www.computop-paygate.com/credit.aspx';

// Payment method specific configuration
$config[ComputopApiConstants::RESPONSE_MAC_REQUIRED] = [
    ComputopConfig::INIT_METHOD,
];
$config[ComputopConstants::CREDIT_CARD_TEMPLATE_ENABLED] = false;
$config[ComputopConstants::CREDIT_CARD_TX_TYPE] = '';
$config[ComputopConstants::PAY_NOW_TX_TYPE] = '';
$config[ComputopConstants::PAY_PAL_TX_TYPE] = ComputopConfig::TX_TYPE_AUTH;
$config[ComputopConstants::PAY_PAL_EXPRESS_PAYPAL_METHOD] = '';
$config[ComputopConstants::PAYMENT_METHODS_WITHOUT_ORDER_CALL] = [
    ComputopConfig::PAYMENT_METHOD_SOFORT,
    ComputopConfig::PAYMENT_METHOD_PAYDIREKT,
    ComputopConfig::PAYMENT_METHOD_IDEAL,
    ComputopConfig::PAYMENT_METHOD_CREDIT_CARD,
    ComputopConfig::PAYMENT_METHOD_PAY_NOW,
    ComputopConfig::PAYMENT_METHOD_PAY_PAL,
    ComputopConfig::PAYMENT_METHOD_PAY_PAL_EXPRESS,
    ComputopConfig::PAYMENT_METHOD_DIRECT_DEBIT,
    ComputopConfig::PAYMENT_METHOD_EASY_CREDIT,
    ComputopConfig::PAYMENT_METHOD_PAYU_CEE_SINGLE,
];
$config[ComputopApiConstants::PAYMENT_METHODS_CAPTURE_TYPES] = [
    ComputopApiConfig::PAYMENT_METHOD_PAYDIREKT => ComputopApiConfig::CAPTURE_TYPE_MANUAL,
    ComputopApiConfig::PAYMENT_METHOD_CREDIT_CARD => ComputopApiConfig::CAPTURE_TYPE_MANUAL,
    ComputopApiConfig::PAYMENT_METHOD_PAY_NOW => ComputopApiConfig::CAPTURE_TYPE_MANUAL,
    ComputopApiConfig::PAYMENT_METHOD_PAY_PAL => ComputopApiConfig::CAPTURE_TYPE_MANUAL,
    ComputopApiConfig::PAYMENT_METHOD_PAY_PAL_EXPRESS => ComputopApiConfig::CAPTURE_TYPE_MANUAL,
    ComputopApiConfig::PAYMENT_METHOD_DIRECT_DEBIT => ComputopApiConfig::CAPTURE_TYPE_MANUAL,
    ComputopApiConfig::PAYMENT_METHOD_PAYU_CEE_SINGLE => ComputopApiConfig::CAPTURE_TYPE_MANUAL,
];

// CRIF (formerly Deltavista) configuration
$config[ComputopConstants::CRIF_ENABLED] = true;
$config[ComputopApiConstants::CRIF_ACTION] = 'https://www.computop-paygate.com/deltavista.aspx';
$config[ComputopApiConstants::CRIF_PRODUCT_NAME] = ComputopConfig::CRIF_PRODUCT_NAME_QUICK_CHECK_CONSUMER;
$config[ComputopApiConstants::CRIF_LEGAL_FORM] = ComputopConfig::CRIF_LEGAL_FORM_PERSON;
$config[ComputopConstants::CRIF_GREEN_AVAILABLE_PAYMENT_METHODS] = [
    ComputopConfig::PAYMENT_METHOD_SOFORT,
    ComputopConfig::PAYMENT_METHOD_PAYDIREKT,
    ComputopConfig::PAYMENT_METHOD_IDEAL,
    ComputopConfig::PAYMENT_METHOD_CREDIT_CARD,
    ComputopConfig::PAYMENT_METHOD_PAY_NOW,
    ComputopConfig::PAYMENT_METHOD_PAY_PAL,
    ComputopConfig::PAYMENT_METHOD_PAY_PAL_EXPRESS,
    ComputopConfig::PAYMENT_METHOD_DIRECT_DEBIT,
    ComputopConfig::PAYMENT_METHOD_EASY_CREDIT,
    ComputopConfig::PAYMENT_METHOD_PAYU_CEE_SINGLE,
];
$config[ComputopConstants::CRIF_YELLOW_AVAILABLE_PAYMENT_METHODS] = [
    ComputopConfig::PAYMENT_METHOD_CREDIT_CARD,
    ComputopConfig::PAYMENT_METHOD_PAY_NOW,
    ComputopConfig::PAYMENT_METHOD_PAY_PAL,
    ComputopConfig::PAYMENT_METHOD_PAY_PAL_EXPRESS,
];
$config[ComputopConstants::CRIF_RED_AVAILABLE_PAYMENT_METHODS] = [
    ComputopConfig::PAYMENT_METHOD_CREDIT_CARD,
    ComputopConfig::PAYMENT_METHOD_EASY_CREDIT,
];
$config[ComputopShipmentConstants::PAYPAL_EXPRESS_DEFAULT_SHIPMENT_METHOD_KEY] = 'spryker_dummy_shipment-standard';
CONFIGURATION KEY TYPE DESCRIPTION
$config[ComputopApiConstants::MERCHANT_ID] string Computop merchant identifier.
$config[ComputopApiConstants::BLOWFISH_PASSWORD] string Password for Blowfish hashing.
$config[ComputopApiConstants::HMAC_PASSWORD] string Password for HMAC hashing.
$config[ComputopConstants::PAYDIREKT_SHOP_KEY] string Shop key for the Paydirect payment method.
$config[ComputopConstants::IDEAL_ISSUER_ID] string Issuer ID for the Ideal payment method.
$config[ComputopConstants::PAY_PAL_CLIENT_ID] string PayPal Client ID for the PayPal Express payment method.
$config[ComputopConstants::PAY_NOW_INIT_ACTION] string init API call endpoint for the PayNow payment method.
$config[ComputopConstants::CREDIT_CARD_INIT_ACTION] string init API call endpoint for the Credit Card payment method.
$config[ComputopConstants::PAYPAL_INIT_ACTION] string init API call endpoint for the PayPal payment method.
$config[ComputopConstants::DIRECT_DEBIT_INIT_ACTION] string init API call endpoint for the Direct Debit payment method.
$config[ComputopConstants::SOFORT_INIT_ACTION] string init API call endpoint for the Sofort payment method.
$config[ComputopConstants::PAYDIREKT_INIT_ACTION] string init API call endpoint for the Paydirect payment method.
$config[ComputopConstants::IDEAL_INIT_ACTION] string init API call endpoint for the Ideal payment method.
$config[ComputopConstants::EASY_CREDIT_INIT_ACTION] string init API call endpoint for the Easy Credit payment method.
$config[ComputopConstants::PAYU_CEE_SINGLE_INIT_ACTION] string init API call endpoint for the PayU CEE Single payment method.
$config[ComputopApiConstants::PAYPAL_EXPRESS_PREPARE_ACTION] string prepare API call endpoint for the PayPal Express payment method.
$config[ComputopApiConstants::PAYPAL_EXPRESS_COMPLETE_ACTION] string complete API call endpoint for the PayPal Express payment method.
$config[ComputopApiConstants::EASY_CREDIT_STATUS_ACTION] string status API call endpoint for the Easy Credit payment method.
$config[ComputopApiConstants::EASY_CREDIT_AUTHORIZE_ACTION] string authorize API call endpoint for the Easy Credit payment method.
$config[ComputopApiConstants::AUTHORIZE_ACTION] string authorize API call endpoint.
$config[ComputopApiConstants::CAPTURE_ACTION] string capture API call endpoint.
$config[ComputopApiConstants::REVERSE_ACTION] string reserve API call endpoint.
$config[ComputopApiConstants::INQUIRE_ACTION] string inquire API call endpoint.
$config[ComputopApiConstants::REFUND_ACTION] string refund API call endpoint.
$config[ComputopApiConstants::RESPONSE_MAC_REQUIRED] array MAC is checked by methods on response.
$config[ComputopConstants::CREDIT_CARD_TEMPLATE_ENABLED] bool Defines if a custom template is enabled for the Credit Card payment method.
$config[ComputopConstants::CREDIT_CARD_TX_TYPE] string TX TYPE for the Credit Card payment method (empty string).
$config[ComputopConstants::PAY_NOW_TX_TYPE] string TX TYPE for the PayNow payment method (empty string).
$config[ComputopConstants::PAY_PAL_TX_TYPE] string TX TYPE for the PayPal payment method (Auth).
$config[ComputopConstants::PAY_PAL_EXPRESS_PAYPAL_METHOD] string Using method for the PayPal Express payment method.
$config[ComputopConstants::PAYMENT_METHODS_WITHOUT_ORDER_CALL] array Payment methods without the order call.
$config[ComputopApiConstants::PAYMENT_METHODS_CAPTURE_TYPES] array Mapping payment methods and their capture types: MANUAL or AUTO.
$config[ComputopConstants::CRIF_ENABLED] bool Defines if CRIF risk check is enabled.
$config[ComputopApiConstants::CRIF_ACTION] string CRIF API call endpoint.
$config[ComputopApiConstants::CRIF_PRODUCT_NAME] string QuickCheckConsumer or
CreditCheckConsumer or
QuickCheckBusiness or
CreditCheckBusiness or
IdentCheckConsume.
$config[ComputopApiConstants::CRIF_LEGAL_FORM] string PERSON, COMPANY, or UNKNOWN.
$config[ComputopConstants::CRIF_GREEN_AVAILABLE_PAYMENT_METHODS] array Payment methods available with a green response code.
$config[ComputopConstants::CRIF_YELLOW_AVAILABLE_PAYMENT_METHODS] array Payment methods available with a yellow response code.
$config[ComputopConstants::CRIF_RED_AVAILABLE_PAYMENT_METHODS] array Payment methods available with a red response code.