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.

 

See also:

• Get acquainted with Payolution
• Configure Invoice Payment for Payolution
• Configure Installment Payment for Payolution
• Set up Payolution Perform Requests
• Check Payolution workflow

 

Last review date: Oct. 7th, 2017