Navigation

Payolution — Configuration

Add spryker-eco/payolution to your project by running composer require spryker-eco/payolution

Please refer to config/config.dist.php for example of module configuration.

To setup the initial Payolution configuration, use the credentials you received after registering your Payolution merchant account:


$config[PayolutionConstants::TRANSACTION_GATEWAY_URL] = '';
$config[PayolutionConstants::CALCULATION_GATEWAY_URL] = '';
$config[PayolutionConstants::TRANSACTION_SECURITY_SENDER] = '';
$config[PayolutionConstants::TRANSACTION_USER_LOGIN] = '';
$config[PayolutionConstants::TRANSACTION_USER_PASSWORD] = '';
$config[PayolutionConstants::CALCULATION_SENDER] = '';
$config[PayolutionConstants::CALCULATION_USER_LOGIN] = '';
$config[PayolutionConstants::CALCULATION_USER_PASSWORD] = '';
$config[PayolutionConstants::TRANSACTION_CHANNEL_PRE_CHECK] = '';
$config[PayolutionConstants::TRANSACTION_CHANNEL_INVOICE] = '';
$config[PayolutionConstants::TRANSACTION_CHANNEL_INSTALLMENT] = '';
$config[PayolutionConstants::CALCULATION_CHANNEL] = '';

Next, specify modes and order limits:


$config[PayolutionConstants::TRANSACTION_MODE] = 'CONNECTOR_TEST';
$config[PayolutionConstants::CALCULATION_MODE] = 'TEST';
$config[PayolutionConstants::MIN_ORDER_GRAND_TOTAL_INVOICE] = '500';
$config[PayolutionConstants::MAX_ORDER_GRAND_TOTAL_INVOICE] = '500000';
$config[PayolutionConstants::MIN_ORDER_GRAND_TOTAL_INSTALLMENT] = '500';
$config[PayolutionConstants::MAX_ORDER_GRAND_TOTAL_INSTALLMENT] = '500000';
        

Checkout Configuration

To use Payolution in frontend, Payolution payment method handlers and subforms should be added to Pyz/Yves/Checkout/CheckoutDependencyProvider.php


        $container[static::PAYMENT_METHOD_HANDLER] = function () {
            $paymentHandlerPlugins = new StepHandlerPluginCollection();

            $paymentHandlerPlugins->add(new PayolutionHandlerPlugin(), PaymentTransfer::PAYOLUTION_INVOICE);
            $paymentHandlerPlugins->add(new PayolutionHandlerPlugin(), PaymentTransfer::PAYOLUTION_INSTALLMENT);

            return $paymentHandlerPlugins;
        };

        $container[static::PAYMENT_SUB_FORMS] = function () {
            $paymentSubFormPlugins = new SubFormPluginCollection();

            $paymentSubFormPlugins->add(new PayolutionInstallmentSubFormPlugin());
            $paymentSubFormPlugins->add(new PayolutionInvoiceSubFormPlugin());

            return $paymentSubFormPlugins;
        };
        

All subform and handler plugins are located in SprykerEco\Yves\Payolution\Plugin\ namespace.

OMS Configuration

Please activate the following Payolution process.


$config[OmsConstants::ACTIVE_PROCESSES][] = 'PayolutionPayment01';
        

Default implementation for commands and options should be added to Pyz/Zed/Oms/OmsDependencyProvider.php

  1. Commands:
    
    $container->extend(OmsDependencyProvider::COMMAND_PLUGINS, function (CommandCollectionInterface $commandCollection) {
        $commandCollection
            ->add(new PreAuthorizePlugin(), 'Payolution/PreAuthorize')
            ->add(new ReAuthorizePlugin(), 'Payolution/ReAuthorize')
            ->add(new RevertPlugin(), 'Payolution/Revert')
            ->add(new CapturePlugin(), 'Payolution/Capture')
            ->add(new RefundPlugin(), 'Payolution/Refund');
    
        return $commandCollection;
    });
                    
  2. Conditions:
    
    $container->extend(OmsDependencyProvider::CONDITION_PLUGINS, function (ConditionCollectionInterface $conditionCollection) {
        $conditionCollection
            ->add(new IsPreAuthorizationApprovedPlugin(), 'Payolution/IsPreAuthorizationApproved')
            ->add(new IsReAuthorizationApprovedPlugin(), 'Payolution/IsReAuthorizationApproved')
            ->add(new IsReversalApprovedPlugin(), 'Payolution/IsReversalApproved')
            ->add(new IsCaptureApprovedPlugin(), 'Payolution/IsCaptureApproved')
            ->add(new IsRefundApprovedPlugin(), 'Payolution/IsRefundApproved');
    
        return $conditionCollection;
    });
                    

All commands and conditions are located in SprykerEco\Zed\Payolution\Communication\Plugin\Oms\ namespace.

Payment Configuration

Default implementation for checkout payment plugins should be added to Pyz/Zed/Payment/PaymentDependencyProvider.php


        $container->extend(static::CHECKOUT_PLUGINS, function (CheckoutPluginCollection $pluginCollection) {
            $pluginCollection
                ->add(new PayolutionPreCheckPlugin(), PayolutionConfig::PROVIDER_NAME, static::CHECKOUT_PRE_CHECK_PLUGINS)
                ->add(new PayolutionSaveOrderPlugin(), PayolutionConfig::PROVIDER_NAME, static::CHECKOUT_ORDER_SAVER_PLUGINS)
                ->add(new PayolutionPostCheckPlugin(), PayolutionConfig::PROVIDER_NAME, static::CHECKOUT_POST_SAVE_PLUGINS);

            return $pluginCollection;
        });
            

All payment plugins are located in SprykerEco\Zed\Payolution\Communication\Plugin\Checkout\ namespace.

 

Last review date: Oct. 7th, 2017